在Apache Tomcat部署Web service的步骤

在Apache Tomcat部署Web service的步骤

江岳霖 (vincent@ilab.el.cycu.edu.tw)
中原大學網際網路實驗室

工具和安裝

構建第一個 Web service的第一步是選擇一個工具集。將使用的工具有:

  • Apache SOAP -- SOAP 的這個開放源碼 Java 實現包括對 SOAP 1.1 規範有用的子集的支援,並與現有的 Web service很好地集成。請至http://xml.apache.org/soap/index.html下載soap-bin-2.0.zip。


  • Apache Jakarta Tomcat -- Java Web 伺服器還實現了主機 Apache SOAP 2.0 所需的 Java servlets 2.2 API 規範。請至http://www.apache.org/dist/jakarta/jakarta-tomcat-4.0/release/v4.0.3/下載Apache Jakarta Tomcat 4.0。


  • Apache Xerces XML Parser 1.2.3 --該開放源碼 XML 語法分析器實現大多數最新 XML 規範,並由 Apache SOAP 2.0 使用。請至http://xml.apache.org/xerces-j/下載Xerces-J-bin-1.2.3.zip。
倘若將每個安裝檔案解壓縮到根目錄,應該得到如下所示的目錄結構。


/
/jakarta-tomcat-4.0
/lib - contains webserver.jar, servlet.jar, jasper.jar, parser.jar, jaxp.jar
/soap-2_0
/lib - contains soap.jar
/xerces-1_2_3 - contains xerces.jar



接下來要做的是將 Xerces 和 SOAP .jar 檔添加到類路徑,確保 xerces.jar 在前面。如果不這樣做,則 Apache SOAP 可能會發現錯誤的 XML .jar 文件,從而無法正確工作。筆者在自己的系統上將以下兩項添加到類路徑中:

C:/xerces-1_2_3/xerces.jar
C:/soap-2_0/lib/soap.jar

最後,必須通過編輯 /jakarta-tomcat-4.0/conf/server.xml 並在檔中現有項之後附加下所示的 <Context> 項來配置 Tomcat,以便它自動檢測 Apache SOAP 子系統。將 docBase 屬性設置成指向 Apache SOAP webapps/soap 子目錄的完整路徑。


<Context
  path="/soap"
  docBase="C:/soap-2_0/webapps/soap"
  reloadable="true">
 </Context>



現在我們已準備好開始構建第一個 Web service應用。

 

 

啟動 Web 伺服器

在開始編寫自己的 Web service之前,讓我們啟動 Tomcat 並啟動 SOAP 歡迎頁面。至開始功能表點選strat Tomcat這將啟動在本地主機埠 8080 上運行的 Tomcat Web 伺服器。

應該看到如下圖的螢幕:

在Apache Tomcat部署Web service的步骤

然後啟動 Web 流覽器並輸入 URL http://127.0.0.1:8080/soap。這將啟動在編輯 Tomcat server.xml 檔時安裝到 /soap 的 Apache SOAP。如果這些都正確,您將看到如下圖中打開的頁面

在Apache Tomcat部署Web service的步骤

此時,關閉流覽器並停止 Tomcat。將在編寫了 Web service並準備部署之後再次重新啟動它們。

 

 

下載 Web service範例

筆者已編寫一個簡單的Hello Web Service 服務程式,我們可下載範例壓縮檔HelloWebService.zip,將其解開後放至於/webapps之中後,開啟啟動 Tomcat。

 

 

部署 Web service

要部署 Hello Web Service 服務。然後在流覽器中輸入 URL 啟動 Web 流覽器並輸入 URL http://127.0.0.1:8080/HelloWebService/。然後在看到歡迎螢幕時單擊 Run the adminclient。應該看到如下圖的螢幕。

在Apache Tomcat部署Web service的步骤

該螢幕顯示一些允許我們部署、取消部署和列出 Tomcat/SOAP 系統中駐有服務的選項。如果單擊 List 選項,將看到沒有要開始的服務。要部署Hello Web Service服務,單擊 Deploy 選項並如下圖所示填充欄位。

在Apache Tomcat部署Web service的步骤

以下是 Deploy 螢幕中每個欄位的解釋:

  • ID:Web service標識。在本例中,我們將服務標識設置成 http://tempuri.org/HelloWebService
  • Scope:服務的啟動方式。Request 表示每一個請求都創建一個新的服務實例。其他可用的方式是 Session 和 Application。 在本例中,我們將服務的啟動方式設為Session。
  • Methods:要在 Web service中顯示的由空格定界的方法列表。請注意,這好象暗示 Web service無法顯示兩個同名方法,但 SOAP 規範並不禁止這樣做。 在本例中,我們的Methods是get。
  • Provider:Web service的類型。Apache/SOAP 目前只支持 Java 類和 Bean 腳本,但以後的版本將肯定支持 EJB 和其他流行的元件類型。 在本例中,我們的將Web service的類型設為Java。
  • Provider Class/Static:Java 類別的名稱。必須通過類路徑設置獲得該類。如果 Static 為真,則假定方法為 Java 類上的靜態方法,否則將它們作為實例方法處理。 在本例中,我們將Java 類別的名稱設為HelloWebService,Static 設為false。
其他欄位與 Apache/SOAP 平臺的專有載入項 (add-on) 相關,本文不再贅述。

輸入這些欄位之後,向下滾動並單擊視窗底部的 Deploy 按鈕。應該看到一個螢幕表明已經部署了服務。如果單擊 List 按鈕,則將看到列出的 Web service的 URN。單擊其鏈結,應該看到如下圖的訊息。

在Apache Tomcat部署Web service的步骤

如上述所言,部署過程非常簡單明瞭。有關當前部署的服務的所有資訊都被 Tomcat/SOAP 存儲到當前目錄中名為 DeployedServices.ds 的文件中。請耐心嘗試並閱讀它 -- 它包含一個序列化的 Java 散列表!

 

 

測試 Web service範例

在流覽器中輸入 URL 啟動 Web 流覽器並輸入 URL http://localhost:8080/HelloWebService/sample/HelloWebService/TestClient.jsp 。應該看到如下圖的螢幕。

在Apache Tomcat部署Web service的步骤

在這裡,我們點選「Methods」裡面get的鏈結,會在「Inputs」頁面出現「Invoke」以及「Clear」這兩個按鈕,按下「Invoke」按鈕之後,便會去呼叫我們建置好的Web Service,並且取得Hello Web Service。如圖下所示:

在Apache Tomcat部署Web service的步骤

恭喜!我们刚刚構建並运行了第一个 Web service应用。現在开始真正享受乐趣吧!