JAX-RS 简化 REST 学习
最近一个项目用到了webservice,决定用rest来实现，发现这方面的中文资料真的是不多。经过自己一番辛苦，终于把项目搞定，在这里简单的自己的学习的过程记录一下，供入门的兄弟参考一下。
一、rest简介：
REST 是英文 Representational State Transfer 的缩写，有中文翻译为“具象状态传输”。REST 这个术语是由 Roy Fielding 在他的博士论文《 Architectural Styles and the Design of Network-based Software Architectures 》中提出的。REST 并非标准，而是一种开发 Web 应用的架构风格，可以将其理解为一种设计模式。REST 基于 HTTP，URI，以及 XML 这些现有的广泛流行的协议和标准，伴随着 REST，HTTP 协议得到了更加正确的使用。
二、实现方式：
Apache 的 CXF 以及 JBoss 的 RESTEasy（待续）
三、入门实例：
http://developer.51cto.com/art/200912/172185.htm（网上很多）
涉及原理及数据绑定：http://www.ibm.com/developerworks/cn/java/j-lo-jaxrs/ 一篇不错的文章
jersey实例 Bookkeeping实例 这是两个不错的例子，大家有时间好好看看
四、看了上面的文章以后，感觉项目中只用到了rest其中的一小部分，还有好多东西值得认真学习一下，以便用到以后的项目中。
下面是自己感觉在上面例子中没有提到的一些东西，贴出来供大家参考。呵，仅一家之言啊，有不对的希望大家能提醒小弟：）
调用POST方法时传入实体类，并返回实例类的的写法，以及数据绑定、path映射多个参数。
客户端：
BankInterfaceAgent.java
GenericType<VirementResultInfo> generic = new GenericType<VirementResultInfo>() {};//定义返回的类型(加入泛型)
String id = "virement/" + clientSystemNo + "," + encryptKey +","+ isEncrypted +","+ bankCode;//"/"前为路径，后为参数，参数不能为空,为空则报错
//根据返回状态判断：404未找到;415不允许访问;405字段定义的方法不被允许; （另有文章描述返回状态含义）
try {
resultInfo = r.path(id)
.accept(MediaType.APPLICATION_XML) //返回的接收类型
.type(MediaType.APPLICATION_XML)//服务器入参类型,必传
.post(generic,transactionInfo); //直接传送实体类
} catch(Exception e) {
。。。。。。。
服务器端：
BankServiceAgent.java
//注意：数据传输时的序列化与反序列化由实例类绑定JAXBELEMENT实现，实体类必须绑定（在实例类中加入@XmlRootElement）
@Path("/virement/{clientSystemNo},{encryptKey},{isEncrypted},{bankCode}/") //路径和参数，注意格式（符合jax- rs311规范）
@POST //方式
@Consumes(MediaType.APPLICATION_XML) //传入参数形式定义
@Produces(MediaType.APPLICATION_XML) //返回结果形式定义
public VirementResultInfo virement( //直接返回实体类
@PathParam("clientSystemNo") String clientSystemNo,
@PathParam("encryptKey") String encryptKey,
@PathParam("isEncrypted") boolean isEncrypted,
@PathParam("bankCode") String bankCode,
TransactionInfo transInfo
) throws Exception
{
System.out.println("==========进入方法BankServiceAgent:virement():"+ (new Date(System.currentTimeMillis())) + "/n");
logger.info("==========进入方法com.iss.itreasury.bi.rest.services.virement()" + (new Date(System.currentTimeMillis())) + "/n");
VirementResultInfo resultInfo = new VirementResultInfo();
五、参考文档：
jsr311 API:https://jsr311.dev.java.net/nonav/releases/1.0/index.html
jersey实例：https://jersey.dev.java.net/
使用JAX-RS简化REST应用开发
：http://www.bianceng.cn/Programming/Java/201101/23660_6.htm
Bookkeeping.rar实例在资源下载中。。。
好了，先写这么多，慢慢完善，大家如果有什么好的帖子要发上来啊，共同学习：）