用MyEclipse開發RESTWeb服務來放大您的Web應用程序。在本教程示例中，您將創建一個簡單的Web服務來維護客戶列表。你將學會：

• 用于開發REST Web服務的過程
• 部署到MyEclipse Tomcat服務器
• 使用REST Web服務資源管理器進行測試

沒有MyEclipse？ 立即下載

1.從REST Web服務項目開始

REST Web服務項目向導使您能夠開始項目配置。

1. 單擊工具欄上的New圖標MyEclipse REST Web Service上的下拉箭頭，并從菜單中選擇Web Service Project。
2. 在Project Name字段中輸入restdemo，選擇REST（JAX-RS）框架選項，然后單擊Next。
3. 注意：本教程使用JavaEE 6版本；但是，在創建新項目時，JavaEE 7是可用的選項。

1. 
   
2. 創建Web服務項目
3. 接受默認的源文件夾，然后單擊Next。
4. 單擊Finish以接受本示例的默認值。

1. 
   
2. 完成項目

2.創建新的REST Web服務

有了項目，就可以創建Web服務了。您將創建管理客戶實體所需的類和資源方法的類。

2.1創建客戶實體

這個簡單的Customer類包含id、name和地址字段，并且表示使用Web服務管理的Customer實體。

1. 右鍵單擊restdemo項目，并選擇New>Class。
2. 在Package字段中鍵入com.myeclipseide.ws，在Name字段中鍵入Customer，如果選中則取消選擇Public Static Void Main復選框，并單擊Finish。

1. 
   
2. 創建Java類
3. 用下面的代碼替換生成的類的默認內容，并保存文件。

package com.myeclipseide.ws;
 import javax.xml.bind.annotation.XmlRootElement;
@XmlRootElement
 public class Customer {
 private int id;
 private String name;
 private String address;
 public int getId() {
 return id;
 }
 public void setId(int id) {
 this.id=id;
 }
 public String getName() {
 return name;
 }
 public void setName(String name) {
 this.name=name;
 }
 public String getAddress() {
 return address;
 }
 public void setAddress(String address) {
 this.address=address;
 }
}

您使用XML作為序列化格式，即使用XML從Web服務發送和接收客戶實體。

Customer類中的@ XMLROOTE元素注釋是一個JAXB注釋，允許JAXB將這個實體從Java轉換為XML并返回。可以對類中的字段和方法進行注釋以定制序列化，但是對于本教程，JAXB默認設置是可以的。

2.2創建資源類，即Web服務的核心

1. 右鍵單擊restdemo項目，并選擇New>Other。
2. 在過濾器字段中輸入Web服務，選擇Web服務，然后單擊Next

1. 
   
2. 創建新的Web服務
3. 從Java類選項中選擇“Create web service”，選擇“Create new Java bean”復選框，然后單擊“Next”。

1. 
   
2. 創建新的Web服務
3. 在URL路徑字段中鍵入客戶，選擇Stutelon生命周期選項，從產品下拉中選擇Apple /XML，鍵入JavaSpand字段中的COM.MycliestId.WSN，并在Java類字段中鍵入CuulsRes資源。

1. 
   
2. Web服務配置詳細說明URL路徑：指示可以到達此資源的路徑。對于本教程，資源將托管在“/customer”。
3. Singleton Lifecycle：確保每個web應用程序僅由Jersey創建該類的一個實例。
4. Consumes and Produces：可用于指定該資源可以接受和生成的數據的默認mime類型。這些值可以由類中的單個方法覆蓋。如上所述，您正在序列化XML，因此您使用application/xml mime類型。
5. 單擊Add按鈕添加獲取客戶列表的方法。
6. 在返回類型字段中，在方法名稱字段java.util.List<Customer>中鍵入getCustomers，然后單擊“Finish”。

1. 
   
2. 添加methodHTTP方法：在本例中，可以用來指定該方法響應的HTTP請求的類型。
3. Method Signature preview：在對頁面進行更改時更新，讓您了解生成的方法的外觀。
4. 再次單擊Add按鈕以添加返回特定客戶的詳細信息的方法。
5. 在方法名稱字段中輸入getCustomer，在返回類型字段中輸入Customer，在URL路徑字段中輸入{id}。

1. 
   
2. 添加第二種方法
3. 單擊Add按鈕添加Method參數。在Java類型字段中鍵入int，在Java名稱字段中鍵入CID，從PARAM類型下拉中選擇PathParam，并在PARAM名稱字段中鍵入ID。單擊Finish。

1. 
   
2. addingmethodparametersURLPath：指定相對于包含的資源可以到達此方法的路徑。
3. 在本例中，您指定{id}，這意味著可以在/customer/{id}處到達此資源方法?；ɡㄌ柋硎綰RI變量。這些變量在運行時替換為資源，以響應基于替換URI的請求。
4. 參數：直接在表中編輯參數。因為需要id變量的值，所以使用PathParam注釋將其映射到cId參數。
5. 添加允許向列表中添加新客戶的方法。填入如下所示的字段，然后單擊Finish。

1. 
   
2. 在本例中，您正在響應POST請求并期望應用程序/xml輸入，該輸入將被反序列化為客戶參數。customerparameter是一個Entity參數（未注明），并且直接從傳入請求的消息主體映射。您還可以重寫CustomersResource類指定的默認應用程序/xml輸出，并指定text/html。
3. 在添加這三個方法之后，配置應該如下所示：

1. 
   
2. 最終Web服務配置
3. 單擊Finish生成CustomersResource類。打開該文件以查看截斷的資源方法。

3.為用戶生成的方法提供實現

現在，您需要為您使用向導創建的方法提供實現。在真實的應用程序中，此時您可能使用JPA或Hibernate連接數據庫，以幫助管理客戶列表，但是對于本教程來說，簡單的內存映射就足夠了。

實現很簡單；當服務接收到客戶時，您給實體一個基于計數器的id，并將其添加到映射。通過id從這個映射中檢索客戶并提供客戶列表非常簡單，如下所示。

使用以下代碼替換CustomersResource類中的內容。注意類和方法簽名沒有改變。您正在用服務的實現充實生成的存根。為了演示的目的，您還向列表中添加了一個客戶。

package com.myeclipseide.ws;
import java.util.ArrayList;
import java.util.List;
import java.util.TreeMap;
import javax.ws.rs.Consumes;
import javax.ws.rs.GET;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import com.sun.jersey.spi.resource.Singleton;
@Produces("application/xml")
@Path("customers")
@Singleton
 public class CustomersResource {
private TreeMap<Integer, Customer> customerMap=new TreeMap<Integer, Customer>();
public CustomersResource() {
 // hardcode a single customer into the database for demonstration
 // purposes
 Customer customer=new Customer();
 customer.setName("Harold Abernathy");
 customer.setAddress("Sheffield, UK");
 addCustomer(customer);
 }
@GET
 public List<Customer> getCustomers() {
 List<Customer> customers=new ArrayList<Customer>();
 customers.addAll(customerMap.values());
 return customers;
 }
@GET
 @Path("{id}")
 public Customer getCustomer(@PathParam("id") int cId) {
 return customerMap.get(cId);
 }
@POST
 @Path("add")
 @Produces("text/plain")
 @Consumes("application/xml")
 public String addCustomer(Customer customer) {
 int id=customerMap.size();
 customer.setId(id);
 customerMap.put(id, customer);
 return "Customer " + customer.getName() + " added with Id " + id;
 }
 }

4.部署Web服務應用程序

部署Web服務的最快的方法是使用Run As或Debug As MyEclipse Server Application操作。

1. 右鍵單擊項目，然后選擇Debug As（或Run As）>MyEclipse Server Application。

1. 
   
2. 部署和運行項目
3. 選擇MyEclipse Tomcat，然后單擊Finish。
4. 選擇要部署的服務器

MyEclipse執行以下步驟：

• 打包Web服務項目并將其以爆炸格式部署到應用服務器
• 啟動應用服務器并加載項目

MyEclipse Web Browser打開Web服務應用程序的默認index.jsp頁面。您不需要它，因為您沒有測試網頁，所以可以關閉此視圖。

5.使用REST Web服務資源管理器進行測試

REST Web服務資源管理器在MyEclipse標準訂閱級別不可用。如果您是MyEclipse標準訂戶，請按照使用標準瀏覽器測試Web服務的說明操作。

1. 右鍵單擊restdemo項目，并選擇MyEclipse>Test with REST Web Services Explorer。

1. 
   
2. 打開REST Web Services ExplorerNote：如果將restdemo部署到MyEclipse Tomcat之外的應用服務器，則資源管理器中使用的WADL URL可能包含不正確的端口，從而阻止資源管理器加載WADL文件。更正端口，然后單擊Go按鈕繼續。
3. 還可以通過單擊工具欄上的Web Services Explorer圖標MyEclipse REST Web Service上的下拉箭頭，并選擇Launch REST Web Services Explorer，打開REST Web Services Explorer。在這種情況下，在繼續之前，必須在地址欄中輸入WADL文件的路徑。
4. 將該樹展開到{id}節點，并選擇getCustomer方法。

1. 
   
2. 選擇要測試的方法
3. 單擊測試方法。將打開一個新選項卡，您可以在其中輸入信息并運行測試。

1. 
   
2. 用于測試方法的getCustomer選項卡
3. 在id字段中鍵入0，然后單擊Run Test圖標MyEclipse REST Web Service。

1. 
   
2. 檢索列表中的一個客戶
3. 關閉getCustomer選項卡。
4. 展開樹中的add，選擇addCustomer方法，然后單擊Test method。
5. 在Body中，鍵入addCustomer選項卡的application/xml區域，粘貼以下代碼，然后單擊按鈕。

<customer> 
 <name>Bill Adama</name> 
 <address>Vancouver, Canada</address> 
</customer> 

1. 回應形式，Customer Bill Adama added with Id 1.

1. 
   
2. 測試添加函數
3. 關閉addCustomer選項卡。
4. 在customers節點中選擇getCustomers，然后單擊Test method。
5. 單擊MyEclipse REST Web服務。列表中的兩個客戶由服務以XML形式返回。

1. 
   
2. 檢索整個客戶列表

更多資訊敬請訪問MyEclipse中文網>>