Java RESTful Web Service实战（第2版）
上QQ阅读APP看书，第一时间看更新
上一章目录下一章

1.7 Java领域的其他REST实现

Java领域存在很多REST实现，我们以是否遵循JAX-RS标准，将它们分为两组。前者是JAX-RS标准参考实现之外的厂商实现，后者要么是因为出现较JAX-RS标准早，要么干脆跳出了JAX-RS标准的定义，以自身框架一致性为目标，实现了一套独有的对REST开发的支持。本节将概括性地介绍这些实现工具，以便读者有所对比和选择。

1.7.1 JAX-RS的其他实现

JAX-RS标准发布后，诸多厂商推出了自己的基于JAX-RS标准的实现。其中最有影响力的当属来自JBoss社区的RESTEasy和来自Apache社区的CXF。本节将简述这两个项目。如果读者的项目确实和它们结合得紧密，Jersey未必是最佳选择，读者尽可拥抱这两个基于JAX-RS标准的项目。

1．JBoss的RESTEasy

RESTEasy是JBoss社区提供的JAX-RS项目。JBoss这一名词目前已经不再代表Java EE容器，曾经的JBoss已经更名为WildFly。现在，JBoss特指RedHat公司旗下的开源社区。RESTEasy自2009年1月第一个GA版本以来，发展到3.0.x，从版本3.0.0.Final开始支持JAX-RS2.0。RESTEasy的基本信息如下。

❏官方网站：http://resteasy.jboss.org。

❏官方文档：提供单页面HTML、按章节HTML和PDF 3种格式，可以按照阅读习惯选择。地址为http://resteasy.jboss.org/docs.html。

❏源代码：由GitHub托管，地址为https://github.com/resteasy/Resteasy。

❏缺陷管理：地址为https://issues.jboss.org/projects/RESTEASY，隶属于JBoss开发者社区的JIRA系统。

❏项目下载：由sourceforge托管，地址为http://sourceforge.net/projects/resteasy/files/Resteasy%20JAX-RS。维护的最后一个版本是3.0.9.Final，日期为2014-09-17，而目前RESTEasy的最新版本为3.0.13.Final。

（1）快速开始

最快速地了解一个新框架的办法，一定是从官方提供的示例开始。我们首先迁出RESTEasy的源代码，然后进入示例目录，选择最易上手的示例项目。这里以resteasy springMVC为例，示例操作如下。

    git clone https://github.com/resteasy/Resteasy.git
    cd Resteasy/jaxrs/examples/resteasy-springMVC
    mvn clean install
    mvn jetty:run

上述操作分别执行了代码迁出、进入示例目录、构建示例项目和启动示例服务。当服务启动完毕后，我们可以在浏览器的地址栏输入http://localhost:8080/contacts，在页面中输入测试数据并提交表单，这里提交的是Eric和Han。测试数据会被保存在REST服务的内存中，可以通过如下GET请求获取服务端保存的数据，示例结果如下。

    curl http://localhost:8080/contacts/data/Han
    <? xml version="1.0" encoding="UTF-8" standalone="yes"? >
    <contact>
      <firstName>Eric</firstName>
      <lastName>Han</lastName>
    </contact>

从上面的测试结果中，我们得到了lastName为Han, XML格式的contact资源数据。

（2）简单分析

这个示例项目是非常典型的JAX-RS实践。观察如下所示的目录树，源代码路径中包含了4个类，其中Contact和Contacts是实体类，ContactService是服务类，ContactsResource是REST服务的资源类，负责定义REST接口。单元测试类ContactsTest是对ContactsResource功能的全面测试。

示例项目所依赖的包简述如下。

❏org.jboss.resteasy

• resteasy-spring：支持RESTEasy与Spring集成，底层依赖resteasy-jaxrs。resteasyjaxrs是RESTEasy的JAX-RS核心包。

• resteasy-client:RESTEasy客户端包。

• resteasy-jaxb-provider:RESTEasy的XML处理包。

❏org.jboss.spec.javax.servlet

• jboss-servlet-api_3.1_spec:RESTEasy的JBoss Servlet实现。

❏org.springframework

• spring-webmvc:Spring MVC包。

2．Apache的CXF

CXF是Apache开源社区提供的JAX-RS项目，CXF的名称是由Celtix项目和XFire项目合并而来。其中Celtix由IONA Technologies开发，XFire来自Codehaus。CXF是JAXWS的著名实现，同时实现了JAX-RS，从版本2.7.0开始几乎全面支持JAX-RS2.0全部特性。从版本3.0.0开始实现JAX-RS2客户端API。CXF的基本信息如下。

❏官方网站：http://cxf.apache.org。

❏官方文档：http://cxf.apache.org/docs/jax-rs.html。

❏项目下载：Apache CXF当前版本是3.1.3。下载地址为http://cxf.apache.org/download.html。

❏源代码：由Apache的GIT服务器托管，地址为https://git-wip-us.apache.org/repos/asf?p=cxf.git；另有一个自动镜像由GitHub托管，地址为https://github.com/apache/cxf。

❏邮件列表：http://cxf.apache.org/mailing-lists.html。

（1）快速开始

我们依然从官方提供的示例开始。首先迁出CXF的源代码，然后进入示例目录，这里选择的示例项目为jaxrs_spring_boot，示例操作如下。

    git clone https://git-wip-us.apache.org/repos/asf/cxf.git
    git clone https://github.com/apache/cxf.git
    cd cxf/distribution/src/main/release/samples/jax_rs/jaxrs_spring_boot
    mvn spring-boot:run

可以从上述的前2行中选择一个地址，将CXF源代码迁出。进入jaxrs_spring_boot目录，然后执行maven命令，启动基于spring-boot的REST服务。服务启动后，我们在另一个终端中使用cURL测试，将得到如下的输出。

    curl ":8080/services/helloservice/sayHello/ApacheCxfUser"
    Hello ApacheCxfUser, Welcome to CXF RS Spring Boot World! ! !

（2）简单分析

该示例项目也是典型的JAX-RS实践。观察如下所示的目录树，HelloService是资源类，SampleRestWSApplication是服务器端包含main方法的入口类，SampleRestClientApplication是客户端包含main方法的入口类。

示例项目所依赖的包简述如下。

❏spring-boot:Spring-boot启动包

• org.springframework.boot:spring-boot-starter

• org.springframework.boot:spring-boot-starter-web

❏cxf:CXF包

• org.apache.cxf:cxf-rt-frontend-jaxrs

• org.apache.cxf:cxf-rt-rs-client

• org.apache.cxf:cxf-rt-transports-http

• org.apache.cxf:cxf-rt-rs-service-description

❏jackson:JSON处理包

• com.fasterxml.jackson.core:jackson-core

• com.fasterxml.jackson.core:jackson-databind

• com.fasterxml.jackson.jaxrs:jackson-jaxrs-json-provider

• com.fasterxml.jackson.core:jackson-annotations

❏jetty:Servlet容器Jetty包

• org.eclipse.jetty:jetty-servlet

• org.eclipse.jetty:jetty-webapp

• org.eclipse.jetty:jetty-servlets

1.7.2 其他的REST实现

本节将介绍Java领域，没有遵循JAX-RS规范的REST式Web服务开发工具，包括Restlet、LinkedIn的Rest.li以及Spring MVC。

1．Restlet项目

Restlet是一款遵从REST风格的、基于Java平台的轻量级框架，当前版本为2.3。Restlet许可为免费开源，提供REST开发的完整支持。Restlet的基本信息如下。

❏官方网站：http://restlet.org。

❏源代码：由GitHub托管，地址为https://github.com/restlet/restlet-framework-java。

❏StackOverflow:http://stackoverflow.com/questions/tagged/restlet。

❏学习指南文档：http://restlet.org/learn/tutorial。

（1）快速开始

为了快速了解Restlet的使用，我们从一个现成的Restlet示例项目开始学习，示例如下。

    wget  http://restlet.com/technical-resources/restlet-framework/archives/
    examples/maven-spring/2.3/restlet-basecamp.zip
    unzip restlet-basecamp.zip
    cd restlet-basecamp
    mvn jetty:run-war

上述操作分别执行了下载示例包、解压缩、进入示例项目目录以及启动服务。服务启动后，我们使用cURL测试，将得到如下的输出。

    curl ":8080/basecamp/hello"
    Hello World!

（2）简单分析

Restlet使用配置文件声明服务，我们观察如下所示的目录树，applicationContext.xml是配置文件，BaseCampApplication是REST服务入口类，BaseCampResource是资源类。

配置文件applicationContext.xml展示如下，首先需要定义一个Spring组件basecampComponent，它的defaultTarget属性指向BaseCampApplication的实例basecampAppliction。basecampAppliction的根路径路由指向SpringBeanRouter的实例。最后，/hello路径指向BaseCampResource的实例。

    <bean id="basecampComponent" class="org.restlet.ext.spring.SpringComponent">
      <property name="defaultTarget" ref="basecampAppliction" />
    </bean>
    <bean id="basecampAppliction" class="com.mycompany.restlet.basecamp.application.
    BaseCampApplication">
      <property name="root" ref="router" />
    </bean>
    <! --   Define the router -->
    <bean name="router" class="org.restlet.ext.spring.SpringBeanRouter" />
    <! -- Define all the routes -->
    <bean  name="/hello"  class="com.mycompany.restlet.basecamp.resource.demo.
    BaseCampResource" scope="prototype" autowire="byName" />

示例项目所依赖的包简述如下。

❏org.restlet.jee:org.restlet:jar:2.0.1

❏org.restlet.jee:org.restlet.ext.servlet:jar:2.0.1

❏org.restlet.jee:org.restlet.ext.spring:jar:2.0.1

• org.springframework:spring-webmvc:jar:3.0.1.RELEASE。

其中，jee代表支持Java EE平台的包。此外，Restlet支持的平台体系如下。

❏jse (Java SE edition)

❏jee (Java EE edition)

❏gae (Google App Engine edition)

❏android (Android edition)

❏gwt (Google Web Toolkit edition)

❏osgi (OSGi Environments edition)

2．LinkedIn的Rest.li

Rest.li是社交网站LinkedIn开发的REST+JSONREST式服务框架。rest.li基本信息如下。

❏官方地址：rest.li（http://rest.li）。

❏源代码：由GitHub托管，地址为https://github.com/linkedin/rest.li。

❏wiki:https://github.com/linkedin/rest.li/wiki。

• 快速开始教学文档：https://github.com/linkedin/rest.li/wiki/Quickstart:-A-TutorialIntroduction-to-Rest.li。

快速开始

Rest.li的项目是使用Gradle构建的，完整的代码迁出和构建示例如下。

    git clone https://github.com/linkedin/rest.li.git
    cd rest.li/examples/spring-server
    gradle build
    gradle JettyRunWar
    curl -v http://localhost:8080/fortunes/1

3．Spring MVC项目

Spring框架使用Gradle构建和管理项目，使用GIT管理源代码，地址为https://github.com/spring-projects/spring-framework，其中MVC模块位于spring-framework/spring-webmvc目录下。

Spring从版本3.0开始提供了对REST式应用开发的支持，但Spring目前并没有也没必要推出一个实现JAX-RS标准的模块。MVC模块提供的REST功能并没有采用JAX-RS提出的标准。本质上，Spring MVC控制流程是使用Controller处理Model在某种动词性的业务逻辑操作，而JAX-RS的控制流程是使用资源类Resource处理名词性的资源表述。

在云概念和微服务大行其道的今天，Spring Boot成为依赖spring-framework项目的事实标准。本书的第7章将讲述Spring Boot在REST服务领域中的影响力及实践。

上一章目录下一章