使用JSR311(JAX-RS)规范快速的构建REST应用TonyDenghttp://friendfeed.com/tonydenghttp://twitter.com/wolfdenghttp://delicious.com/wolf.denghttp://wolfchina.blogbus.com

分享内容JSR311(JAX-RS)规范介绍常用的JAX-RSAPI介绍JAX-RS框架介绍ROA（面向资源架构）如何使用JAX-RS框架快速的构建REST应用代码演示

JSR311（JAX-RS）项目介绍JSR311 正式称呼 JAX-RS:Java API for RESTful Web ServicesJSR311是Sun在2007年2月发布的一个基于annotation的APIJSR311项目地址https://jsr311.dev.java.net/版本：jsr311-1.0（稳定版）已经通过了JCP的投票同意jsr311-1.1（草稿版）

JAX-RS的特性提供annotation的API规范提出WADL（Web Application Description Language）规范来描述REST应用https://wadl.dev.java.netJSR-311 提供一组注释，相关类和接口都可以用来将Java 对象作为 Web 资源展示。该规范假定 HTTP 是底层网络协议。它使用注释提供 URI 和相应资源类之间的清晰映射，以及 HTTP 方法与 Java 对象方法之间的映射。API 支持广泛的 HTTP 实体内容类型，包括 HTML、XML、JSON、GIF、JPG 等。它还将提供所需的插件功能，以允许使用标准方法通过应用程序添加其他类型。

常用的JAX-RSAPI介绍@ContextResource的上下文内容，比如URI，HttpRequest@Provider扩展自己的MediaType支持@path定义Resource的URI@GEThttpgetmethod@POSThttppostmethod@PUThttp put method@DELETEhttp deletemethod@Produces定义Resource返回的MediaType@Consumes定义Resource接受的MediaType@PathParam定义URI中的变量@FormParam定义form表单中的变量

JAX-RS框架介绍

实现JAX-RS规范的框架Restlet应该是最早的REST框架，在JAX-RS之前就已经有了。http://www.restlet.org/JerseySun提供的实现参考https://jersey.dev.java.net/RESTEasyJboss的项目http://www.jboss.org/resteasy/CXFApache的一级项目由Xfire项目和Celtix项目(一个开源的ESB项目)合并后演变过来http://cxf.apache.org

Restlet介绍项目地址http://www.restlet.orghttp://www.noelios.com/Restlet可以说是最早的REST框架,JAX-RS规范出来之前,它就已经存在了。Restlet是在Servlet的之上发展的这套框架http://www.restlet.org/about/introductionRestlet并不是完全按照JAX-RS规范来实现Restlet有自己的一套API稳定版本1.1.5,jax-rs 1.0的实现最新版本2.0-m4,jax-rs 1.0的实现特性：http://www.restlet.org/about/featuresNative REST supportAvailable editionsComplete Web ServerAvailable ConnectorsAvailable RepresentationsFlexible configurationSecurityScalabilityUpcoming features

Jersey介绍项目地址：https://jersey.dev.java.netJersey是Sun提供的实现参考。由JAX-RS项目的成员来实现。从某种意义上说，最符合JAX-RS规范Jersey项目名称的来由:由于Jersey项目的主管非常喜欢自行车运动，而且当时正是环法自行车赛期间，所以起了这个名称。同时也透露出对Jersey这个项目的期望。稳定版本为1.0.3，jax-rs1.0的实现最新版本1.1.2-ea，jax-rs1.1的实现特性：提供Client,Service/Grizzly,WADL&JSONTest FrameworkSpring integrationGuice integrationMIME multipartClient & Apache HTTP ClientAtom & Apache Abdera Simple HTTP serverOautch support

RESTEasy介绍项目地址：http://www.jboss.org/resteasy/RESTEasy是有JBOSS提供的实现。顾名思义，这个项目的初衷就是如何更好的让使用者很方便容易的创建REST应用最新稳定版本为1.1.GA,jax-rs 1.0的实现特性：Fully certified JAX-RS implementation Portable to any app-server/Tomcat that runs on JDK 5 or higher Embeddedable server implementation for junit testing Client framework that leverages JAX-RS annotations so that you can write HTTP clients easily (JAX-RS only defines server bindings) Client "Browser" cache. Supports HTTP 1.1 caching semantics including cache revalidationServer in-memory cache. Local response cache. Automatically handles ETag generation and cache revalidationRich set of providers for: XML, JSON, YAML, Fastinfoset, Multipart, XOP, Atom, etc. JAXB marshalling into XML, JSON, Jackson, Fastinfoset, and Atom as well as wrappers for maps, arrays, lists, and sets of JAXB Objects. GZIP content-encoding. Automatic GZIP compression/decompression suppport in client and server frameworksAsynchronous HTTP (Comet) abstractions for JBoss Web, Tomcat 6, and Servlet 3.0 Asynchronous Job Service. Rich interceptor model. EJB, Seam, Guice, Spring, and Spring MVC integration

CXF介绍项目地址:http://cxf.apache.orgApache的一级项目由Xfire项目和Celtix项目(一个开源的ESB项目)合并后演变过来更加偏向SOA稳定版本：2.2.3，jax-rs 1.0的实现。最新版本：2.3-SNAPSHOT，jax-rs 1.0的实现支持标准：JAX-WS, JSR-181, SAAJ, JAX-RSSOAP 1.1, 1.2, WS-I BasicProfile, WS-Security, WS-Addressing, WS-RM, WS-PolicyWSDL 1.1MTOM

由Xfire项目和Celtix项目(一个开源的ESB项目)合并后演变过来

ROA 面向资源的架构

ROA（面向资源架构）世间万物皆为资源REST对信息的核心抽象就是资源资源并不是具体的存储对象，它是对事物概念上的一个抽象Resource是有层次的Resource的定义是一门大学问面向资源的建模DDD(Domain-Driven Design)，面向对象建模，ER建模

如何规划ResourceURI使用URITemplate来描述ResourceURI的定义http://bitworking.org/projects/URI-Templates/spec/draft-gregorio-uritemplate-03.html

URI对比家族话题/familyBBS?method=GET&json={“familyId”:193，”bbsId”:412}/family/193/topic/412家族投票/familyVote?method=GET&json={“familyId”:193,”bbsId”:412}/family/193/topic/412/vote

家族投票

例子：社区家族URI规划家族/familys/familys/@self/{uid}/{page},{pageSize}/familys/@friends/{uid}/{page},{pageSize}家族分类/familys/type家族标签/familys/tags/familys/tags/@hot/{num}家族重名/familys/names/@userd/{fname}单个家族信息/family/{fid}家族图标/family/{fid}/icon家族设置/family/{fid}/setting家族成员/family/{fid}/members/family/{fid}/members/@manager家族转让/family/{fid}/transfer

例子：社区家族URI规划家族话题/family/{fid}/topics/family/{fid}/topics/{page},{pageSize}/family/{fid}/topics/@elite /{page},{pageSize}/family/{fid}/topics/@vote /{page},{pageSize}家族话题/family/{fid}/topic/{tid}/family/{fid}/topic/{tid}/vote/family/{fid}/topic/{tid}/vote/members/family/{fid}/topic/{tid}/ {page},{pageSize}/family/{fid}/topic/{tid}/reply/family/{fid}/topic/{tid}/reply/{rid}

如何使用JAX-RS框架快速的构建REST应用

选用框架Build ToolsMaven 2.2.0Jerseyjsr311 1.0jersey-server 1.0.3jersey-json 1.0.3jersey-spring 1.0.3JAXBjaxb-api 2.1Sun jaxb-impl 2.1.6Springspring 2.5.6

代码演示

谢谢