JAX-RPC Web 服務 |
|
|
![]() |
|
配置和執行 | Technotes | Javadoc | 使用 Ant 建置 | |
有關 Web 服務的討論,請參閱 InfoCenter 中的 IBM WebSphere Web services 文件。 |
|
AddressBook 範例會以各種方式示範 Web 服務存取。本範例含有兩個用戶端以及四個同一 AddressBook Bean 的變體。這兩個用戶端是 Java 2 Standard Edition (J2SE) 用戶端,和 Java 2 Enterprise Edition (J2EE) 用戶端。每一個用戶端都會採用四種部署到伺服器的 AddressBook Bean 的變體。 尋找程式碼您可以在 profile_root/samples/src/WebServicesSamples 的子目錄下,找到 AddressBook 範例的程式碼。 每一個 AddressBook 應用程式 Bean 的程式碼,都在下表所顯示的子目錄當中。簡式 J2SE 用戶端程式碼則是在 Clients/simpleClients/samples/address 目錄下。 J2EE Application Client 程式碼是在 Clients/applicationClients/AddressBookClient 下。 z/OS 客戶:z/OS 平台不提供範例的程式碼樹狀結構,因為範例應用程式不是在 z/OS 平台上建置的。 應用程式 Bean 的這四個變體,各代表不同的方法,來開發針對 Web 服務所啟用的應用程式。Enterprise JavaBeans (EJB) 有兩種,每一種都是用不同的方法加以建置。 其中一個方法是以 Web 服務定義語言 (WSDL) 檔開始建置 Web 服務 Bean, 並且使用 WSDL2Java 工具來產生 Java 程式碼或連結。 這個 EJB 的成品含有 "W2JE",可以區隔它們與其他版本。第二個 Enterprise Bean 是從實作的 EJB 開始建置,並且使用 Java2WSDL 工具來產生其 WSDL 檔。WSDL 檔的用途是產生部署描述子。這個 Enterprise Bean 的成品,將以 "J2WE" 指出。 同樣的,這兩個 JavaBean 的成品,也含有 "J2WB" 或 "W2JB" 字串,指出特定的方法。 下表將顯示這四個 AddressBook Bean 的命名方式。 | |
埠 | 目錄 | 實作類別 | 示範 |
---|---|---|---|
AddressBookW2JE | addrEJBTopDown | AddressBookSoapBindingImpl.java | 開發 Web 服務 Enterprise Bean 是從 WSDL 檔開始,並且利用 WSDL2Java 工具來產生 Enterprise Bean 的 Java 程式碼。 |
AddressBookJ2WE | addrEJBBottomUp | AddressBookBeanImpl.java | 開發 Web 服務 Enterprise Bean 是從其中一個 Bean 開始,並且利用 Java2WSDL 工具來產生 WSDL 檔,從這裡建立部署描述子。 |
AddressBookJ2WB | addrBeanBottomUp | AddressBookBean.java | 開發 Web 服務 JavaBean 是從其中一個 Bean 開始,並且利用 Java2WSDL 工具來產生 WSDL 檔,從這裡建立部署描述子。 |
AddressBookW2JB | addrBeanTopDown | AddressBookBean.java | 開發 Web 服務 JavaBean 是從 WSDL 開始,並且利用 WSDL2Java 工具來產生 Bean 的 Java 程式碼。 |
您可以在 profile_root/samples/src/WebServicesSamples 目錄下,找到表格中所指名的目錄。
AddressBook 服務的每一個實作,都支援 getAddressFromName 作業。作業會將靜態回應傳回用戶端。沒有任何資料庫儲存體可以儲存位址。 本範例的目的,是示範 Bean 和 Web 服務之間的關係。
所有版本的 AddressBook 服務,都在 WebServicesSamples.ear 檔中。專屬的根環境定義和 jar 名稱,都可以讓它們同時部署。此外,EJB 實作類別採專屬的命名方式,與 JavaBean 實作類別不同。這種專屬性可以確保伺服器中的類別載入器找到適當的實作類別。
本範例含有兩個用戶端,一個是 J2SE 用戶端,另一個是 J2EE 用戶端。每一個用戶端都會採用四種部署到伺服器的 AddressBook Bean 的變體。
這四個部署在伺服器的 Bean,其間的關係可以從用戶端 WSDL 檔看出,該檔是為了讓用戶端存取任何一個 Bean 而建立。WSDL 檔是以四個埠定義一個服務 AddressBookService。用戶端 AddressBook.wsdl 位於範例目錄 src/WebServicesSamples/Clients/applicationClients/META-INF 下。