是时候将 WADL 加入到 JAX-RS 中了吗?

  • Mark Little
  • 张卫滨

2012 年 10 月 23 日

话题:REST语言 & 开发架构

在今年的 JavaOne 上,有一个名为'JavaEE.Next(): Java EE 7, 8, and Beyond' 的专题,包括 Oracle、IBM、Red Hat 以及 Caucho 所组成的小组讨论了 Java EE 的各个方面,并回答了观众的问题。最初预想的焦点会是 Paas、移动开发以及 NoSQL,但是与会者对 REST 尤其是WADL也表现出了极大的兴趣。现在,WADL 并不是新鲜事物,它已经存在并被广泛讨论了至少七年的时间,我们在 2005 年曾经这样报道过:

对于那些想在 HTTP 服务上描述 XML 的人来说,已经讨论过很多可选的方案了,从 SMEX-D (Tim Bray 所提出的)到 NSDL,以及其他众多的可选方案。但是,大多数提议都是在 2005 年甚至更早的时候创建的,从那以后它们都没有较大的改进。

Marc Hadley(JSR-311规范的负责人之一,这个规范是 RESTful 服务的一种 Java API)在 2005 年 提出了  WADL——Web 应用描述语言。

从那以后,很多人构建工具来支持 WADL。Yahoo 的架构师  Mark Nottingham维护了能够从 WADL 生成文档的一个样式表。

就像围绕 REST 的某些事情一样,在过去,WADL 将社区分裂成相信WADL 必要和非必要的两派。例如,在 2007 年 Mark Baker 曾经这样说:

[...] 所有服务暴露相同的接口。这就提供了大多数的松耦合,这也是与 RPC 的主要区别。 

所以如果你正在编写(或生成)协议 / 接口级别的代码,而这些代码不能延迟绑定到所有地方的所有资源上,这样做其实不是 REST(对指出这违反了特定约束的人,应该给予莫大的荣光)。

我们已经挣脱了约束!RPC 已死!你不能再为所欲为了!

而喜欢它的人通常将其与 WSDL进行比较

回忆一下 WSDL,它能够很简单地生成到 web 服务的交互代码。这一点很棒,可以节省大量的工作。在 RESTful web 服务中,我们同样可以这么做吗?是的,可以的。最终,我的结论就是,你可以借助WADL做到这一点。WADL 代表了 Web 应用描述语言,它能够为任意的 web 服务(包括 SOAP web 服务,这可能让你感觉意外)描述基于 HTTP 的 API。但是你还可以用 WADL 描述 flickr API、twitter API 以及 yahoo API。猜一下它能做什么… 它能够生成客户端代理代码来与这些 API 交互。是的,它与 WSDL 很类似,但是更通用。它能够统一支持 REST 和其他任意(我猜)类型基于 XML 的 web 服务。

但正如一位评论者所言,它可能是双刃剑:

在这篇文章中犯了几个根本性的错误。你说"我在这里所叙述的是,结果的格式和发送给 REST web 服务的数据都是精确定义的 XML。那么,当我要求媒体类型的时候会怎样?他们也是精确定义的数据格式,它们与怎样处理数据以及如何基于表述获取新的资源相关。

读一读 Roy Fielding 的作品吧 ; )

顺便说一句,WADL 可能并不会长久,它实际上一点都不 RESTful(在客户端和服务提供者之间建立了紧耦合)。

在 2005 到 2008 的几年间,类似这样的争论在 REST 领域泛滥。最近,争论似乎逐渐平息,出现了更务实的前景。有些组织觉得,尽管 WADL 还有一些问题(如它是否 RESTful),但对于开发者而言,它应该是一个要支持的方案。而另外一些组织则完全避开了它。例如 JAX-RS 的参考实现 Jersey 就内置支持了 WADL。而另一些 JAX-RS 实现,如RESTeasy就没有这样明确支持

让我们回到 JavaOne 这个专题上来,很多观众包括 JAX-RS 规范的负责人,都很想知道未来版本的 JAX-RS 是否要完全支持 WADL。然而讨论小组未置可否,并提及很多成功的 RESTful 服务并没有使用 WADL,但是很多观众倾向于支持将 WADL 加入到 JAX-RS 中。鉴于最近几年 WADL 的影响力处于低潮期,这会不会是 Java 和 JAX-RS 的特殊需求,WADL 会不会再次得到关注呢?如果是这样的话,WADL 会不会使得现在开发的 RESTful 服务和应用程序比几年前的更好呢?会不会使得今天的开发人员比以前更务实呢?

查看英文原文:Is It Time For WADL in JAX-RS?
REST语言 & 开发架构