- 浏览: 1182948 次
- 性别:
- 来自: 广州
文章分类
- 全部博客 (883)
- Spring (101)
- Swing (1)
- Mysql (21)
- Js (59)
- Jsp (2)
- Hibernate (19)
- Myeclipse (5)
- SqlServer 2000 (2)
- poi (15)
- Java (70)
- SSH (12)
- Html (47)
- Fusion Charts (1)
- C\C++ (2)
- 汇编 (36)
- Jquery (37)
- Struts2 (6)
- Ubuntu (16)
- powerDesinger (4)
- Jboss (3)
- JAX-RS (13)
- JAXB (5)
- JAX-WS (11)
- JMS (4)
- WebSocket (8)
- PHP (16)
- Flash (1)
- maven (3)
- Oracle (8)
- HttpClient (6)
- sqlserver (19)
- svn (5)
- Tomcat (3)
- Jdbc (3)
- EsayUi (11)
- 微信公众平台 (19)
- IIS (2)
- Freemarker (11)
- Comet (1)
- Spring MVC (85)
- JBoss Seam (3)
- 二维码 (9)
- Spring Security (4)
- Ehcache (3)
- Apache Shiro (7)
- jackson (16)
- JPA (8)
- jcaptcha (2)
- RSA (2)
- Ajax (6)
- 跟我学Shiro (0)
- Spring4 (19)
- 跟我学spring3 (0)
- css (32)
- excel (4)
- Filter (3)
- 微信公众帐号开发教程 (0)
- Android (6)
- log4j (6)
- 淘宝接口 (17)
- 支付集成 (3)
- 单点登录 (3)
- Html5 (27)
- 移动平台前端 (3)
- Linux (44)
- FusionCharts (27)
- Json Jackson Xml (5)
- 方培工作室-微信开发 (0)
- Apache与Tomcat与IIS整合 (10)
- Nginx (17)
- webService (2)
- apache (4)
- lucene (3)
- lodop (2)
- Shiro (3)
- zTree (2)
- ireport (12)
- Servlet3.0 (5)
- 前端美工 (19)
- AngularJS (1)
- C#开发微信门户及应用 (0)
- Shell (3)
- bat脚本 (16)
- Bootstrap (26)
- Less (10)
- photoshop (6)
- Redis (6)
- Mongodb (10)
- MyBatis (3)
- 数据结构 (0)
- 读写分离-主从复制 (0)
- JFinal (0)
- 百度地图api (3)
- hadoop-hbase-hive-spark (3)
- WebStorm (2)
- Quartz (5)
- ios (0)
- Mina (8)
- Android Studio (4)
- Ratchet教程 (0)
- 移动端重构系列 (1)
- cubic-bezier贝塞尔曲线CSS3动画工具 (1)
- nginx+tomcat+memcached集群 (0)
- 集群 (0)
- ZooKeeper (3)
- Dubbo (0)
- vpn (0)
- kafka (0)
- JVM垃圾回收机制 (0)
- 微信小程序 (0)
- Lua (0)
- Hystrix (0)
- Vue.js (0)
- mycat (0)
- Openresty (0)
- springBoot (0)
- 新分类 (0)
- guava (0)
- 大数据 (0)
- Sentinel (0)
最新评论
-
JackMacing:
中文怎么解决?
SpringMVC与iReport(JasperReports) 5.6整合开发实例 -
18335864773:
用pageoffice把.可以实现在线的文档操作.直接转pdf ...
转:使用jasperreport动态生成pdf,excel,html -
linhao0907:
推荐一款轻量开源的支付宝组件:https://github.c ...
关于Alipay支付宝接口(Java版) -
songronghu:
太好了,非常有用,谢谢分享~
Java ConcurrentModificationException 异常分析与解决方案 -
wzwahl36:
http://www.atool.org/json2javab ...
Java下利用Jackson进行JSON解析和序列化
简介
JAX-RS是一套用java实现REST服务的规范,提供了一些标注将一个资源类,一个POJOJava类,封装为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。
目前JAX-RS的实现包括:
- Apache CXF,开源的Web服务框架。
- Jersey, 由Sun提供的JAX-RS的参考实现。
- RESTEasy,JBoss的实现。
- Restlet,由Jerome Louvel和Dave Pawson开发,是最早的REST框架,先于JAX-RS出现。
- Apache Wink,一个Apache软件基金会孵化器中的项目,其服务模块实现JAX-RS规范
(以上来自:http://zh.wikipedia.org/wiki/JAX-RS)
装备
本文使用的工具有:
- Eclipse-jee-helios
- Java-1.6.0_26
- apache-tomcat-6.0.30
- SoapUI-3.6
使用到的外部jar包有(必须的部分,需要加到Web容器中)
- neethi-3.0.2.jar
- jsr311-api-1.1.1.jar
- cxf-bundle-2.6.0.jar
使用到的外部jar包有(可选的部分,当且仅当作为一个独立的application运行时)
- jetty-http-7.5.4.v20111024.jar
- jetty-io-7.5.4.v20111024.jar
- jetty-server-7.5.4.v20111024.jar
- jetty-util-7.5.4.v20111024.jar
- jetty-continuation-7.5.4.v20111024.jar
- wsdl4j-1.6.2.jar
准备
(以下例子来自: Oreilly - RESTful Java with JAX-RS (12-2009) (ATTiCA).pdf)
创建工程
为了后续顺利进行,首先在eclipse上先创建一个Dynamic Web Project,完成以后,一个符合war结构的工程目录会自动生成,之后可以很简单的导出为war文件,其中需要把以下jar包放到 /WebContent/WEB-INF/lib 里:
- neethi-3.0.2.jar
- jsr311-api-1.1.1.jar
- cxf-bundle-2.6.0.jar
另外,在工程目录下,新建一个 lib 文件夹用来存放以下可选的jar包:
- jetty-http-7.5.4.v20111024.jar
- jetty-io-7.5.4.v20111024.jar
- jetty-server-7.5.4.v20111024.jar
- jetty-util-7.5.4.v20111024.jar
- jetty-continuation-7.5.4.v20111024.jar
- wsdl4j-1.6.2.jar
最后一步就是把所有这9个jar都加到工程的build path里去,这样工程就准备好了。
定义服务
这里要实现一个简单的REST服务用于对客户进行管理,包括:
- 创建客户
- 查看客户
- 更新客户
首先给出对应的于这些操作的服务接口:
- import java.io.InputStream;
- import javax.ws.rs.Consumes;
- import javax.ws.rs.GET;
- import javax.ws.rs.POST;
- import javax.ws.rs.PUT;
- import javax.ws.rs.Path;
- import javax.ws.rs.PathParam;
- import javax.ws.rs.Produces;
- import javax.ws.rs.core.Response;
- import javax.ws.rs.core.StreamingOutput;
- @Path("/customers")
- public interface CustomerResource {
- @POST
- @Consumes("application/xml")
- public Response createCustomer(InputStream is);
- @GET
- @Path("{id}")
- @Produces("application/xml")
- public StreamingOutput getCustomer(@PathParam("id") int id);
- @PUT
- @Path("{id}")
- @Consumes("application/xml")
- public void updateCustomer(@PathParam("id") int id, InputStream is) ;
- }
令人惊奇的是,这个接口已经包含了所有实现我们既定目标的关键部分:
- @Path: 定义服务路径,接口中定义的整个服务的顶级路径为"/customers ",方法对应的服务路径为接口路径加方法定义的Path值,如果未定义,则用接口路径,例如getCustomer()的服务路径为:" /customers/{id} "。所以此REST对外服务路径都是 服务的上下文路径/customers/ 子级目录,
- @POST,@GET,@PUT:标注方法所支持HTTP请求的类型 (参考上面的说明)
- @Produces,@Consumes:标注方法支持或返回的请求MIME类型。
由上可以看到,每个方法被调用的条件如下:
-
createConsumer(): 请求HTTP方法为POST;请求MIME类型为application/xml;请求路径为: 上下文路径/customers
-
getCustomer(): 请求的HTTP方法为GET;请求的MIME类型为application/xml;请求的路径为: 上下文路径/customers/{id}
注: {id}为某个存在(或不存在)customer的编号
-
updateCustomer(): 请求的HTTP方法为PUT;请求的MIME类型为application/xml;请求的路径: 上下文路径/customers/{id}
注: {id}为某个存在(或不存在)customer的编号
一个好的实现方法是将REST服务的定义和实现分开,这样代码的结构简洁、清晰,在后期也可以很方便的进行实现的替换和服务定义的修改。
下面就是添加实现部分:
- public class CustomerResourceService implements CustomerResource{
- private Map<Integer, Customer> customerDB = new ConcurrentHashMap<Integer, Customer>();
- private AtomicInteger idCounter = new AtomicInteger();
- public Response createCustomer(InputStream is) {
- Customer customer = readCustomer(is);
- customer.setId(idCounter.incrementAndGet());
- customerDB.put(customer.getId(), customer);
- System.out.println("Created customer " + customer.getId());
- return Response.created(URI.create("/customers/" + customer.getId()))
- .build();
- }
- public StreamingOutput getCustomer(int id) {
- final Customer customer = customerDB.get(id);
- if (customer == null) {
- throw new WebApplicationException(Response.Status.NOT_FOUND);
- }
- return new StreamingOutput() {
- public void write(OutputStream outputStream) throws IOException,
- WebApplicationException {
- outputCustomer(outputStream, customer);
- }
- };
- }
- public void updateCustomer(int id, InputStream is) {
- Customer update = readCustomer(is);
- Customer current = customerDB.get(id);
- if (current == null)
- throw new WebApplicationException(Response.Status.NOT_FOUND);
- current.setFirstName(update.getFirstName());
- current.setLastName(update.getLastName());
- current.setStreet(update.getStreet());
- current.setState(update.getState());
- current.setZip(update.getZip());
- current.setCountry(update.getCountry());
- }
- protected void outputCustomer(OutputStream os, Customer cust)
- throws IOException {
- PrintStream writer = new PrintStream(os);
- writer.println("<customer id=\"" + cust.getId() + "\">");
- writer.println(" <first-name>" + cust.getFirstName() + "</first-name>");
- writer.println(" <last-name>" + cust.getLastName() + "</last-name>");
- writer.println(" <street>" + cust.getStreet() + "</street>");
- writer.println(" <city>" + cust.getCity() + "</city>");
- writer.println(" <state>" + cust.getState() + "</state>");
- writer.println(" <zip>" + cust.getZip() + "</zip>");
- writer.println(" <country>" + cust.getCountry() + "</country>");
- writer.println("</customer>");
- }
- protected Customer readCustomer(InputStream is) {
- try {
- DocumentBuilder builder = DocumentBuilderFactory.newInstance()
- .newDocumentBuilder();
- Document doc = builder.parse(is);
- Element root = doc.getDocumentElement();
- Customer cust = new Customer();
- if (root.getAttribute("id") != null
- && !root.getAttribute("id").trim().equals("")) {
- cust.setId(Integer.valueOf(root.getAttribute("id")));
- }
- NodeList nodes = root.getChildNodes();
- for (int i = 0; i < nodes.getLength(); i++) {
- Node item = nodes.item(i);
- if(!(item instanceof Element)){
- continue;
- }
- Element element = (Element) nodes.item(i);
- if (element.getTagName().equals("first-name")) {
- cust.setFirstName(element.getTextContent());
- } else if (element.getTagName().equals("last-name")) {
- cust.setLastName(element.getTextContent());
- } else if (element.getTagName().equals("street")) {
- cust.setStreet(element.getTextContent());
- } else if (element.getTagName().equals("city")) {
- cust.setCity(element.getTextContent());
- } else if (element.getTagName().equals("state")) {
- cust.setState(element.getTextContent());
- } else if (element.getTagName().equals("zip")) {
- cust.setZip(element.getTextContent());
- } else if (element.getTagName().equals("country")) {
- cust.setCountry(element.getTextContent());
- }
- }
- return cust;
- } catch (Exception e) {
- throw new WebApplicationException(e, Response.Status.BAD_REQUEST);
- }
- }
- }
这些方法的实现都很直接,不细说,不过有一点需要特别注意的是:
最好不要在实现中混杂有服务的定义部分,例如@Path标签,@PathParam标签等等,如果想修改定义,最好是在接口中修改;或者如果想覆盖某个接口方法的某个annotation,则所有该接口方法的annotation定义都需要重写,而不能仅修改变化的。
发表评论
-
JAX-RS入门 十二: 可伸缩的JAX-RS应用
2012-09-11 19:10 637一、HTTP Caching HTTP1.0中定义了E ... -
JAX-RS入门 十一:HATEOAS
2012-09-11 19:09 691HATEOAS全称:超媒体即状态应用引擎 (Hypermedi ... -
JAX-RS入门 十: 兼容与演进
2012-09-11 19:09 811网络服务会随着时间 ... -
JAX-RS入门 九: 内容约定(2)
2012-09-10 23:33 587JAX-RS与Conneg JAX-RS有一些用来帮助 ... -
JAX-RS入门 九: 内容约定(1)
2012-09-10 23:32 625通常一个SOA的应用都需要足够的灵活,以便于各种不同的客户端或 ... -
JAX-RS入门 八: HTTP响应
2012-09-10 23:32 958首先先看一下HTTP中定义的响应码及其意义: ... -
JAX-RS入门 七: 数据处理(2)
2012-09-10 23:31 833上节介绍了JAX-RS中怎么与一些基础的对象进行交互,这节介绍 ... -
JAX-RS入门 六: 数据处理(1)
2012-09-10 23:30 874接下来要花两小节来介绍一下JAX-RS中的数据处理(Data ... -
JAX-RS入门 五: 自动类型转换
2012-09-09 12:41 678一、默认类型转换规则 在上一节中,已经了解了怎么使用那 ... -
JAX-RS入门 四: 注入
2012-09-09 12:39 1075一、Annotations @javax.ws.rs.Pa ... -
JAX-RS入门 三 :细节
2012-09-09 12:33 716一、若希望一个Java类能够处理REST请求,则这个类必须 ... -
JAX-RS入门 二 :运行
2012-09-09 12:31 929上一节,已经成功的定义了一个REST服务,并且提供了具体的 ...
相关推荐
JAX-RS入门能够用到的jar包集合,全部收纳于此
入门Web服务使用JAX-RS和Jersey构建的入门Web服务。 要进行部署,请安装Gradle并从命令行运行gradle jettyRun 。文献资料包含有关JAX-RS和servlet的详细信息。
#JAX-RS-PLAYGROUND Various JAX-RS templates and examples 专案 kitchensink-angularjs:快速入门项目的副本 ejb-crud:ejb模块上的CRUD操作示例,JAX-RS注释演示,JAX-RS 2.0客户端(在测试用例中使用) war-...
快速入门使用Spring Boot来配置一个小的应用程序,其中包括启用了Swagger的CXF JAXRS端点。 重要的 该快速入门可以在2种模式下运行:在您的计算机和Kubernetes / OpenShift群集上独立运行 部署选项 您可以在以下...
CICS-Liberty-JAXRS-示例CICS-Liberty-J...查询目录项,例如: 参考: 还有其他方法可以转换 JSON 或配置 JAX-RS,请参阅下面的详细信息: 将 Jackson 与普通的旧 Java 对象(POJO)一起使用 IBM JAX-RS 入门:
如果要探索基于JSF,JAX-RS和MVC的真实世界的Jakarta EE 8应用程序,请检查从该项目派生的以下项目。建立确保已安装最新的JDK 8和Apache Maven 3.6。 执行以下命令以在本地构建干净的程序包。 mvn clean package ...
service-jee-jaxrs快速入门演示了如何使用受Red Hat SSO保护的JAX-RS编写RESTful服务。 服务公开了3个端点: public -无需身份验证 secured -可以由具有user角色的user调用 admin可以由具有admin角色的用户调用 ...
这是使用AngularJS和PostgreSQL启动Jax-RS项目的简单方法。 您可以在几秒钟内创建一个简单的项目2.使用方法要从npm安装generator-japs,请运行: npm install -g yonpm install -g generator-japs 最后,启动生成器...
JAX-RS RESTEasy是一个JBoss项目,它提供各种框架来帮助您构建RESTful Web服务和RESTful Java应用程序。 它是JAX-RS规范的可移植实现。 JAX-RS的全名是Jakarta RESTful Web服务,它通过HTTP协议为RESTful Web服务...
一个示例 Spring、CXF、JAX-RS 应用程序,它在不同的 CXFServlet 上加载了两个 API。 一公一私。 主要特征 弹簧注射 JAX-RS CXF 双API 入门 要启动应用程序,请运行以下命令: jetty:run 将有 2 个 API 可用: ...
在EAP上使用Java EE(JAX-RS)的Hello微服务 可在以下存储库中找到运行Red Hat Helloworld MSA演示的详细说明: : 在本地构建和部署Hello 确保您已经启动了JBoss EAP服务器 打开命令提示符,然后导航到该微服务的...
在本文档中,我们整理了一份入门指南,可帮助您快速上手:采用的 JSR 列表JSR-365:CDI 2.0 JSR-367:JSON-P JSR-369:Servlet 4.0 JSR-370:JAX-RS 2.1 JSR-371:MVC 1.0 JSR-372:JSF 2.3如何贡献? glassfish ...
Brey 级别:中级技术:CDI,JAX-RS 简介: helloworld-rs快速入门演示了一个简单的Hello World应用程序,该应用程序捆绑并部署为WAR,使用JAX-RS表示Hello。 目标产品:JBoss EAP 资料来源: : 它是什么? hello...
jersey-webapp-1.0-SNAPSHOT.jar - 包含 Runner 以启动 JerseyVerticle verticle 和 JAX-RS jersey 资源的存档###启动服务获取部署在JerseyVerticle中的资源Linux:从根文件夹启动“run.sh” Windows:将
JAXRS 2.0 简单入门项目该项目演示了如何实现一个非常简单的 Web 服务,旨在用作新 RESTful API 的入门项目。系统要求: Maven 2.0.9 或更高版本构建项目: 在根目录mvn码头:运行这将构建一个 WAR 并使用嵌入式 ...
Brey) 级别:中级技术:CDI,JAX-RS 简介: helloworld-rs快速入门演示了一个简单的Hello World应用程序,该应用程序捆绑并部署为WAR,使用JAX-RS表示Hello。 目标产品:JBoss EAP 资料来源: : 它是什么? ...
kitchensink-angularjs:使用JAX-RS演示AngularJS 作者:皮特·缪尔(Pete Muir) 级别:中级技术:AngularJS,CDI,JPA,EJB,JPA,JAX-RS,BV 简介: kitchensink-angularjs快速入门演示了将AngularJS与JAX-RS,...
JAX-RS : -- JSON-B : -- JSON-P : -- MicroProfile Config : -- MicroProfile容错能力: -- MicroProfile指标: -- MicroProfile JWT Auth : -- MicroProfile Rest Client : -- MicroProfile OpenAPI...
wildfly 8 BootsFaces + PrimeFaces展示:Pete Muirs Wildfly Quickstarter的扩展作者:Pete Muir的Christian Laboranowitsch原文:中间技术:CDI,JSF,JPA,EJB,JPA,JAX-RS,BV,BootsFaces,Bootstrap,...