JAVA+Spring+Hibernate使用Jersey开发Rest WEB SERVICES

一、名词解释1 Rest Web ServicesRepresentational State Transfer,具象状态传输。

REST 中最重要的概念是资源（resources），使用全球ID（通常使用URI）标识。

客户端应用程序使用HTTP 方法（GET/ POST/ PUT/ DELETE）操作资源或资源集。

RESTful Web 服务是使用HTTP 和REST 原理实现的Web 服务。

通常，RESTful Web 服务应该定义以下方面：∙Web 服务的基/根URI，比如http://host/<appcontext>/resources。

∙支持MIME 类型的响应数据，包括JSON/XML/ATOM 等等。

∙服务支持的操作集合（例如POST、GET、PUT或DELETE）。

2 @注释说明2.1 @Produces 表示返回的格式@Produces( {MediaType.APPLICATION_XML }) 表示返回的xml格式@Produces( {MediaType.APPLICATION_JSON }) 表示返回的json格式@Produces( { MediaType.TEXT_PLAIN }) 表示返回的纯文本格式2.2 @ Consumes@Consumes ( { application/x-www-form-urlencoded }) 窗体数据被编码为名称/值对@Consumes @Singleton @XmlRootElement@Provider二、初始化工程1下载jar包2 新建web工程使用MyEclipse8.5新建web工程,命名为RestfulDemo，将上述下载jar包导入lib3 修改web.xml添加如下内容<servlet><servlet-name>ServletAdaptor</servlet-name><servlet-class>com.sun.jersey.server.impl.container.servlet.ServletAdaptor</servlet-class><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>ServletAdaptor</servlet-name><url-pattern>/*</url-pattern></servlet-mapping>4 将工程部署至tomcat服务器生成url，例如http://localhost:8080/RestfulDemo这个url是服务的最基本的url，后面的服务都是基于这个地址添加路径组合，例如http://localhost:8080/RestfulDemo/HelloWorldRS三、使用jersey开发简单的rest web services1 @GET1.1服务端package ;import java.util.ArrayList;import java.util.List;import javax.servlet.http.HttpServletRequest;import javax.ws.rs.DELETE;import javax.ws.rs.GET;import javax.ws.rs.POST;import javax.ws.rs.Path;import javax.ws.rs.Produces;import javax.ws.rs.QueryParam;import javax.ws.rs.core.Context;@Path("/HelloWorldRS") // 本服务的访问路径，与工程路径组合使用public class HelloWorldRS {M ap<String,String> map = new HashMap<String,String>();p ublic HelloWorldRS() {map.put("1","A");map.put("2","B");map.put("3","C");}@GET //表明是一个GET方法@Path("/sayHelloByGET") //调用的时候要加入此路径，精确指定调用的函数@Produces("text/html") // 输出参数的类型public String sayHelloByGET(@QueryParam("from")String fromValue, //客户端传来的参数key为"from"@Context HttpServletRequest request) {System.out.println(fromValue);return map.get(fromValue);}1.2 调用1.1get服务的客户端package com.client;import javax.ws.rs.core.*;import com.sun.jersey.api.client.*;import com.sun.jersey.core.util.*;public class JerseyClientGet {//基础的服务url 包含工程名+服务类的@pathString url ="http://localhost:8080/RestfulDemo/HelloWorldRS";public static void main(String[] args) {new JerseyClientGet().go();}public void go() {Client client = Client.create();// /sayHelloByGET为某精确函数的@pathWebResource webResource = client.resource(url+"/sayHelloByGET");// 设定要帶的参数MultivaluedMap queryParams = new MultivaluedMapImpl();queryParams.add("from", "3"); //from是个key，服务端要根据"from"获得"3",类似map//调用@GET服务时使用如下方法String str =webResource.queryParams(queryParams).get(String.class); System.out.println(str);}}如果调用服务端的函数是@GET，则要用上述红颜色的.get方法2 @POST2.1服务端package ;import java.util.ArrayList;import java.util.List;import javax.servlet.http.HttpServletRequest;import javax.ws.rs.DELETE;import javax.ws.rs.GET;import javax.ws.rs.POST;import javax.ws.rs.Path;import javax.ws.rs.Produces;import javax.ws.rs.QueryParam;import javax.ws.rs.core.Context;@Path("/HelloWorldRS") // 本服务的访问路径，与工程路径组合使用public class HelloWorldRS {M ap<String,String> map = new HashMap<String,String>();p ublic HelloWorldRS() {map.put("1","A");map.put("2","B");map.put("3","C");}@POST //表明是一个POST方法@Path("/sayHelloByPOST") //调用的时候要加入此路径，精确指定调用的函数@Produces("text/html") // 输出参数的类型public String sayHelloByPOST (@QueryParam("from")String fromValue, //客户端post传来的参数key为"from"@Context HttpServletRequest request) {System.out.println(fromValue);return map.get(fromValue);}2.2调用2.1post服务的客户端package com.client;import javax.ws.rs.core.*;import com.sun.jersey.api.client.*;import com.sun.jersey.core.util.*;public class JerseyClientGet {//基础的服务url 包含工程名+服务类的@pathprivate String url ="http://localhost:8080/RestfulDemo/HelloWorldRS";public static void main(String[] args) {new JerseyClientGet().go();}public void go() {Client client = Client.create();//POSTWebResource webResource = client.resource(url+"/sayHelloByPOST"); MultivaluedMap queryParams = new MultivaluedMapImpl();queryParams.add("from", "2");String resp = webResource.queryParams(queryParams).post(String.class, queryParams);System.out.println(resp);}}3@DELETE3.1服务端package ;import java.util.ArrayList;import java.util.List;import javax.servlet.http.HttpServletRequest;import javax.ws.rs.DELETE;import javax.ws.rs.GET;import javax.ws.rs.POST;import javax.ws.rs.Path;import javax.ws.rs.Produces;import javax.ws.rs.QueryParam;import javax.ws.rs.core.Context;@Path("/HelloWorldRS") // 本服务的访问路径，与工程路径组合使用public class HelloWorldRS {M ap<String,String> map = new HashMap<String,String>();p ublic HelloWorldRS() {map.put("1","A");map.put("2","B");map.put("3","C");}@DELETE //表明是一个delete方法@Path("/delSomePor") //调用的时候要加入此路径，精确指定调用的函数@Produces("text/html") // 输出参数的类型public String delSomePor (@QueryParam("from")String fromValue, //客户端delete传来的参数key为"from" @Context HttpServletRequest request) {System.out.println(fromValue);map.remove(fromValue);return String.valueOf(map.size());}3.2调用3.1delete服务的客户端package com.client;import javax.ws.rs.core.*;import com.sun.jersey.api.client.*;import com.sun.jersey.core.util.*;public class JerseyClientGet {//基础的服务url 包含工程名+服务类的@pathprivate String url ="http://localhost:8080/RestfulDemo/HelloWorldRS";public static void main(String[] args) {new JerseyClientGet().go();}public void go() {Client client = Client.create();//DELETEWebResource webResource = client.resource(url+"/delSomePor"); MultivaluedMap queryParams = new MultivaluedMapImpl();queryParams.add("from", "2");String str =webResource.queryParams(queryParams).delete((String.class));System.out.println(str);}}四、Spring+Hibernate与jersey结合Spring+hiberate数据库oracle服务器tomcat6.0开发工具MyEclipse8.51创建Java Web工程,命名为RestSpringDemo2 导入jar包并将所依赖的Jar包放入工程的WebRoot\WEB-INF\lib目录下面，主要是Spring相关Jar 包、Jersey相关Jar包，其他依赖包自行加入。