Jersey构建REST服务实战

由于参与移动项目，需要移动终端和服务端传递数据，经过技术对比分析，觉得基于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数据，即可成功，如下：