RESTEasy入门经典.docVIP

RESTEasy是JBoss的开源项目之一，是一个RESTful Web Services框架。RESTEasy的开发者Bill Burke同时也是JAX-RS的J2EE标准制定者之一。JAX-RS是一个JCP制订的新标准，用于规范基于HTTP的RESTful Web Services的API。 我们已经有SOAP了，为什么需要Restful WebServices？用Bill自己的话来说：如果是为了构建SOA应用，从技术选型的角度来讲，我相信REST比SOAP更具优势。开发人员会意识到使用传统方式有进行SOA架构有多复杂，更不用提使用这些做出来的接口了。这时他们就会发现Restful Web Services的光明之处。 说了这么多，我们使用RESTEasy做一个项目玩玩看。首先创造一个maven1的web项目 Java代码 ? mvn?archetype:create?-DgroupId=org.bluedash?\?? ?? ?? -DartifactId=try-resteasy?-DarchetypeArtifactId=maven-archetype-webapp??? mvn archetype:create -DgroupId=org.bluedash \ -DartifactId=try-resteasy -DarchetypeArtifactId=maven-archetype-webapp ? 准备工作完成后，我们就可以开始写代码了，假设我们要撰写一个处理客户信息的Web Service，它包含两个功能：一是添加用户信息；二是通过用户Id，获取某个用户的信息，而交互的方式是标准的WebService形式，数据交换格式为XML。假设一条用户包含两个属性：Id和用户名。那么我们设计交换的XML数据如下: Java代码 ? user ?? ????id1/id ?? ????nameliweinan/name ?? /user?? user id1/id nameliweinan/name /user ? 首先要做的就是把上述格式转换成XSD2，网上有在线工具可以帮助我们完成这一工作3，在此不详细展开。使用工具转换后，生成如下xsd文件： Java代码 ? ?xml?version=1.0?encoding=utf-8? ?? xsd:schema?attributeFormDefault=unqualified?elementFormDefault=qualified?? version=1.0?xmlns:xsd=/2001/XMLSchema ?? ??xsd:element?name=user?type=userType?/ ?? ??xsd:complexType?name=userType ?? ????xsd:sequence ?? ??????xsd:element?name=id?type=xsd:int?/ ?? ??????xsd:element?name=name?type=xsd:string?/ ?? ????/xsd:sequence ?? ??/xsd:complexType ?? /xsd:schema?? ?xml version=1.0 encoding=utf-8? xsd:schema attributeFormDefault=unqualified elementFormDefault=qualified version=1.0 xmlns:xsd=/2001/XMLSchema xsd:element name=user type=userType / xsd:complexType name=userType xsd:sequence xsd:element name=id type=xsd:int / xsd:element name=name type=xsd:string / /xsd:sequence /xsd:complexType /xsd:schema ? 有了xsd文件，我们便可以使用JDK自带工具的xjc将xsd转换成为Java的Class。将上述xsd文件存为 user.xsd，并使用如下命令进行转换： Java代码 ? xjc?user.xsd?? xjc user.xsd ?执行结束后我们会得到一系列的类文件： Java代码 ? Li-Weinans-MacBook-Pro:Desktop?liweinan$?xjc?user.xsd? ?? parsing?a?schema... ?? compiling?a?schema... ?? generated/ObjectFac