Jersey构建REST服务实战

xiaoxiao2021-02-28  100

由于参与移动项目,需要移动终端和服务端传递数据,经过技术对比分析,觉得基于REST模式的Web服务比较简洁易用,于是采取了Jersey开发, 一个Java规范下REST风格Web Service开发框架。最初选择的是Jersey1.8,后来由于运行环境的升级,导致Jersey也要升级到最新版本2.5.1。由于jersey2.x 版本实现的是JAX-RS 2.0规范,与 jersey1.x 相比有很大的改变,JSON转换也有不同。现把实现过程整理下来,供有需要的朋友参考!

一:环境介绍

(1)Jersey2.5.1 

(2)Eclipse 3.7 +Tomcat 7 +JDK 7

二:搭建步骤

(1)通过地址https://jersey.java.net/ 下载jaxrs-ri-2.5.1.zip。

(2)通过Eclipse 创建动态工程RestDemo。

(3)解压jaxrs-ri-2.5.1.zip,拷贝下图列表中的JAR包到RestDemo\WebContent\WEB-INF\lib下。

(4)创建包路径  cn.com.vs.vo,创建User.java:

package cn.com.vs.vo;

import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement public class User {    private String name;    private String age;    private String sex;    public String getName() {   return name;  }  public void setName(String name) {   this.name = name;  }  public String getAge() {   return age;  }  public void setAge(String age) {   this.age = age;  }  public String getSex() {   return sex;  }  public void setSex(String sex) {   this.sex = sex;  } }

(5)创建包路径  cn.com.vs.service,创建RestService.java:

package cn.com.vs.service;

import javax.ws.rs.GET; import javax.ws.rs.Path; import javax.ws.rs.Produces; import javax.ws.rs.core.MediaType;

import cn.com.vs.vo.User;

@Path("/restService") public class RestService {  @GET  @Path("/getUserText")  @Produces(MediaType.TEXT_PLAIN)  public String getUserText() {   return "Hello,World!";  }    @GET  @Path("/getUserXml")  @Produces(MediaType.APPLICATION_XML)  public User getUserXml() {   User user  = new User();   user.setName("snail");   user.setAge("22");   user.setSex("male");   return user;  }    @GET  @Path("/getUserJson")  @Produces(MediaType.APPLICATION_JSON)  public User getUserJson() {   User user  = new User();   user.setName("snail");   user.setAge("22");   user.setSex("male");   return user;  } }

(6)在 cn.com.vs 包路径下创建类 RestApplication.java

package cn.com.vs;

import org.glassfish.jersey.filter.LoggingFilter; import org.glassfish.jersey.server.ResourceConfig;

public class RestApplication extends ResourceConfig {

    public RestApplication() {      //服务类所在的包路径      packages("cn.com.vs.service");       //打印访问日志,便于跟踪调试,正式发布可清除       register(LoggingFilter.class);     }

}

(7)修改web.xml,内容如下:

<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaeehttp://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0">   <display-name>RestDemo</display-name>   <servlet>   <servlet-name>mobile</servlet-name>   <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>    <init-param>             <param-name>javax.ws.rs.Application</param-name>             <param-value>cn.com.vs.RestApplication</param-value>         </init-param>   <load-on-startup>1</load-on-startup>  </servlet>

 <servlet-mapping>   <servlet-name>mobile</servlet-name>   <url-pattern>/rest/*</url-pattern>  </servlet-mapping>   <welcome-file-list>     <welcome-file>index.html</welcome-file>   </welcome-file-list> </web-app>

(8)在 Tomcat7 中部署运行,查看发布效果:

     获取 文本数据:

     获取XML数据:

  获取JSON数据:http://localhost:8080/RestDemo/rest/restService/getUserJson ,会出现如下异常:

[org.glassfish.jersey.message.internal.MessageBodyProviderNotFoundException: MessageBodyWriter not found for media type=application/json, type=class cn.com.vs.vo.User, genericType=class cn.com.vs.vo.User.] with root cause org.glassfish.jersey.message.internal.MessageBodyProviderNotFoundException: MessageBodyWriter not found for media type=application/json, type=class cn.com.vs.vo.User, genericType=class cn.com.vs.vo.User.

说明:如果通过glassfish-4.0运行的话,是没任何问题的!如果通过tomcat,需要添加JSON转换器。

(9)解决获取JSON数据的异常,途径一:

     a)下载 jackson-all-1.9.11.jar ,放到lib下。

     b)修改RestApplication.java,内容如下:

package cn.com.vs;

import org.codehaus.jackson.jaxrs.JacksonJsonProvider; import org.glassfish.jersey.filter.LoggingFilter; import org.glassfish.jersey.server.ResourceConfig;

public class RestApplication extends ResourceConfig {

    public RestApplication() {      //服务类所在的包路径      packages("cn.com.vs.service");      //注册JSON转换器      register(JacksonJsonProvider.class);       //打印访问日志,便于跟踪调试,正式发布可清除       register(LoggingFilter.class);     }

}

(10)解决获取JSON数据的异常,途径二:  

    a) 下载 glassfish-4.0.zip ,解压,拷贝下列JAR到lib下:

      

   b)修改RestApplication.java,内容如下:

package cn.com.vs;

import org.glassfish.jersey.filter.LoggingFilter; import org.glassfish.jersey.jackson.JacksonFeature; import org.glassfish.jersey.server.ResourceConfig;

public class RestApplication extends ResourceConfig {

    public RestApplication() {      //服务类所在的包路径      packages("cn.com.vs.service");      //注册JSON转换器      register(JacksonFeature.class);        //打印访问日志,便于跟踪调试,正式发布可清除       register(LoggingFilter.class);     }

}

(11)选择上述途径中的一种,然后发布启动,获取JSON数据,即可成功,如下:

转载请注明原文地址: https://www.6miu.com/read-68789.html

最新回复(0)