Jersey构建Restful风格的webservices

最近一直在搞老项目的开发工作，很少写博文了。听了两位阿里巴巴大牛的讨论，决定试试用restful风格的webservices看看。这里用的是Jersey这个框架，刚开始弄，有点麻烦，只能到处查资料。网上的资料也比较零碎，这里整理一下。一.helloworld需要三个包，这里从maven获取。

<dependencies>
<dependency>
<groupId>com.sun.jersey</groupId>
<artifactId>jersey-core</artifactId>
<version>1.18</version>
</dependency>
<dependency>
<groupId>com.sun.jersey</groupId>
<artifactId>jersey-json</artifactId>
<version>1.18</version>
</dependency>
<dependency>
<groupId>com.sun.jersey</groupId>
<artifactId>jersey-servlet</artifactId>
<version>1.18</version>
</dependency>
</dependencies>

然后再web.xml中代码：

<servlet>
<servlet-name>Jersey REST Service</servlet-name>
<servlet-class>
com.sun.jersey.spi.container.servlet.ServletContainer
</servlet-class>
<init-param>
<param-name>com.sun.jersey.config.property.packages</param-name>
<param-value>hello.resource</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>Jersey REST Service</servlet-name>
<url-pattern>/rest/*</url-pattern>
</servlet-mapping>

写一个资源类：

@Path("hello")
public class HelloResource {
@GET
@Produces(MediaType.TEXT_PLAIN)
public String greed(){
return "hello world";
}
}

这样，访问:http://localhost:8080/rest/hello ,可以看到页面会输出：hello world二.传递参数在HelloResource这个类中，新加一个方法：

@GET
@Produces(MediaType.TEXT_PLAIN)
@Path("{id}")
public String sayHello(@PathParam("id")int id){
return "hello jersey "+id;
}

此时，访问：http://localhost:8080/rest/hello/123 ，页面会输出：

hello jersey 123

后面的123即是参数id的值。试了一下，如果再写一个一样的方法，把参数类型改成String类型，当输入参数类型不同的时候，会自动识别不同的方法。不过中文不可以直接跟在后面，会有乱码的情况。我们一般传递参数的话，是采用?符来进行传参的。上面的方式看上去有点奇怪，不符合我们经常用的方式。这里还有一种方式，适合我们的方式，不采用PathParam这个属性，采用QueryParam这个。再写一个方法：

@GET
@Path("/param")
@Produces("text/plain")
public String sayHis(@QueryParam("param")String param){
return "nice "+param;
}

此时，访问：http://localhost:8080/rest/hello/param?param=work ，页面会输出：nice work这些算是一个基本入门，关于客户端使用等相关知识，在之后的博文中再写。这里有一篇博文写的也不错：http://my.oschina.net/mlongbo/blog/152548#OSC_h5_14另附glassfish配置方式：上面是用com.sun的包，还有一种是org.glassfish的包。配置都差不多。web.xml:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" version="3.0">
<servlet>
<servlet-name>Jersey REST Service</servlet-name>
<servlet-class>
org.glassfish.jersey.servlet.ServletContainer
</servlet-class>
<init-param>
<param-name>jersey.config.server.provider.packages</param-name>
<param-value>hello.resource</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>Jersey REST Service</servlet-name>
<url-pattern>/rest/*</url-pattern>
</servlet-mapping>

</web-app>

目前接触到的区别在于，用glassfish方式，配置后的json，不需要下载，浏览器即可显示出json内容。用sun的话，直接用json格式输出，需要下载打开才可以看到。不知道是不是也需要一些类似的配置。需要的包：

<dependencies>
<dependency>
<groupId>org.glassfish.jersey.containers</groupId>
<!-- if your container implements Servlet API older than 3.0, use "jersey-container-servlet-core"  -->
<artifactId>jersey-container-servlet</artifactId>
<version>2.13</version>
</dependency>
<!-- Required only when you are using JAX-RS Client -->
<dependency>
<groupId>org.glassfish.jersey.core</groupId>
<artifactId>jersey-client</artifactId>
<version>2.13</version>
</dependency>
</dependencies>