jersey 是基于Java的一个轻量级RESTful风格的Web Services框架。

引入

使用maven，在pom.xml中加入：

org.glassfish.jersey.core

jersey-client

${jersey.version}

org.glassfish.jersey.containers

jersey-container-servlet

${jersey.version}

org.glassfish.jersey.media

jersey-media-moxy

${jersey.version}

org.glassfish.jersey.media

jersey-media-multipart

${jersey.version}

当然必不可少的，也需要使用Java EE的支持：

javax

javaee-api

7.0

provided

Jar包详解：

jersey-client 是jersey提供的客户端包，封装了一些客户端操作的类

jersey-container-servlet 是jersey的核心，服务端必备包

jersey-media-moxy 是定义了jersry支持的常用的数据格式，json，xml都包括其中

jersey-media-multipart 是jersey的上传文件的支持

配置

jersey 的使用，必须要有一个全局的配置类，这个类需满足以下条件：

@ApplicationPath 注解该类，并且在参数中指定相对路径

继承 org.glassfish.jersey.server.ResourceConfig 类

该类构造方法中设置jersey的配置，比如指定接口的包路径

如下：

@ApplicationPath("/")

public class RESTServiceConfig extends ResourceConfig {

public RESTServiceConfig() {

packages("web.rest");

register(MultiPartFeature.class);

}

}

GET

GET例子：

@GET

@Path("/thing")

public String get() {

return "thing";

}

POST

POST例子：

@POST

@Path("/add")

public Boolean add(@FormParam("name") String name) {

// TODO save

return true;

}

Param

jersey中有几种常用的接收参数的注解：

@PathParam 接收链接中参数，如"/xxx/{name}/",@PathParm("name")

@QueryParam 接收链接中的普通参数，如"/xxx?name=ttt",@QueryParam("name")

@FormParm 接收post提交中的表单参数

@FormDataParm 上传文件接收文件参数

json

开发中，json已经常用到无处不在了，jersey对json的支持很好。接收json，需要使用@Consumes，注解指定解压方式：

@Consumes(MediaType.APPLICATION_JSON)

返回json需要使用@Produces注解，指定压缩方式：

@Produces(MediaType.APPLICATION_JSON)

文件上传

示例:

@POST

@Path("import-excel")

@Consumes(MediaType.MULTIPART_FORM_DATA)

@Produces(MediaType.APPLICATION_JSON)

public ImportResultBean importForExcel(@FormDataParam("file") String fileString,

@FormDataParam("file") InputStream fis,

@FormDataParam("file") FormDataContentDisposition fileDisposition) {

// TODO

return ;

}

文件下载

文件下载需要将Response对象的压缩方式，指定为：

@Produces(MediaType.APPLICATION_OCTET_STREAM)