REST是REpresentational State Transfer的缩写（一般中文翻译为表述性状态转移）。2000年Roy Fielding博士在他的博士论文《体系结构与基于网络的软件设计》中提出了REST。

REST是一种体系结构, 而HTTP是一种包含了REST架构属性的协议。

 

• 在REST中使用统一接口处理资源。与数据库CRUD操作（Create、Read、Update 和 Delete）一样，可以用POST、GET、PUT和DELETE处理REST资源。
• REST支持不同的通信数据格式，比如XML、JSON。

RESTful Web Services因其简单性被广泛使用，它比SOAP要更简单。本文将重点介绍如何使用Jersey框架创建RESTful Web Services。Jersey框架实现了JAX-RS接口。本文示例代码使用Eclipse和Java SE 6编写。

RESTfulWS ，然后创建RESTful Web Service服务端

• •  

    • 从下载Jersey。示例代码使用的是Jersey 1.17.1。首先解压Jersey到“jersey-archive-1.17.1”文件夹。接着将里面lib文件夹下的jar文件拷贝到工程目录的WEB-INF -> lib。然后将它们添加到build path。

    1. jersey-client-1.17.1.jar
    2. jersey-server-1.17.1.jar
    3. jsr311-api-1.1.1.jar

    • 在工程Java Resources -> src中创建“com.eviac.blog.restws”包，并在其中创建“UserInfo”类。
    UserInfo.java

     

    package com.eviac.blog.restws;
    import javax.ws.rs.GET;
    import javax.ws.rs.Path;
    import javax.ws.rs.PathParam;
    import javax.ws.rs.Produces;
    import javax.ws.rs.core.MediaType;
    /**
     *
     * @author pavithra
     *
     */
    
    // 这里@Path定义了类的层次路径。
    // 指定了资源类提供服务的URI路径。
    @Path("UserInfoService")
    public class UserInfo {
        // @GET表示方法会处理HTTP GET请求
        @GET
        // 这里@Path定义了类的层次路径。指定了资源类提供服务的URI路径。
        @Path("/name/{i}")
        // @Produces定义了资源类方法会生成的媒体类型。
        @Produces(MediaType.TEXT_XML)
        // @PathParam向@Path定义的表达式注入URI参数值。
        public String userName(@PathParam("i")
        String i) {
            String name = i;
            return "<User>" + "<Name>" + name + "</Name>" + "</User>";
        }
    
        @GET
        @Path("/age/{j}")
        @Produces(MediaType.TEXT_XML)
        public String userAge(@PathParam("j")
        int j) {
            int age = j;
            return "<User>" + "<Age>" + age + "</Age>" + "</User>";
        }
    }

    xml version="1.0" encoding="UTF-8"?>  
  • <web-app id="WebApp_ID" version="2.5"  
  •     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/javaee">  
  •     <a href="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">  
  •         http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"  
  •     </a>  
  •   
  •     <display-name>RESTfulWS</display-name>  
  •     <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>com.eviac.blog.restws</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>  

• 1. 输出结果如下：

      

     

      

      

  2. 首先创建一个独立新项目：
  3. 这里同样需要Jersey框架的lib目录下的jar包。解压Jersey到“jersey-archive-1.17.1”文件夹，接着将里面lib文件夹下的jar文件拷贝到工程目录的WEB-INF -> lib或者将它们添加到build path。

1. jersey-client-1.17.1.jar
2. jersey-server-1.17.1.jar
3. jsr311-api-1.1.1.jar

 

• •   
  • import javax.ws.rs.core.MediaType;  
  •   
  • import com.sun.jersey.api.client.Client;  
  • import com.sun.jersey.api.client.ClientResponse;  
  • import com.sun.jersey.api.client.WebResource;  
  • import com.sun.jersey.api.client.config.ClientConfig;  
  • import com.sun.jersey.api.client.config.DefaultClientConfig;  
  •   
  • /** 
  •  *  
  •  * @author pavithra 
  •  *  
  •  */  
  • public class UserInfoClient {  
  •   
  •     public static final String BASE_URI = "http://localhost:8080/RESTfulWS";  
  •     public static final String PATH_NAME = "/UserInfoService/name/";  
  •     public static final String PATH_AGE = "/UserInfoService/age/";  
  •   
  •     public static void main(String[] args) {  
  •   
  •         String name = "Pavithra";  
  •         int age = 25;  
  •   
  •         ClientConfig config = new DefaultClientConfig();  
  •         Client client = Client.create(config);  
  •         WebResource resource = client.resource(BASE_URI);  
  •   
  •         WebResource nameResource = resource.path("rest").path(PATH_NAME + name);  
  •         System.out.println("Client Response \n"  
  •                 + getClientResponse(nameResource));  
  •         System.out.println("Response \n" + getResponse(nameResource) + "\n\n");  
  •   
  •         WebResource ageResource = resource.path("rest").path(PATH_AGE + age);  
  •         System.out.println("Client Response \n"  
  •                 + getClientResponse(ageResource));  
  •         System.out.println("Response \n" + getResponse(ageResource));  
  •     }  
  •   
  •     /** 
  •      * 返回客户端请求。 例如： GET 
  •      * http://localhost:8080/RESTfulWS/rest/UserInfoService/name/Pavithra 
  •      * 返回请求结果状态“200 OK”。 
  •      *  
  •      * @param service 
  •      * @return 
  •      */  
  •     private static String getClientResponse(WebResource resource) {  
  •         return resource.accept(MediaType.TEXT_XML).get(ClientResponse.class)  
  •                 .toString();  
  •     }  
  •   
  •     /** 
  •      * 返回请求结果XML 例如：<User><Name>Pavithra</Name></User> 
  •      *  
  •      * @param service 
  •      * @return 
  •      */  
  •     private static String getResponse(WebResource resource) {  
  •         return resource.accept(MediaType.TEXT_XML).get(String.class);  
  •     }  
  • }  
    • GET http://localhost:8080/RESTfulWS/rest/UserInfoService/name/Pavithra returned a response status of 200 OK  
    • Response   
    • <User><Name>Pavithra</Name></User>  
    •    
    • Client Response   
    • GET http://localhost:8080/RESTfulWS/rest/UserInfoService/age/25 returned a response status of 200 OK  
    • Response   
    • <User><Age>25</Age></User>  
    • 
      eviacImportNew.com 陈洁
      译文链接：