web 服務是分布式應用程序組件，它們符合一定的標準，因而可供外部使用。分布式環境的激增對企業提出了新的要求，企業必須能夠通過開放式網絡將某個應用程序的全部或部分功能向其他應用程序公開。使用 web 服務，可以解決獨立開發并在各種不同軟件和硬件平臺上運行的應用程序的集成問題。

　netbeans ide 4.1 與基于 jsr-109 的 web 服務支持捆綁在一起，jsr-109 是一種開發范例，它適用于基于 jax-rpc (jsr-101) 的 j2ee 開發。netbeans ide 4.1 中的 web 服務功能是端到端 j2ee 功能集的一部分。在 netbeans ide 4.1 中使用 web 服務要比在 netbeans ide 4.0 中使用容易得多。例如，netbeans ide 4.1 提供了創建 web 服務和 web 服務客戶機的向導。　

　在本教程中，將創建一個包含以下內容之一的 j2ee 應用程序:　

　web 應用程序(使用 servlet 公開的服務)

　ejb 模塊(使用會話 bean 公開的服務)　

　請注意，您必須選擇要生成這兩個方案中的哪一個?？梢允褂帽窘坛虅摻?web 應用程序或 ejb 模塊?！?

　本教程介紹了以下主題:

　設置環境

　開發 web 服務

　公開 web 服務

　使用 web 服務

　包裝應用程序

　設置環境

　在開始編寫代碼之前，您必須確保安裝了所需的所有軟件并且正確設置了服務器。

　安裝軟件　

　在開始安裝之前，需要在計算機中安裝以下軟件:　

　· netbeans ide 4.1(下載)　

　· sun java system (sjs) application server platform edition 8 2005q1(下載)　

　· java standard development kit (jdktm) 1.4.2 版(下載)或 5.0 版(下載)

　注冊 sun java system application server　

　在編譯 web 服務之前，必須先注冊 sjs application server 的本地實例。如果安裝了 netbeans ide 4.1/sjs application server 包，則會自動注冊本地應用服務器?！?

　1. 從主窗口中選擇“工具”>“服務器管理器”?！?

　2. 單擊“添加服務器”。選擇 "sun java systems application server 8.1"，并為此實例指定一個名稱。然后單擊“下一步”?！?

　3. 指定服務器信息、應用服務器本地實例的位置以及要部署的域?！?

　開發 web 服務　

　對 web 服務進行編碼非常容易。ide 會處理所有實現細節，因此您可以集中精力對 web 服務的業務邏輯進行編碼。　

　創建項目　

　1. 決定是將 web 服務作為 web 應用程序實現，還是作為會話 bean 實現?！?

　2. 選擇“文件”>“新建項目”(ctrl-shift-n)，然后執行以下操作之一:　

　o 在“類別”下選擇 "web"。在“項目”下選擇“web 應用程序”。單擊“下一步”?！?

　o 在“類別”下選擇“企業”。在“項目”下選擇“enterprise javabeans 模塊”。單擊“下一步”。　

　3. 將項目命名為 hiws，將“項目文件夾”更改為計算機中的任意文件夾，并確保在“服務器”下拉列表中選擇了 "sun java system application server"。單擊“完成”。　

　創建 web 服務　

　1. 右鍵單擊項目節點，然后選擇“新建”>“web 服務”。將 web 服務命名為 hiws，在“包”字段中鍵入 org.me.hi，然后單擊“完成”。將在源編輯器中打開一個名為 hiwsimpl.java 的實現類(在 web 應用程序中)，或者打開一個名為 hiwsbean.java 的會話 bean(在 ejb 模塊中)。　

　2. 在“項目”窗口中，展開“web 服務”節點，右鍵單擊 hiws web 服務節點，然后選擇“添加操作”。在“名稱”字段中鍵入 sayhi，然后在“類型”組合框中選擇“字符串”。單擊“添加”，定義一個名為 s 的 java.lang.string 型參數。單擊“確定”創建操作框架?！?

　3. 展開“源包”節點和 org.me.hi 節點。雙擊 hiwssei.java 節點，可以注意到已經在接口類中聲明了操作?！?

　4. 在源編輯器中，將操作框架填寫到實現類或會話 bean 中。要執行此操作，請在 sayhi 操作的主體中將 "return null;" 替換為以下代碼:　

　5. return "hi " + s + "!";　

　6. 現在代碼應如下所示:　

　package org.me.hi;

　public class hiwsimpl implements hiwssei {

　public string sayhi(java.lang.string s) {

　return "hi " + s + "!";

　}

　}

　生成和配置 soap 消息處理程序　

　1. 右鍵單擊項目節點并選擇“新建”>“文件/文件夾”。在“類別”下選擇“web 服務”。在“文件類型”下選擇“消息處理程序”。單擊“下一步”。

　2. 將消息處理程序命名為 hiwslogger，在“包”下拉列表中選擇 org.me.hi，然后單擊“完成”。將創建一個名為 hiwslogger.java 的實現類，并在源編輯器中將其打開。

　3. 在 handlerequest 方法中，請注意按如下方式定義要記錄的消息:

　4. stringbuffer message = new stringbuffer();

　5. while (childelems.hasnext()) {

　6. child = (soapelement) childelems.next();

　7. message.append(new date().tostring() + "--");

　8. formlogmessage(child, message);

　9. }

　10.

　11. system.out.println("message: " + message.tostring());

　12.

　13. 在“項目”窗口中，展開“web 服務”節點，右鍵單擊該 web 服務的節點，然后選擇“配置處理程序”。在“配置 soap 消息處理程序”對話框中，單擊“添加”，然后瀏覽到 hiwslogger 類。單擊“確定”。　

　將在對話框中列出消息處理程序類?！?

　單擊“確定”完成 soap 消息處理程序的配置。

　公開 web 服務　

　在公開 web 服務時，可以使其供客戶機使用。可以使用 ide 作為客戶機，以便在部署后對其進行測試?！?

　部署 web 服務　

　根據 web 服務的實現方式，請執行以下操作之一:

　· 對于作為 web 應用程序實現的 web 服務，請執行以下操作:　

　1. 在“項目”窗口中右鍵單擊 hiws 項目節點，然后選擇“屬性”。在“項目屬性”對話框中，選擇“運行”窗格。在“上下文路徑”文本框和“相對 url”文本框中均鍵入 /hiws。單擊“確定”?！?

　2. 在“項目”窗口中右鍵單擊 hiws 項目，然后選擇“運行項目”?！?

　這將啟動符合 j2ee 的服務器并部署 web 服務。在 ide 的缺省瀏覽器中應該會顯示一條類似于以下內容的消息:　

　invalid wsdl request http://localhost:8080/hiws/hiws for web service hiws

　· 對于作為會話 bean 實現的 web 服務，請在“項目”窗口中右鍵單擊 hiws 項目，然后選擇“部署項目”。這將啟動符合 j2ee 的服務器并部署 web 服務?！?

　請注意，必須將 web 服務保持部署狀態，以便在下一部分中創建 web 服務客戶機。　

　注冊和測試 web 服務　

　1. 在“項目”窗口中，展開“web 服務”節點，右鍵單擊 hiws web 服務節點，然后選擇“添加到注冊表”。　

　您可能會收到一條類似于以下內容的錯誤消息:

　unable to add web service to registry. make sure it has been deployed,

　the server is running, and the correct wsdl url was entered.　

　如果收到此錯誤消息，請確保已經部署了 web 服務，然后再次選擇“添加到注冊表”。　

　將出現一個對話框，其中推薦了可用于注冊 web 服務的 url。　

　2. 記下該 url，因為稍后在創建 web 服務客戶機時需要使用它。單擊“確定”。

　

　3. 在“運行環境”窗口中，展開“web 服務”節點，然后繼續展開節點，直至找到 sayhi 節點。右鍵單擊 sayhi 節點，然后選擇“測試操作”。在“測試 web 服務操作”對話框的“值”文本框中鍵入 "john"，然后單擊“提交”。將在對話框底部顯示結果 "hi john!"?！?

　4. 展開“服務器”節點，右鍵單擊 sun java system application server 8.1 節點，然后選擇“查看服務器日志”。將會顯示 server.log 文件，其中包括一條類似于以下內容的消息:　

　5. message: wed jan 12 16:56:48 cest 2005--sayhi string_1:john |#]

　這是由上一部分中創建的 soap 消息處理程序生成的日志消息?！?

　在對操作進行測試之后，如果您對該 web 服務感到滿意，則可以將其功能集成到 web 服務客戶機中。　

　使用 web 服務　

　使用 web 服務是指客戶機在使用 web 服務時所執行的操作。使用 ide 可以很容易地設置客戶機，以使其使用 web 服務?？梢允褂孟驅韺朊枋?web 服務接口的 wsdl 文件。然后，可以將其集成到客戶機中，以使該 web 服務完成一些有用的工作?！?

　創建 web 應用程序項目　

　· 選擇“文件”>“新建項目”(ctrl-shift-n)。在“類別”下選擇 "web"。在“項目”下選擇“web 應用程序”。將項目命名為 hiwsclient，將“項目文件夾”更改為計算機中的任意文件夾，并確保在“服務器”下拉列表中選擇了 "sun java system application server"。單擊“完成”?！?

　搜索有關 web 服務的信息　

　1. 右鍵單擊項目節點，然后選擇“新建”>“web 服務客戶機”。復制正在運行的 web 服務的 url，并將其粘貼到 wsdl url 文本框中，然后單擊“檢索 wsdl”。如果“本地文件名”文本框中填寫了 wsdl 文件名，則說明已經正確檢索到了 wsdl 文件。在“包”字段中鍵入 org.me.hi，然后單擊“完成”。　

　2. 展開“web 服務引用”節點，然后繼續展開節點，直至找到 sayhi 節點。右鍵單擊 sayhi 節點，然后選擇“測試操作”。在“測試 web 服務操作”對話框的“值”文本框中鍵入 "john"，然后單擊“提交”。將在對話框底部顯示結果 "hi john!"。在對操作進行測試之后，如果您對公開的 web 服務感到滿意，則可以創建一個客戶機來使用它?！?

　3. 右鍵單擊 hiwsclient 項目節點，然后選擇“新建”> "servlet"。將 web 服務命名為 hiservlet，在“包”字段中鍵入 org.me.hi，單擊“下一步”，然后單擊“完成”。將在源編輯器中打開 servlet hiservlet.java?！?

　創建 web 服務客戶機　

　1. 在源編輯器中，在 hiservlet 類的 processrequest 操作中單擊鼠標右鍵。選擇“web 服務客戶機資源”>“調用 web 服務操作”，選擇 sayhi 操作，然后單擊“確定”。剪切并粘貼框架操作，將其放在 out.close(); 行的上方。

　2. 現在可以填寫框架操作，使其如下所示：

　3.　　try {

　4.　　　　out.println(gethiwsseiport().sayhi("ludwig"));

　5.　　} catch(java.rmi.remoteexception ex) {

　6.　　　　out.println("

caught an exception

" + ex);

　7.　　}

　8.　（可選）如果您希望用戶能夠與 web 服務進行交互，請將上述代碼刪除，并在 processrequest 方法的 標記之間添加以下代碼：

　out.println("<p>enter your name:　");　out.println("<form method=/"get/">");　out.println("<input type=/"text/" name=/"name/" size=/"25/">");　out.println("<br>");　out.println("<p>");　out.println("<input type=/"submit/" value=/"submit/">");　out.println("</form>");　string name = request.getparameter("name");　if ( name != null ) {　try {　out.println(gethiwsseiport().sayhi(name));　} catch(java.rmi.remoteexception ex) {　out.println("<p>caught an exception <p>" + ex);　}　}

　包裝應用程序　

　(可選)可以在 ear 文件中包裝應用程序并對其進行部署?；蛘?，也可以單獨部署 web 服務和 web 服務客戶機?！?

　創建 j2ee 應用程序項目　

　1. 選擇“文件”>“新建項目”(ctrl-shift-n)。在“類別”下選擇“企業”。在“項目”下選擇“空的企業應用程序”。將項目命名為 hiapp，然后將“項目文件夾”更改為計算機中的任意文件夾。單擊“完成”?！?

　2. 展開 hiapp 項目節點，然后右鍵單擊“j2ee 模塊”節點。選擇“添加 j2ee 模塊”。選擇 "hiwsclient" 并單擊“確定”。然后重復此步驟并選擇 "hiws"?！?

　部署 j2ee 應用程序　

　1. 在“項目”窗口中右鍵單擊 hiapp 項目節點，然后選擇“屬性”。在“項目屬性”對話框中，選擇“執行”。確保在“客戶機模塊 uri”文本框中填寫了 hiwsclient.war。在“相對 url”文本框中鍵入 /hiservlet。單擊“確定”?！?

　2. 在“項目”窗口中右鍵單擊 hiapp 項目，然后選擇“運行項目”?！?

　您可能會收到一條類似于以下內容的錯誤消息:　

　deploying application in domain failed; cannot deploy. application already exists.　

　please select the redeploy option. ; requested operation cannot be completed　

　如果收到此錯誤消息，請在“運行環境”窗口的“服務器注冊”節點中展開 sun java system application server 8 節點。然后展開“應用程序”節點，再展開“企業應用程序”節點和“web 應用程序”節點。如果列出了 hiapp、hiws 或 hwsclient，則需要將其卸下。右鍵單擊這些節點，然后選擇“卸下”。在“項目”窗口中，再次運行 hiapp 項目?！?

　將啟動符合 j2ee 的服務器，對應用程序進行部署，并在 ide 的缺省 web 瀏覽器中顯示部署結果。

　　3. 如果在應用程序中添加了用戶接口(如前一部分所述)，請輸入一個名稱，然后單擊“提交”。客戶機將使用 web 服務中的 "hi" 和 "!" 字符串，在其中插入您所輸入的名稱，并在瀏覽器中顯示問候語。如果未添加用戶接口，瀏覽器將顯示消息 "hi ludwig!"。