Restful Web Service 介绍及Jersey实现
REST
?
2000 年由 Roy Fielding 在博士论文中提出，他是 HTTP 规范 1.0 和 1.1 版的首席作者之一。
?
REST 中最重要的概念是资源（resources），使用全球 ID（通常使用 URI）标识。客户端应用程序使用 HTTP 方法（GET/ POST/ PUT/ DELETE）操作资源或资源集。RESTful Web 服务是使用 HTTP 和 REST 原理实现的 Web 服务。通常，RESTful Web 服务应该定义以下方面：
POST、GET、PUT 或 DELETE)如下表所示：
方法/资源??资源集合， URI 如：
http://host/<appctx>/resources??成员资源，URI 如：
http://host/<appctx>/resources/1234?GET列出资源集合的所有成员检索标识为 1234 的资源的表示形式。PUT使用一个集合更新（替换）另一个集合。更新标记为 1234 的数字资源。POST在集合中创建数字资源在下面创建一个子资源。DELETE删除整个资源集合。删除标记为 1234 的数字资源。
?
?
JSR－311 ?Java API for RESTful Web Services (JAX-RS) 1.0 and 1.1
? ? ? JAX-RS是将在JavaEE 6引起的一种新技术。 JAX-RS即Java API for RESTful Web Services，是一个Java 编程语言的应用程序接口，支持按照表述性状态转移（REST）架构风格创建Web服务。JAX-RS使用了Java SE5引入的Java标注来简化Web服务的客户端和服务端的开发和部署。包括：
?
@Path，标注资源类或者方法的相对路径 @GET，@PUT，@POST，@DELETE，标注方法是HTTP请求的类型。 @Produces，标注返回的MIME媒体类型 @Consumes，标注可接受请求的MIME媒体类型@PathParam，@QueryParam，@HeaderParam，@CookieParam，@MatrixParam，@FormParam,分别标注方法的参数来自于HTTP请求的不同位置，例如@PathParam来自于URL的路径，@QueryParam来自于URL的查询参数，@HeaderParam来自于HTTP请求的头信息，@CookieParam来自于HTTP请求的Cookie。?
Jersey 实现
?
Jersey 是 JAX-RS 的参考实现，它包含三个主要部分。
核心服务器（Core Server）：通过提供 JSR 311 中标准化的注释和 API 标准化，您可以用直观的方式开发 RESTful Web 服务。 核心客户端（Core Client）：Jersey 客户端 API 帮助您与 REST 服务轻松通信。 集成（Integration）：Jersey 还提供可以轻松集成 Spring、Guice、Apache Abdera 的库。?
用微账户的查询接口作一个例子
?
@Path("/accinfo")public class AccountInfoResource {@ContextUriInfo uriInfo;@ContextRequest request;/* * Get all accounts info */@GET@Path("all")@Produces(MediaType.APPLICATION_XML)public List<AccountInfo> getAllaccounts() throws UnsupportedEncodingException{List<AccountInfo> retList = new ArrayList<AccountInfo>();EntityManager em = EntityManagerHelper.getEntityManager();MaaccdtapManager mm = new MaaccdtapManager(em);List<Maaccdtap> mList = mm.getAllAccounts();AccountInfo ai = null;AccountAdapter ad = new AccountAdapter();for(Maaccdtap m : mList){ai = ad.getAccountInfo(m);retList.add(ai);}EntityManagerHelper.closeEntityManager();return retList;}/* * Get account info by mbrseq id */@GET@Path("{accountid}")@Produces(MediaType.APPLICATION_XML)public AccountInfo getAccountBySid(@PathParam("accountid") String accountid) throws UnsupportedEncodingException{EntityManager em = EntityManagerHelper.getEntityManager();MaaccdtapManager mm = new MaaccdtapManager(em);Maaccdtap mp = mm.getAccountBySid(accountid);AccountInfo ai = null;if(null != mp){AccountAdapter ad = new AccountAdapter();ai = ad.getAccountInfo(mp);}EntityManagerHelper.closeEntityManager();return ai;}}用下面的URL即可访问相应的账户信息（即Resource）
??http://ip:port/MicroAcc/rest/accinfo/{mbrseq}? ? ?
??http://ip:port/MicroAcc/rest/accinfo/all
@Produces(MediaType.APPLICATION_JSON)则可以产生Json的输出。
Jersey配置：
Jersey 1.2 以后的版本和一些Update的维护版本只支持Java SE 6, 在选择版本和相应服务器时需要注意。
?
从 Jersey 开发包中以下的库为必须：
核心服务器：jersey-core.jar，jersey-server.jar，jsr311-api.jar，asm.jarJAXB 支持：jaxb-impl.jar，jaxb-api.jar，activation.jar，stax-api.jar，wstx-asl.jarJSON 支持：jersey-json.jar?
Web.xml:
?
<servlet> <servlet-name>Jersey REST Service</servlet-name> <servlet-class> com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class> <init-param> <param-name>com.sun.jersey.config.property.packages</param-name> <param-value>sh.cmbchina.pension.resources</param-value> </init-param> <load-on-startup>1</load-on-startup></servlet><servlet-mapping> <servlet-name>Jersey REST Service</servlet-name> <url-pattern>/rest/*</url-pattern></servlet-mapping>
?这样，所有在包sh.cmbchina.pension.resources下面的resource类都会被注册为Restful url的响应处理类。
?