此產品提供支援「服務元件架構 (SCA)」規格的範例檔。您可以在商業層次應用程式中使用這些範例 SCA 檔案。SCA 服務包裝成 Java 保存檔 (JAR),可當做資產匯入產品儲存庫中,再當做組合單元新增至商業層次應用程式。每一個範例的 readme.html 檔案包含詳細的部署指示。
使用前必備項目
WebSphere® Application Server 8.5 版
重要: Oasis 範例已在 WebSphere Application Server 8.5 版中經過測試。其他所有範例已在 WebSphere Application Server 8.0 版及 8.5 版中經過測試。
範例下載
如果要使用範例,請從產品下載網站下載 SCA 範例檔:
- 選擇下列其中一個方法將 SCA.zip 檔案下載至您工作站的目錄:FTP 或 HTTP。您可以在工作站建立 /samples/sca 目錄路徑,再將 SCA 範例檔下載至該目錄路徑。
- 從顯示的對話框中,指定用來儲存壓縮檔的目標目錄,然後按一下確定。
SCA.zip 壓縮檔包含的範例檔位於下列目錄結構中:
/CandyStore
/common
/HelloJee
/helloworld-ws-asynch
/helloworld-ws-asynch_Oasis
/installableApps
/installableApps_Oasis
/jms
/jms_Oasis
/jobbankejb
/jobbankejb_Oasis
/MultiService
/MultiService_Oasis
/MyBank
/MyBank_Oasis
readme.html
notices.txt
小心: readme.html 檔案包含安裝及執行範例的資訊。
您必須將 SCA 範例檔當做商業層次應用程式的資產部署到 8.5 版的伺服器或叢集,或部署到啟用 Feature Pack for SCA 的 7.0 版目標。/installableApps 目錄包含可當做資產來部署的預先建置保存檔。其他目錄包含範例相關的原始檔、Script 及指令,用於建置可部署的保存檔。
範例說明
- CandyStore(僅限 OSOA)
- CandyStore.jar 檔案使用預設連結、Web 服務連結及 EJB 連結,並顯示如何透過預設連結來使用遞迴模型及鑑別和授權。範例顯示由下而上(Java 至 WSDL)和由上而下(WSDL 至 Java)的 SCA 應用程式開發方法。
您可以部署 /installableApps 目錄中預先建置的 CandyStore.jar 檔案,或建置可部署的 JAR 檔。
如需 CandyStore 中的 10 個複合項目的說明及部署的詳細資料,請參閱 /CandyStore/documentation/readme.html。
- HelloJee(僅限 OSOA)
- 此範例顯示如何在 Java Platform Enterprise Edition (Java EE) 元件內使用 SCA 註釋,讓這些元件可以使用 SCA 服務。Java EE 應用程式可以採用 SCA 程式設計模型,只需要稍微變更應用程式實作程式碼,或根本不需要變更。範例使用 implementation.jee 定義將 Java EE 保存檔當做 SCA 元件實作。範例中有一個 Java EE 保存檔不含 SCA 構件,還有一個 Java EE 保存檔含定義 SCA 複合項目和元件的複合定義檔。這些元件使用 implementation.ejb 和 implementation.web 定義。
它示範如何將 EJB 服務公開為 SCA 服務,以及在 Stateless Session Bean 和 Servlet 中存取參照的注入值和內容註釋。
您可以部署 /installableApps 目錄中預先建置的 HelloJeeEar.ear、HelloJeeEnhancedEar.ear 及 HelloJeeSca.jar 檔案,或建置可部署的檔案。
如需部署的詳細資料,請參閱 /HelloJee/documentation/readme.html,或請參閱使用現有 Java EE 模組與元件當做 SCA 實作的相關主題。
- helloworld-ws-asynch (helloworld-ws-asynch_Oasis)
- 此範例使用 Web 服務和非同步轉換器服務。此範例有三個可部署的保存檔:用戶端 helloworld-ws-client-asynch.war,還有兩個 Web 服務:helloworld-ws-asynchclient.jar 和 helloworld-ws-asynch.jar。用戶端會使用 Java ServerPages (JSP) 檔案來取得 SCA 複合環境定義,並透過 SCA 預設連結來呼叫 HelloWorldClient 服務。接著,用戶端服務會透過 Web 服務連結來呼叫 HelloWorld 服務。呼叫服務之後,服務會回呼用戶端服務。用戶端 JSP 會等待 5 秒讓回呼完成,然後顯示回呼結果。
您可以部署 /installableApps 目錄中預先建置的 helloworld-ws-asynch.jar、helloworld-ws-client-asynch.war 及 helloworld-ws-asynchclient.jar 檔案,或建置可部署的檔案。
如需 JAR 檔的說明及部署的詳細資料,請參閱 /helloworld-ws-asynch/documentation/readme.html。如需在商業層次應用程式中部署 helloworld-ws-asynch.jar 檔案的詳細指示,請參閱資訊中心內的「範例:利用主控台來建立 SCA 商業層次應用程式」及「範例:利用 Scripting 來建立 SCA 商業層次應用程式」。
- JMS (JMS_Oasis)
- JMS 範例顯示如何使用「Java 訊息服務 (JMS)」用戶端來呼叫 SCA 元件服務。有三個 JMS 連結範例:
- TwoWay,提供雙向方法來傳回一個值
- TwoWay-OneWay,提供透過單向方法呼叫 LoggingService 的雙向方法,來將訊息記載到伺服器 SystemOut 檔案
- TwoWay-OneWay-Callback,提供單向方法來回呼 HelloServiceComponent POJO 元件
JMS 連結範例也隨附 POJO 元件和小型用戶端:
- HelloServiceComponent,簡易的 POJO 元件,可透過 JMS 服務連結來接收 JMS 訊息、執行 POJO 元件方法,然後將結果當做回應訊息傳回給呼叫端
- thinClient,非 SCA 的 JMS 用戶端,包裝在 jms-client.jar 檔案內,可將 JMS 訊息傳送至 JMS 訊息提供者,以呼叫 POJO HelloService SCA 服務
您可以部署 /installableApps 目錄中預先建置的 jms-callback-service.jar、jms-twoway-oneway-service.jar 及 jms-twoway-service.jar 檔案,或建置可部署的檔案。
如需建置 JMS 範例構件、建立範例的 JMS 資源及部署範例的詳細資料,請參閱 /jms/documentation/readme.html。
- JobbankTargetEJBApp (JobbankTargetEJBApp_Oasis)
- 此範例顯示 Java EE 用戶端 JobbankClientApp.ear 如何使用遠端 EJB 服務連結來呼叫 SCA 元件 jobbankejb.jar,以及具有 EJB 參照連結的元件如何呼叫 JobbankTargetEJBApp.ear 中的遠端外部 EJB。Stateless Session Bean 連結是一種通訊協定連結,能夠整合 SCA 與 EJB 型服務。SCA 支援在 jobbankejb.jar 中。
您可以部署 /installableApps 目錄中預先建置的 JobbankClientApp.ear、jobbankejb.jar 及 JobbankTargetEJBApp.ear 檔案,或建置可部署的檔案。
如需檔案的說明及部署的詳細資料,請參閱 /jobbankejb/documentation/readme.html。
- MultiService (MultiService_Oasis)
- 此範例顯示使用現有服務的服務組合。MultiService 範例會連接數個現有的範例:
- Stock Quote, WebServicesSamples.ear
- HelloWorldAsync, helloworld-ws-asynch.jar
- JobbankTargetEJBApp, JobbankTargetEJBApp.ear
- EJB Counter, EJB3CounterSample.ear
您可以部署 /installableApps 目錄中預先建置的 Multiservice.jar、MultiService.war、helloworld-ws-asynch.jar 及 JobbankTargetEJBApp.ear 檔案,或建置可部署的檔案。
您可以部署 /installableApps 目錄中預先建置的 WebServicesSamples.ear 和 EJB3CounterSample.ear 檔案。
範例中有一個選項可將 SCA 服務當做具有 SDO 資料連結的 OSGi 應用程式實作。
如需部署的詳細資料,請參閱 /MultiService/documentation/readme.html。
- MyBank (MyBank_Oasis)
- 此範例顯示如何遵循由上而下方法,建立一個使用 JAXB 的 SCA 應用程式。您可以使用 AccountService.wsdl 來產生 JAXB 類別,以提供 XML 與 Java 檔案之間的資料連結。然後在用戶端 WAR 檔上利用參照,透過 Web 服務連結來連接至「帳戶服務」。
也有一個選項可將 SCA 服務當做具有 SDO 資料連結的 OSGi 應用程式實作。
您可以部署 /installableApps 目錄中預先建置的 mybank-accountservice.jar 和 mybank-client.war 檔案,或建置可部署的檔案。
如需部署的詳細資料,請參閱 /MyBank/documentation/readme.html。