RESTful服务描述

Question

据我了解，我需要使用WADL来描述RESTful Web服务。不过，我在相关帖子中已经阅读了很多答案，其中用户强烈反对使用WADL。

WADL有哪些缺点？有没有替代方案？

Answer 1

HTTP规范告诉您如何检索和更新资源。资源由URI标识并且应该链接在一起，因此所有数据都应该可以从服务根URL中找到，就像网站上的页面一样。剩下的就是记录您通过网络传输的媒体类型。

如果采用这种方法并且您在服务中重复使用媒体类型，那么您只需要记录一次媒体类型，它将适用于所有服务。

一旦你完成了这些步骤，WADL就没有什么可以记录的了。

如果你想做REST，你不能使用WADL代码生成客户端，因为这会在客户端和服务器之间产生紧密耦合。如果你没关系，那很好，但只是意识到你没有做REST，因此不会意识到REST的一些好处。