1、-. z本教程向您展示了如何通過一個 Java 類創立并部署 Apache A*is2 Web 效勞。您也可以學習如何設置與 NetBeans IDE 綁定的 Tomcat 和 GlassFish 效勞器，以部署 A*is2 Web 效勞。本教程還展示了如何在 IDE 中配置 A*is2 選項，以便 IDE 正確部署 A*is2 Web 效勞。Apache A*is 是向 W3C 提交的 SOAPSimple Object-Access Protocol，簡單對象協議實現。Apache A*is2 是一種更加高效、模塊化和面向 *ML 的 A*is。A*is2 不僅支持 SOAP 1.1 和

2、SOAP 1.2，它還集成了對 REST 風格的 Web 效勞的支持。同一業務邏輯實現可以同時提供一個 WS-* 樣式的類型接口以及一個 REST/PO* 樣式的接口。有關 A*is2 的詳細信息，請參見 A 。A*is2 Web 效勞可與 Metro 進展互操作。您可以為 A*is2 Web 效勞創立一個 JA*-WS 客戶端，但是可能不支持一些更加復雜的 A*is2 WSDL 操作。 目錄 HYPERLINK ://kb/docs/websvc/gs-a*is_zh_.html l setup#setup 設置 A*is2 和 NetBeans I

3、DE HYPERLINK ://kb/docs/websvc/gs-a*is_zh_.html l install_apache#install_apache 下載 Apache A*is2 WAR 文件 HYPERLINK ://kb/docs/websvc/gs-a*is_zh_.html l install_plugin#install_plugin 安裝 A*is2 支持插件 HYPERLINK ://kb/docs/websvc/gs-a*is_zh_.html l a*is_options_tomcat#a*i

4、s_options_tomcat 設置 Tomcat 的 A*is2 選項 HYPERLINK ://kb/docs/websvc/gs-a*is_zh_.html l a*is_options_glassfish#a*is_options_glassfish 設置 GlassFish 的 A*is2 選項 HYPERLINK ://kb/docs/websvc/gs-a*is_zh_.html l java_project#java_project 創立 A*is2 Web 效勞 HYPERLINK ://kb/docs

5、/websvc/gs-a*is_zh_.html l deploy_a*is#deploy_a*is 部署和測試 A*is2 Web 效勞 HYPERLINK ://kb/docs/websvc/gs-a*is_zh_.html l changing_operations#changing_operations 更改 Web 效勞的操作 HYPERLINK ://kb/docs/websvc/gs-a*is_zh_.html l troubleshooting#troubleshooting 疑難解答 HYPERLINK :/netbeans.o

6、rg/kb/docs/websvc/gs-a*is_zh_.html l more_e*ercises#more_e*ercises 更多練習 要學習本教程，您需要具備以下軟件和資源。軟件或資源要求的版本NetBeans IDE6.1 版 Web 和 Java EE 下載包或6.5 版 Java Web 下載包Java Development Kit (JDK)版本 6 或版本 5Apache A*is 2版本 1.3 或更高版本，WAR 分發軟件符合 Java EE 標準的 Web 效勞器或應用效勞器Tomcat Web Server 6.0 和/或GlassFish 應用效勞器 v2 或

7、v3 Tomcat 和 GlassFish 都可以隨同 NetBeans IDE 的 Java Web 分發軟件一起安裝。此外，也可以 GlassFish 下載頁或 Apache Tomcat 下載頁。設置 A*is2 和 NetBeans IDE在本節，您將學習如何下載 A*is2 WAR 文件，如何將它嵌入在 Apache Tomcat 或 GlassFish 效勞器中，以及如何配置 NetBeans IDE 以將 AAR 文件上載到效勞器。下載 Apache A*is2 WAR 文件可以在此下載 Apache A*is2。下載 WARWeb 歸檔分發軟件，這樣您就不必自己生成 WAR 文

8、件了。該下載文件是歸檔文件的形式。稍后將該歸檔解壓縮到效勞器。安裝 A*is2 支持插件本教程需要 NetBeans IDE 的 A*is2 支持插件。在 IDE 中，進入工具菜單下的插件管理器，檢查已安裝標簽下是否已經安裝了 A*is2 Support 插件。如果已經安裝，請檢查更新標簽中是否有更新。如果未安裝 A*is2 Support，請從可用插件標簽中進展安裝，如下所示：設置 Tomcat 的 A*is2 選項A*is 效勞在 Tomcat 上比在 GlassFish 上運行得快，但是設置略微復雜一些。通過將效勞部署到一個效勞器，然后更改 A*is2 選項，最后部署到另一個效勞器，您可

9、以輕松將同一個效勞部署到 Tomcat 和 GlassFish。 如果您想要部署到 GlassFish 而不是 Tomcat，請轉至 HYPERLINK ://kb/docs/websvc/gs-a*is_zh_.html l a*is_options_glassfish#a*is_options_glassfish 設置 GlassFish 的 A*is2 選項。 要設置 Tomcat 的 A*is2 選項，請執行以下操作：將包含 a*is2.war 的已下載歸檔文件解壓縮到 Tomcat CATALINA_BASE/webapps 目錄。如果您不知道您的 CATAL

10、INA_BASE 在什么地方，請啟動 IDE 并翻開效勞標簽。展開效勞器節點。右鍵單擊 Tomcat 6.0.* 節點，并從上下文菜單中選擇屬性。在連接標簽中可以看到Catalina 基目錄位置。 如果沒有 CATALINA_BASE，則說明您以前未運行過 Tomcat。啟動并停頓 Tomcat，此時將會生成 CATALINA_BASE。啟動或重新啟動 Tomcat 效勞器。Tomcat 會將 a*is2.war 文件解壓縮到 CATALINA_BASE/webapps 中的 a*is2 文件夾。 從 IDE 中的頂部菜單欄中，選擇工具選項。此時將翻開選項對話框。 單擊 A*is2 圖標。將翻

11、開 A*is2 部署選項頁。 將 A*is2 AAR 文件的目標位置設置為您的 CATALINA_BASE不是 TOMCAT_HOME/webapps/a*is2 目錄。 確保 A*is2 URL 字段包含正確的 Tomcat 效勞器端口號。要檢查端口號，請啟動 Tomcat從效勞標簽或者從工具-效勞器，查看 Coyote /1.1 使用的是哪個端口。 為了方便起見，選擇使用 Tomcat 管理器進展部署。此功能意味著 IDE 將在后臺啟動 Tomcat 管理器，并且在您每次更改 a*is2.war 時，都對 a*is2.war 運行 reload 命令。如果您未選擇使用 Tomcat 管理器

12、進展部署，則每次您更改 a*is2.war 后，您將不得不手動運行 Tomcat 管理器或使用其他 Tomcat 工具來重新加載。 缺省 Tomcat 管理器用戶名和口令并不固定。可以在 HYPERLINK ://kb/docs/websvc/gs-a*is_zh_.html l copy_war#copy_war Tomcat 效勞器的屬性頁找到此信息。要再次核查 Tomcat 管理器是否已部署并具有缺省的管理器角色用戶名和口令，請翻開 CATALINA_BASE/conf/tomcat-users.*ml。應該定義管理員角色，并且應該給它分配用戶名和密碼，如在以下文

13、件版本中一樣。如果必要的話，您可以復制并粘貼此文件。 設置 GlassFish 的 A*is2 選項可以將 A*is2 Web 效勞部署到 GlassFish 應用效勞器。通過將效勞部署到一個效勞器，然后更改 A*is2 選項，最后部署到另一個效勞器，您可以輕松將同一個效勞部署到 Tomcat 和 GlassFish。如果您想要部署到 Tomcat 而不是 GlassFish，請轉至 HYPERLINK ://kb/docs/websvc/gs-a*is_zh_.html l a*is_options_tomcat#a*is_options_tomcat 設置 Tomc

14、at 的 A*is2 選項。 要設置 Glassfish 的 A*is2 選項，請執行以下操作：將包含 a*is2.war 的已下載歸檔文件解壓縮到 GLASSFISH_HOME/domains/DOMAIN_NAME/autodeploy 目錄。要找到 GLASSFISH_HOME 以及域名稱，請啟動 IDE 并翻開效勞標簽。展開效勞器節點。右鍵單擊 GlassFish V2 或 V3 節點，并從上下文菜單中選擇屬性。在連接標簽中可以看到域文件夾位置和域名。例如，從下列圖中，您可以知道如何將 a*is2.war 復制到 G:glassfish-v2ur2domainsdomain1autod

15、eploy。 啟動 IDE。從頂部的菜單欄選擇工具-選項。此時將翻開選項對話框。 單擊 A*is2 圖標。將翻開 A*is2 部署選項頁。 將 A*is2 AAR 文件的目標位置設置為解壓縮到 GlassFish autodeploy 目錄的 a*is2.war 文件。 通過將 a*is2.war 放置在 autodeploy 中，可以使 GlassFish 在您每次修改 a*is2.war 文件后都自動重新部署它。但是，在 GlassFish v3 Prelude 上，不能在效勞器正在運行時重新部署 WAR 文件。確保 A*is2 URL 字段包含正確的 GlassFish 效勞器端口號。要

16、檢查端口號，請啟動 GlassFish效勞標簽或者工具-效勞器，查看 /1.1 使用哪個 80* 端口。缺省端口號為 8080。在下列圖中，正確的端口號為 8081因為另一個效勞器已經在使用 8080。 注意：如果使用的是 Windows Vista，GlassFish 安裝到了 Program Files，且啟用了用戶控制，您將無法從 IDE 中更改 a*is2.war 文件。將 GlassFish 安裝到其他位置或者禁用 UAC。開發 A*is2 Web 效勞在本節，您將使用 NetBeans IDE 來創立、部署、測試和修改 A*is2 Web 效勞。創立 A*is2 Web 效勞借助

17、NetBeans IDE，您可以從一個 Java 類創立 A*is2 Web 效勞。這只能從 Java 應用程序或 Java 庫工程實現。在本教程中，您將創立一個 Java 庫工程因為您不需要主方法，在該工程中創立一個 A*is2 Web 效勞同時創立 Java 類，并將該 A*is2 Web 效勞部署到效勞器。只能通過 Java 或 Java 庫工程創立 A*is2 Web 效勞。這是因為 a*is.aar 文件Web 效勞和 A*is 配置文件壓縮到的可部署歸檔既不是 WAR 文件，也不是 EAR 文件，而且也不能像 Web (EAR) 應用程序一樣正常部署。 要創立 A*is2 Web

18、效勞，請執行以下操作：單擊新建工程圖標或者文件-新建工程。將翻開新建工程向導。從 Java 類別下選擇一個 Java 類庫工程。單擊下一步。 將工程命名為 A*isHello。檢查是否使用的是您想要的工程文件夾名和位置。是否共享該工程取決于您。單擊完成，則 IDE 會創立工程。 右鍵單擊工程節點。則翻開上下文菜單。在上下文菜單中，選擇新建-其他。翻開新建文件向導。從Web 效勞類別下，選擇基于 Java 的 A*is2 效勞并單擊下一步。 現在新建文件向導的效勞類型選擇頁翻開。工程中沒有任何 Java 類，所以選擇創立空 Web 效勞。如果已經編寫了一個 Java 類代碼，則您應該選擇從現有

19、Java 類創立 Web 效勞。如果您想要編輯 Web 效勞的 WSDL，例如添加或更改名稱空間，您應該選擇從 Java 源代碼生成 WSDL。編輯 WSDL 不在本教程的范圍之內，所以不要選該選項。向導應如下列圖所示。 單擊下一步。將翻開名稱和位置頁。將該 Java 類命名為 HelloA*isWorld。將包命名為 a*ishello。讓生成樣例方法保持選中。這會在 Java 類中生成一個返回 Hello, World. 的方法。 單擊完成。IDE 會在 a*ishello 源包中生成一個 HelloA*isWorld.java 類和反映此 Java 類的 HelloA*isWorld A

20、*is2 Web 效勞。您可以看到 Java 類和 A*is2 Web 效勞都有一個 hello:String 操作，分別作為 A*is2 Web 效勞的一個節點顯示在導航標簽中。 部署和測試 A*is2 Web 效勞創立 A*is2 Web 效勞后，您需要將其部署到效勞器。實際上，部署到效勞器包括兩個步驟： 將 A*is Web 效勞復制到效勞器使用的 a*is2.war 文件。這一步在效勞器離線時也可以完成。 將最新的 a*is2.war 文件重新部署到效勞器。 如果您在啟用使用 Tomcat 管理器進展部署選項的情況下部署到 Tomcat請參見 HYPERLINK :/netbeans.

21、org/kb/docs/websvc/gs-a*is_zh_.html l a*is_options_tomcat#a*is_options_tomcat 設置 Tomcat 的 A*is2 選項，或者部署到 GlassFish 且 a*is2.war 位于 GLASSFISH_DOMAIN/autodeploy 文件夾請參見 HYPERLINK ://kb/docs/websvc/gs-a*is_zh_.html l a*is_options_glassfish#a*is_options_glassfish 設置 GlassFish 的 A*is2 選項，則更新的 a*is2.war 會自動重新部署到效勞器。否則，您必須使用應用程序效勞器工具手動重新部署 a*is2.war。在本教程中，我們假設您已經設置了 A*is2 選項，這樣重新部署可自動進