使用開發RESTWeb服務來放大您的Web應用程序。在本教程示例中,您將創建一個簡單的Web服務來維護客戶列表。你將學會:
- 用于開發REST Web服務的過程
- 部署到MyEclipse Tomcat服務器
- 使用REST Web服務資源管理器進行測試
沒有MyEclipse?
1.從REST Web服務項目開始
REST Web服務項目向導使您能夠開始項目配置。
- 單擊工具欄上的New圖標MyEclipse REST Web Service上的下拉箭頭,并從菜單中選擇Web Service Project。
- 在Project Name字段中輸入restdemo,選擇REST(JAX-RS)框架選項,然后單擊Next。
注意:本教程使用JavaEE 6版本;但是,在創建新項目時,JavaEE 7是可用的選項。
創建Web服務項目
- 接受默認的源文件夾,然后單擊Next。
- 單擊Finish以接受本示例的默認值。
完成項目
2.創建新的REST Web服務
有了項目,就可以創建Web服務了。您將創建管理客戶實體所需的類和資源方法的類。
2.1創建客戶實體
這個簡單的Customer類包含id、name和地址字段,并且表示使用Web服務管理的Customer實體。
- 右鍵單擊restdemo項目,并選擇New>Class。
- 在Package字段中鍵入com.myeclipseide.ws,在Name字段中鍵入Customer,如果選中則取消選擇Public Static Void Main復選框,并單擊Finish。
創建Java類
- 用下面的代碼替換生成的類的默認內容,并保存文件。
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服務的核心
- 右鍵單擊restdemo項目,并選擇New>Other。
- 在過濾器字段中輸入Web服務,選擇Web服務,然后單擊Next
創建新的Web服務
- 從Java類選項中選擇“Create web service”,選擇“Create new Java bean”復選框,然后單擊“Next”。
創建新的Web服務
- 在URL路徑字段中鍵入客戶,選擇Stutelon生命周期選項,從產品下拉中選擇Apple /XML,鍵入JavaSpand字段中的COM.MycliestId.WSN,并在Java類字段中鍵入CuulsRes資源。
Web服務配置詳細說明URL路徑:指示可以到達此資源的路徑。對于本教程,資源將托管在“/customer”。
Singleton Lifecycle:確保每個web應用程序僅由Jersey創建該類的一個實例。
Consumes and Produces:可用于指定該資源可以接受和生成的數據的默認mime類型。這些值可以由類中的單個方法覆蓋。如上所述,您正在序列化XML,因此您使用application/xml mime類型。
- 單擊Add按鈕添加獲取客戶列表的方法。
- 在返回類型字段中,在方法名稱字段java.util.List<Customer>中鍵入getCustomers,然后單擊“Finish”。
添加methodHTTP方法:在本例中,可以用來指定該方法響應的HTTP請求的類型。
Method Signature preview:在對頁面進行更改時更新,讓您了解生成的方法的外觀。
- 再次單擊Add按鈕以添加返回特定客戶的詳細信息的方法。
- 在方法名稱字段中輸入getCustomer,在返回類型字段中輸入Customer,在URL路徑字段中輸入{id}。
添加第二種方法
- 單擊Add按鈕添加Method參數。在Java類型字段中鍵入int,在Java名稱字段中鍵入CID,從PARAM類型下拉中選擇PathParam,并在PARAM名稱字段中鍵入ID。單擊Finish。
addingmethodparametersURLPath:指定相對于包含的資源可以到達此方法的路徑。
在本例中,您指定{id},這意味著可以在/customer/{id}處到達此資源方法。花括號表示URI變量。這些變量在運行時替換為資源,以響應基于替換URI的請求。
參數:直接在表中編輯參數。因為需要id變量的值,所以使用PathParam注釋將其映射到cId參數。
- 添加允許向列表中添加新客戶的方法。填入如下所示的字段,然后單擊Finish。
在本例中,您正在響應POST請求并期望應用程序/xml輸入,該輸入將被反序列化為客戶參數。customerparameter是一個Entity參數(未注明),并且直接從傳入請求的消息主體映射。您還可以重寫CustomersResource類指定的默認應用程序/xml輸出,并指定text/html。
在添加這三個方法之后,配置應該如下所示:
最終Web服務配置
- 單擊Finish生成CustomersResource類。打開該文件以查看截斷的資源方法。
更多資訊敬請訪問
標簽:
Java開發工具MyEclipse
本站文章除注明轉載外,均為本站原創或翻譯。歡迎任何形式的轉載,但請務必注明出處、不得修改原文相關鏈接,如果存在內容上的異議請郵件反饋至chenjj@fc6vip.cn
文章轉載自:慧都控件網