JSR 311 最终草案：RESTful Web 服务 Java API

去年 2 月， Sun 宣布了 JSR 311 ：RESTful Web 服务的 Java API。9 月 23 日，规范的 1.0 草案通过了JCP 执行委员会的赞成投票，这基本意味着它现在已经定稿。

JAX-RS 是 Java 中用于实现以 HTTP 为基础的 RESTful Web 服务的 基于注解的 API。本质上，注解类和方法的信息能让运行时（Runtime）将它们暴露为资源，这种方法和通过 Servlet 编程模型来暴露类与方法的做 法有很大区别。实现 JAX-RS 的运行时（Runtime）周旋于 HTTP 协议和 Java 类之间，考虑 URI、被请求和被接受的内容类型和 HTTP 方法。 除了 Sun 提供的参考实现 Jersey 之外，可用的其他实现（尚在不同的完成阶段）包括：流行的 Restlet 框架的一部分， JBoss RESTeasy 项目和 Apache CXF Web 服务栈的一部分。

InfoQ 采访了规范带头人，Sun 的 Marc Hadley 和 Paul Sandoz ，请他们畅谈了他们对 JAX-RS 和整个过程的想法。

被问到他们对这个结果的心情时，Mark 表示他对 API 最终完成非常满意。他还表示，非常幸运的是，在专家组从事 API 设计时就有如此多的实现被构 建出来，并且这有助于抚平 API 中的任何不足。Paul 补充说，不少开发者自愿在 API 的各个版本上工作，采用测试驱动的方式去实现，并提供反馈。

在问及最具挑战性的方面时，Marc 指出，一开始很难在 API 的风格和范围上达成统一：

为了启动这个 JSR，我们以一个涉及面很广的提案开了个头。但是，回想起来，我认为我们可能从一个更具体的方面开始构建更好。
在过去的几个月内，我们已经看到了大量对这个 JSR 的关注，主要挑战是既保证进度又能适应所有新请求。

Paul 大胆地对 JSR 中“J”的某些方面表示了质疑：

可能这显得有点儿异端，但是有时我发现当前的 Java 语法本身有点挑战性。但是，通过 Java 注解、范型和构造器 （Builder）模式，我认为我们把事情降到了一个非常简洁的水平。而且，方便地使用 Scala 和 Groovy 来书写这种 JAX-RS 应用也是有可能 的，这两种语言都支持与 Java 字节码兼容的注解。

在启动这个 JSR 的时候， REST 社区对它能否符合 REST 的关键原则表示怀疑。Mark 认为这一目标已经达到：

我认为 API 是鼓励资源中立的观点的，它让开发者自己决定他们资源的标识符和他们支持的方法。对内容协商的说明性支持非常好，缺 省的资源生命周期鼓励无状态的方式。如果我必须指出一个弱点的话，那就是它对“超媒体即状态引擎（hypermedia as the engine of state）”支持有限。虽然我们能很好地支持从请求 URI 中抽取信息和构造资源 URI，在表述（representations）中正确使用超媒体这一任务较多的还是留给了开发者自己去完成。

Paul 表示同意：

是的，这可能是最困难的地方了。JAX-RS 提供了大量构造 URI 的方法，但是建模 API 中还没有类似 JAXB 这样的 URI 绑定工具。我认为在这一方面，我们有一些办法可以探索，如 Henry Story 的 RDF 序列化。

问及 JSR 311 上的工作是否改变了他对 Web 和 Web 服务的观点时，Mark 表示这印证了他的一个观点，即一个人“无需依赖更复杂的东西就可以用 HTTP 完成一件非常伟大的事”。Paul 指出，REST 发明者 Roy Fielding 的将稀疏位数组（sparse bit array）用于通知便是 REST 可在将来带来惊喜的一个例子。

我们还向 Mark 询问了他期望 JSR 311 如何对即将到来的 Servlet 规范修订产生影响：

JAX-RS 应用可以被 Servlet 容器托管，因此两者默契合作非常重要。JAX-RS 是新的 Servlet 可插性 （pluggability）框架的一个潜在消费者，因此我们正在着手就此提出我们的要求。一个难处理的地方是，JAX-RS 提供了较 Servlet 更灵 活的 URI 到资源的映射方式，这对联合使用说明性的 Servlet 安全和 JAX-RS 来说是个挑战，因此我们也在从事这方面的工作。

最后，Mark 证实 Jersey 不“只是”一个参考实现，而且完全可作为产品使用，并且已经有实际的部署了。他还指出，Jersey 将是 Glassfish JSR 311 实现，而这正是 Jersey 需要达到产品质量的原因。Paul 强调了另一原因：

定期发布规范和实现的试验版本（early access）一个好处就是，这让 APT 和实现都能及早和频繁地接受测试的考验:-)

你可以联机阅读这个规范； Jersey 参考实现可从 java.net 获得，并在 Java 5 或更高版本上运行。

查看英文原来： JSR 311 Final: Java API for RESTful Web Services