使用Java建立RESTful Web Service(轉)

REST是REpresentational State Transfer的縮寫（通常中文翻譯爲表述性狀態轉移）。2000年Roy Fielding博士在他的博士論文「Architectural Styles and the Design of Network-based Software Architectures」《體系結構與基於網絡的軟件架構設計》中提出了REST。

REST是一種體系結構。而HTTP是一種包含了REST架構屬性的協議。

REST基礎概念

• 在REST中全部東西都被看做資源。每個資源都有一個URI和它對應。
• 在REST中使用統一接口處理資源。與數據庫CRUD操做（Create、Read、Update 和 Delete）同樣，能夠用POST、GET、PUT和DELETE處理REST資源。
• 每一個REST請求都是孤立的，請求中包含了所需的所有信息。REST服務端不存儲狀態。
• REST支持不一樣的通訊數據格式，好比XML、JSON。

RESTful Web Services

RESTful Web Services因其簡單性被普遍使用，它比SOAP要更簡單。本文將重點介紹如何使用Jersey框架建立RESTful Web Services。Jersey框架實現了JAX-RS接口。本文示例代碼使用Eclipse和Java SE 6編寫。

建立RESTful Web Service服務端

• 在Eclipse中建立一個「dynamic web project」（動態web工程） ，項目名設爲 「RESTfulWS」。

 

• 從這裏下載Jersey。示例代碼使用的是Jersey 1.17.1。首先解壓Jersey到「jersey-archive-1.17.1」文件夾。接着將裏面lib文件夾下的jar文件拷貝到工程目錄的WEB-INF -> lib。而後將它們添加到build path。

1. asm-3.1.jar
2. jersey-client-1.17.1.jar
3. jersey-core-1.17.1.jar
4. jersey-server-1.17.1.jar
5. jersey-servlet-1.17.1.jar
6. jsr311-api-1.1.1.jar

• 在工程Java Resources -> src中建立「com.eviac.blog.restws」包，並在其中建立「UserInfo」類。最後把web.xml拷貝到WEB-INF目錄下。

 

UserInfo.java

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41

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>" ; } }

web.xml

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

<? 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/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 > id="WebApp_ID" version="2.5"> < 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 >

• 將此URL拷貝到瀏覽器地址欄中運行：

1. http://localhost:8080/RESTfulWS/rest/UserInfoService/name/Pavithra

輸出結果以下：

建立客戶端

建立一個「com.eviac.blog.restclient」包，而後新建「UserInfoClient」類。

UserInfoClient.java

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66

package com.eviac.blog.restclient;   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 ); } }

• 運行客戶端程序後，能夠看到如下輸出：

1 2 3 4 5 6 7 8 9

Client Response 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 >

試試吧 ：）

http://www.importnew.com/7336.html