空間站

這里說明Resource如何處理GET，POST，PUT和DELETE方法。
1.引言
2.示例程序
3.實現(xiàn)Items Resource
4.實現(xiàn)Item Resource
5.實現(xiàn)Base Resource
6.運行應用
7.客戶端應用
8.總結

1.      引言
在開始開發(fā)前，我們需要簡單介紹一下Restlet框架的Resource概念。REST告訴我們，Resource根據(jù)URI進行辨認，同時能夠有一種或多種表現(xiàn)（也被稱作變量），用以響應方法調(diào)用。
在Restlet框架中，服務器連接器（server connectors）收到的調(diào)用最終由Resource的實例對象處理。一個Resource負責聲明支持的表現(xiàn)方式列表（Variant對象的實例）和實現(xiàn)你想要支持的REST方法。
 GET依賴可更改的“variants”列表和“getRepresentation(Variant)”方法。
 POST依賴“allowPost”方法和“post(Representation)”方法。
 DELETE依賴“allowPut”方法和“put(Representation)”方法。
DELETE依賴“allowDelete”方法和“delete()”方法。
還有，每一個到達的響應由一個專門的Resource實例處理，你不需要操心這些方法的線程安全問題。
我們假設你已經(jīng)讀過“第一步”，并且有了一些元件和應用的概念。

2.示例程序

一個Item列表用來管理創(chuàng)建，讀取，更新，和刪除活動，如一個典型的CRUD應用。一個Item包含名字和描述。在簡短的分析后，我們定義了兩個資源：
 Items Resource代表所有可用Item的集合。
 Item Resource代表一個單獨的item。
現(xiàn)在，讓我們定義用來標志item的Resource URIs。假設我們的應用運行在本機“localhost”并且監(jiān)聽8182端口：
http://localhost:8182/firstResource/items：“items”Resource URI。
http://localhost:8182/firstResource/items/{itemName}：“item”Resource URI，每個{itemName}代表一個Item的名字。
下一步，定義每個Resource允許訪問的方法列表。
 “items”Resource響應GET請求并以一個XML文檔展示當前注冊的所有Item列表。另外，Resource支持通過POST請求創(chuàng)建新的Item。提交的實體包含新的Item的名字和描述，這些是以格式化的Web表單方式提交的。如果Resource成功創(chuàng)建新Item，它返回一個“Success - resource created”狀態(tài)（HTTP 201狀態(tài)代碼）并且告訴客戶端新Resource在哪里可以找到（HTTP "Location" header）。否則，它返回一個“Client error”狀態(tài)（HTTP 404狀態(tài)代碼）和一個簡單的錯誤信息。
 “item”Resource響應GET請求并以一個XML文檔來展示該Resource的名字和描述。也可以通過PUT和DELETE請求更新和刪除Resource。
在描述兩個Resource對象前，首先編寫應用的代碼。為簡化起見，注冊的Item列表做為應用的一個屬性簡單地保存到內(nèi)存里，并不保存到一個真實的數(shù)據(jù)庫。不管怎樣，我們假設你想邀請你的朋友們同時測試這個應用。因為我們只有一個“FirstResourceApplication”實例在運行，所以不得不考慮線程安全。這也就是為什么你會發(fā)現(xiàn)Map對象Items是不不可更改的，它是一個ConcurrentHashMap對象的實例。

代碼：

01packagefirstResource;
02
03importjava.util.Map;
04importjava.util.concurrent.ConcurrentHashMap;
05
06importorg.restlet.Application;
07importorg.restlet.Context;
08importorg.restlet.Restlet;
09importorg.restlet.Router;
10
11publicclassFirstResourceApplicationextendsApplication {
12
13   /** The list of items is persisted in memory. */
14   privatefinalMap<String, Item> items;
15
16   publicFirstResourceApplication(Context parentContext) {
17      super(parentContext);
18      // We make sure that this attribute will support concurrent access.
19       items =newConcurrentHashMap<String, Item>();
20    }
21
22   /**
23    * Creates a root Restlet that will receive all incoming calls.
24    */
25    @Override
26   publicsynchronizedRestlet createRoot() {
27      // Create a router Restlet that defines routes.
28       Router router =newRouter(getContext());
29
30      // Defines a route for the resource "list of items"
31       router.attach("/items", ItemsResource.class);
32      // Defines a route for the resource "item"
33       router.attach("/items/{itemName}", ItemResource.class);
34
35      returnrouter;
36    }
37
38   /**
39    * Returns the list of registered items.
40    *
41    * @return the list of registered items.
42    */
43   publicMap<String, Item> getItems() {
44      returnitems;
45    }
46 }

2.      實現(xiàn)Items Resource
  讓我們開始編寫Items Resource。如上文所述，它允許GET和POST請求。POST請求支持實現(xiàn)“post(Representation)”方法賦予處理消息實體的權限。此外，資源通過“allowPost”方法來確定是否開啟POST支持。缺省情況下，資源是不可更改的，拒絕POST、PUT和DELETE方法并返回“Method not allowed”狀態(tài)（HTTP 405狀態(tài)代碼）。

同樣，通過實現(xiàn)“represent(Variant)”方法確定你可以接受GET請求并根據(jù)指定的Variant生成實體。在這個例子中，我們只生成“text/xml”這種形式。

代碼：

001packagefirstResource;
002
003importjava.io.IOException;
004importjava.util.Collection;
005
006importorg.restlet.Context;
007importorg.restlet.data.Form;
008importorg.restlet.data.MediaType;
009importorg.restlet.data.Request;
010importorg.restlet.data.Response;
011importorg.restlet.data.Status;
012importorg.restlet.resource.DomRepresentation;
013importorg.restlet.resource.Representation;
014importorg.restlet.resource.StringRepresentation;
015importorg.restlet.resource.Variant;
016importorg.w3c.dom.Document;
017importorg.w3c.dom.Element;
018
019/**
020* Resource that manages a list of items.
021*
022*/
023publicclassItemsResourceextendsBaseResource {
024
025   /** List of items. */
026    Collection<Item> items;
027
028   publicItemsResource(Context context, Request request, Response response) {
029      super(context, request, response);
030
031      // Get the items directly from the "persistence layer".
032       items = getItems().values();
033
034      // Declare the kind of representations supported by this resource.
035       getVariants().add(newVariant(MediaType.TEXT_XML));
036    }
037
038    @Override
039   publicbooleanallowPost() {
040      returntrue;
041    }
042
043   /**
044    * Returns a listing of all registered items.
045    */
046    @Override
047   publicRepresentation getRepresentation(Variant variant) {
048      // Generate the right representation according to its media type.
049      if(MediaType.TEXT_XML.equals(variant.getMediaType())) {
050         try{
051             DomRepresentation representation =newDomRepresentation(
052                   MediaType.TEXT_XML);
053            // Generate a DOM document representing the list of
054            // items.
055             Document d = representation.getDocument();
056             Element r = d.createElement("items");
057             d.appendChild(r);
058            for(Item item : items) {
059                Element eltItem = d.createElement("item");
060
061                Element eltName = d.createElement("name");
062                eltName.appendChild(d.createTextNode(item.getName()));
063                eltItem.appendChild(eltName);
064
065                Element eltDescription = d.createElement("description");
066                eltDescription.appendChild(d.createTextNode(item
067                      .getDescription()));
068                eltItem.appendChild(eltDescription);
069
070                r.appendChild(eltItem);
071             }
072             d.normalizeDocument();
073
074            // Returns the XML representation of this document.
075            returnrepresentation;
076          }catch(IOException e) {
077             e.printStackTrace();
078          }
079       }
080
081      returnnull;
082    }
083
084   /**
085    * Handle POST requests: create a new item.
086    */
087    @Override
088   publicvoidpost(Representation entity) {
089      // Parse the given representation and retrieve pairs of
090      // "name=value" tokens.
091       Form. form. =newForm(entity);
092       String itemName = form.getFirstValue("name");
093       String itemDescription = form.getFirstValue("description");
094
095      // Check that the item is not already registered.
096      if(getItems().containsKey(itemName)) {
097          generateErrorRepresentation(
098                "Item " + itemName + " already exists.", "1", getResponse());
099       }else{
100         // Register the new item
101          getItems().put(itemName,newItem(itemName, itemDescription));
102
103         // Set the response's status and entity
104          getResponse().setStatus(Status.SUCCESS_CREATED);
105          Representation rep =newStringRepresentation("Item created",
106                MediaType.TEXT_PLAIN);
107         // Indicates where is located the new resource.
108          rep.setIdentifier(getRequest().getResourceRef().getIdentifier()
109                + "/" + itemName);
110          getResponse().setEntity(rep);
111       }
112    }
113
114   /**
115    * Generate an XML representation of an error response.
116    *
117    * @param errorMessage
118    *            the error message.
119    * @param errorCode
120    *            the error code.
121    */
122   privatevoidgenerateErrorRepresentation(String errorMessage,
123          String errorCode, Response response) {
124      // This is an error