iweroulsdjf

有兩種方式訪問遷移向?qū)А．?dāng)您第一次打開 WebSphere Integration Developer 時(shí)，歡迎屏幕將顯示幾個(gè)圖標(biāo)。單擊綠色箭頭圖標(biāo)以啟動(dòng)遷移向?qū)В鐖D 1 所示。

提示：在使用遷移向?qū)r(shí)，關(guān)閉 Integration Developer 中的項(xiàng)目自動(dòng)構(gòu)建選項(xiàng)。請(qǐng)轉(zhuǎn)到 Main Menu -> Project，然后取消選擇 Build Automatically。如果您關(guān)閉該 AutoBuild 選項(xiàng)，請(qǐng)記住定期構(gòu)建整個(gè)項(xiàng)目或者重新啟用 AutoBuild 選項(xiàng)。

下一屏幕向您呈現(xiàn)了 3 個(gè)源遷移選項(xiàng)。單擊具有 5.1 和一個(gè)箭頭的圖標(biāo)，如圖 2 所示。

另一種方式是通過 File Import 選項(xiàng)瀏覽 Integration Developer。要啟動(dòng)遷移向?qū)В?qǐng)使用主菜單：

1. 轉(zhuǎn)到 File -> Import。
2. 從導(dǎo)入窗口中選擇 WebSphere Studio Application Developer Integration Edition Service Project，如圖 3 所示，然后單擊 Next。這將啟動(dòng)遷移向?qū)А?
   
   圖 3. 導(dǎo)入窗口
   
   
3. 單擊 Browse 按鈕，并轉(zhuǎn)到您解壓縮項(xiàng)目交換 zip 文件的臨時(shí)文件夾。
4. 突出顯示要導(dǎo)入的項(xiàng)目文件夾，并單擊 OK。在本例中，導(dǎo)入圖 4 中所示的 EmailService 項(xiàng)目。

   提示：該向?qū)軌蚩焖俚靥顚懰业降哪K名。如果它沒有填寫，請(qǐng)輸入項(xiàng)目的模塊名。我們建議您使用相同的原有項(xiàng)目名稱。

   
   圖 4. 指定源構(gòu)件
   
   
5. 單擊 Next 進(jìn)入設(shè)置遷移選項(xiàng)的屏幕。
6. 請(qǐng)確保選擇選項(xiàng)以在注釋中保留原有的 BPEL Java 代碼段。通過將它們包含在注釋塊中，保留所有現(xiàn)有的 Java 代碼段。單擊 Finish。
7. 遷移向?qū)?chuàng)建一個(gè)新的“業(yè)務(wù)集成模塊”項(xiàng)目，導(dǎo)入所有現(xiàn)有的 Application Developer 構(gòu)件，并轉(zhuǎn)換源構(gòu)件。您會(huì)看到具有一些消息的 Migration Results 屏幕。

   在本例中，您將看到 5 條信息消息。其中有 4 條信息表示：“The following java package is not being migrated because it contains generated classes that are no longer valid”。這些消息是安全無(wú)害的。Application Developer 已經(jīng)自動(dòng)生成 java 包以將應(yīng)用程序綁定到 Server Foundation 運(yùn)行時(shí)。新工具將生成新的綁定。單擊 OK。

   請(qǐng)注意：如果出現(xiàn)錯(cuò)誤，您可以突出顯示某一消息行，然后單擊 Generate ToDo’s 按鈕以在代碼中生成 TODO，這樣您可以稍后修復(fù)這些錯(cuò)誤。

   如果您關(guān)閉了 AutoBuild 選項(xiàng)，可以再次打開（Integration Developer Main Menu -> Project -> Build Automatically）。

使用遷移的資源

現(xiàn)在您將使用遷移的資源。

1. 請(qǐng)轉(zhuǎn)到 Integration Developer 中的 Business Integration 透視圖。在導(dǎo)航窗格中，通過雙擊名為 EmailService 的 Assembly Diagram 圖標(biāo)，，打開最新創(chuàng)建的 EmailService 項(xiàng)目。該項(xiàng)目將在 Assembly Editor 中打開。
2. 您將在畫布中看到一個(gè)名為 EmailBusinessProcess 的項(xiàng)。這是服務(wù)組件體系結(jié)構(gòu)（Service Component Architecture，SCA）組件，它的實(shí)現(xiàn)是在業(yè)務(wù)流程執(zhí)行語(yǔ)言（Business Process Execution Language，BPEL）中實(shí)現(xiàn)的電子郵件業(yè)務(wù)流程 (Email Business Process)。
   
   圖 5. 顯示一個(gè)業(yè)務(wù)流程組件的 Assembly Editor
   
   
3. Assembly Editor 左側(cè)是工具面板。您需要第二個(gè)工具箱中的 Stand-alone References 工具，該工具箱由一個(gè)框式藍(lán)色箭頭圖標(biāo)表示。單擊業(yè)務(wù)流程組件的左側(cè)，然后單擊工具并將其放在畫布中。如果需要空間，可以將業(yè)務(wù)流程組件拖到右側(cè)。
4. 在 Assembly Editor 工具面板中，單擊綠色細(xì)線圖標(biāo)，，然后單擊 Stand-alone References 組件，最后單擊 Business Process Component (EmailBusinessProcess)。
5. 彈出的消息將通知您“a matching reference will be created on the source node. Do you want to continue?”。不要選擇“Always create without prompt”框。單擊 OK。
6. Select Interface 窗口彈出，如圖 4 所示。您將看到可以創(chuàng)建引用的兩個(gè)接口，即 ProcessPortType 和 MailSMTP。請(qǐng)選擇 MailSMTP 并單擊 OK。
   
   圖 6. 接口選擇屏幕
   
   
7. 將提示您是否希望為 Stand-alone Reference 生成 Java 接口，而不是 Web 服務(wù)描述語(yǔ)言（Web Services Description Language，WSDL）接口。由于您要使用 JSP 和 Java 客戶機(jī)訪問流程，因此選擇 Yes。
8. 單擊 Ctrl-S 保存與圖 7 相似的組裝關(guān)系圖 (Assembly Diagram)。觀察每一個(gè)組件的細(xì)節(jié)以及 Properties 窗格的 Details 選項(xiàng)卡中的連接。
9. 請(qǐng)選擇 Stand-alone References Component。在 Properties 視圖中，記住 Details 窗格中的 Partner Reference 的名稱。在本例中，名稱為 MailSMTPPartner。在 Details 窗格中，您可以找到客戶機(jī)使用的自動(dòng)生成的 Java 接口的名稱。如圖 7 中所示，接口為 com.scb.process.email.mail.smtp.MailSMTP。
   
   圖 7. 顯示屬性窗格和兩個(gè)連接組件的組裝關(guān)系圖
   
   

   請(qǐng)注意：我們?yōu)槭裁聪驑I(yè)務(wù)流程組件提供獨(dú)立引用呢？獨(dú)立引用允許非 SCA 客戶機(jī)（如類似于 JSP 的 J2SE 或者 J2EE 客戶機(jī)）訪問 SCA 組件。如果您只計(jì)劃使用 BPC 資源管理器或者組件測(cè)試框架 (Component Test Framework) 調(diào)用流程，則不需要獨(dú)立引用，這是因?yàn)檫@些內(nèi)置工具使用 BPC 和 SCA API 直接調(diào)用流程。

10. 回到 Assembly Editor，選擇 EmailBusinessProcess 組件的引用連接器（由右側(cè)具有 1:1 的小框表示）。右鍵單擊該引用連接器，并從上下文菜單中選擇 Wire References to New -> Components。

    該操作將在 EmailBusinessProcess 組件的右側(cè)創(chuàng)建與接口 MailSMTP 同名的通用 SCA 組件。這會(huì)自動(dòng)將業(yè)務(wù)流程組件連接到新的通用組件。

11. 單擊 Ctrl-S 保存組裝關(guān)系圖。
12. 右鍵單擊 Generic Component MailSMTP，并從上下文菜單中選擇 Select Implementation -> Java。該通用組件變成 Java 組件。在 Pick Implementation 屏幕的 Select entries 字段中，開始鍵入 mailsm，直到看到名為 MailSMTP 的類為止。突出顯示這個(gè)類并單擊 OK。

    提示：Qualifier 字段顯示包的名稱，該名稱與包出現(xiàn)在原有的 Application Developer 服務(wù)項(xiàng)目中的名稱相同。這就是在開始遷移流程之前您必須了解服務(wù)項(xiàng)目的結(jié)構(gòu)的原因。

    由于這個(gè) Java 服務(wù)示例的輸入/輸出參數(shù)具有簡(jiǎn)單的類型（字符串和布爾型），因此 SCA 框架自動(dòng)等同于 SCA 組件公開的 WSDL 接口和 Java 類的接口。例如，在 EmailService 項(xiàng)目中比較 MailSMTP.wsdl 和 MailSMTP.java。轉(zhuǎn)到 Java 透視圖查看 Integration Developer 中的這些文件。

    如果您不確定 Java 接口是否與滿足 Java 要求的 SCA WSDL 兼容，請(qǐng)不要選擇 Select Implementation，而要選擇 Generate Implementation。將要求您具有可以生成類的包。向?qū)г诮M件公開的 WSDL 接口中生成與 SCA 兼容的 Java 接口。組件 MyComponent 的類名為 MyComponentImpl.java。

    現(xiàn)在，檢查每個(gè)方法的輸入?yún)?shù)的類型及其返回類型，以確保它們都匹配 Java 類的接口。如果它們不匹配，您有兩種選擇。第一種選擇涉及到修改原有 Java 類的接口。或者，可以將生成的骨架作為實(shí)現(xiàn)類并編寫自定義代碼，以在生成的 Java 骨架中調(diào)用每個(gè)方法的原有 Java 類。當(dāng)操作的輸入或者輸出類型很復(fù)雜時(shí)（例如，Customer 對(duì)象具有地址、姓名之類的子對(duì)象），通常會(huì)出現(xiàn)問題，因?yàn)樵?SCA 范例中，它們是以 commonj.sdo.DataObject 表示的。而在原有 Java 類中，參數(shù)是以 Java bean 表示的。

13. 通用 SCA 組件變成 Java 組件，業(yè)務(wù)流程組件與其連接。畫布與圖 8 類似。畫布中唯一的顯著變化是“J”，表示 MailSMTP 是一個(gè) Java 組件。
    圖 8. 顯示 3 個(gè)連接組件的組裝關(guān)系圖
    
    
14. 這就完成了。單擊 Ctrl-S 保存組裝關(guān)系圖并關(guān)閉 Assembly Editor。

下一步要遷移 Application Developer 項(xiàng)目交換文件中包含的 Web 項(xiàng)目。

遷移用于調(diào)用業(yè)務(wù)流程的 JSP

在 Application Developer 項(xiàng)目交換文件中，EmailServiceCustomWeb 項(xiàng)目包含 JSP (index.jsp)，它從用戶獲得 4 個(gè)參數(shù)并使用 Facade Enterprise Java Bean (EJB) 調(diào)用業(yè)務(wù)流程。該 Facade EJB 是在 Application Developer 中生成的，它包含在 EmailServiceEJB 項(xiàng)目中。

在 Integration Developer 中，沒有生成 Facade EJB 的捷徑，因?yàn)樗褂?SCA 編程模型中的新抽象層。因此，您必須遷移 index.jsp 以使用 SCA 編程模型，而這將調(diào)用業(yè)務(wù)流程。

1. 首先，從項(xiàng)目交換 zip 文件導(dǎo)入 EmailServiceCustomWeb 項(xiàng)目。在 Integration Developer 中，轉(zhuǎn)到 File -> Import -> Project Interchange。單擊 Next 并瀏覽到該 zip 文件。選擇圖 9 中所示的 EmailServiceCustomWeb 并單擊 Finish。
   
   圖 9. 項(xiàng)目導(dǎo)入屏幕
   
   

   許多在 Application Developer 中有效的環(huán)境變量在 Integration Developer 中不再使用，因此我們需要確定 Web 項(xiàng)目的類路徑。

2. 轉(zhuǎn)到 Java 透視圖，Window -> Open Perspective - > Other -> Java，并選擇 EmailServiceCustomWeb 項(xiàng)目。右鍵單擊并選擇 Properties。
3. 轉(zhuǎn)到 Java Build Path，在 Projects 選項(xiàng)卡中，刪除 EmailServiceEJBClient 上的依賴項(xiàng)。請(qǐng)確保 EmailService 上有一個(gè)依賴項(xiàng)，如圖 10 所示。
   
   圖 10. Java 構(gòu)建路徑上的項(xiàng)目
   
   
4. 在 Libraries 選項(xiàng)卡中，突出顯示所有條目并單擊 Remove，以從構(gòu)建路徑中刪除所有 JAR 和類文件夾。
5. 單擊 Add Library，突出顯示 JRE System Library，然后單擊 Next。在 Alternate JRE 字段中，使用下拉選擇器選擇 WPS Server v6.0 JRE。請(qǐng)不要 選擇 WebSphere v6 JRE。單擊 Finish。
6. 單擊 Add Library，突出顯示 WPS Server Target，然后單擊 Next。選擇“Configure wps server classpath”并單擊 Next。您的屬性屏幕將類似于圖 11。
   
   圖 11. Java 構(gòu)建路徑上的庫(kù)
   
   
7. 單擊 Project References。設(shè)置對(duì) EmailService 項(xiàng)目的引用（如圖 12 所示）并刪除所有其他引用。
   
   圖 12. 項(xiàng)目引用設(shè)置
   
   
8. 單擊 OK 保存新設(shè)置。這將清除所有錯(cuò)誤（除 index.jsp 中的 JSP 編譯錯(cuò)誤之外）。Application Developer v5.1 在 J2EE 1.3 級(jí)別。您可以將 Web 應(yīng)用程序遷移到 Integration Developer v6.0 中可用的 J2EE 1.4 級(jí)別。

   提示：只有在工作區(qū)啟用高級(jí) J2EE 功能后才可以使用遷移選項(xiàng)。為此，請(qǐng)轉(zhuǎn)到 Window -> Preferences -> Workbench -> Capabilities -> Advanced J2EE -> Enterprise Java，如圖 13 所示。

   
   圖 13. 啟用工作臺(tái)的功能
   
   
9. 在導(dǎo)航窗格中，突出顯示 EmailServiceCustomWeb 項(xiàng)目。右鍵單擊并從上下文菜單中選擇 Migrate -> J2EE Migration Wizard。
10. 在 J2EE Migration Wizard 歡迎屏幕中，忽略警告并單擊 Next。對(duì)于該場(chǎng)景，缺省設(shè)置是可以接受的。圖 14 顯示了缺省 J2EE 版本為 v1.4，目標(biāo)服務(wù)器是 WebSphere Process Server v6.0。單擊 Finish。
    
    圖 14. 項(xiàng)目的遷移設(shè)置
    
    
11. 查找消息“Migration finished successfully”。單擊 OK。由于這只是一個(gè)簡(jiǎn)單的項(xiàng)目，因此 Details 窗格指示許多項(xiàng)不需要遷移。
12. 還有最后一步。您需要將該自定義 Web 項(xiàng)目添加到為 EmailService 業(yè)務(wù)集成模塊生成的企業(yè)應(yīng)用程序中。該操作是在 Integration Developer 的 J2EE 透視圖中完成的，包括幾個(gè)步驟。
13. 轉(zhuǎn)到 J2EE 透視圖，Window -> Open Perspective -> J2EE。在導(dǎo)航窗格中，轉(zhuǎn)到 Enterprise Applications -> EmailServiceApp -> Deployment Descriptor。打開 EmailServiceApp 的部署描述符。
14. 在主窗口中，單擊 Module 選項(xiàng)卡。在 Modules 下面，單擊 Add，如圖 15 所示。彈出的 Add Module 窗口將查找 EmailServiceCustomWeb 項(xiàng)目。選擇該項(xiàng)目并單擊 Finish。
    
    圖 15. 項(xiàng)目引用設(shè)置
    
    
15. 單擊 Ctrl-S 保存應(yīng)用程序的部署描述符。
16. 在 Integration Developer 中，不能再為業(yè)務(wù)流程生成 Facade EJB。您必須手動(dòng)遷移這些代碼以使用 SCA 編程模型調(diào)用業(yè)務(wù)流程。這就是您需要修復(fù) index.jsp 文件中的錯(cuò)誤的原因。

    在 J2EE 透視圖中，編輯 index.jsp。在 Project Explorer 窗格中，轉(zhuǎn)到 Dynamic Web Projects -> EmailServiceCustomWeb -> Web Content ->index.jsp。雙擊 index.jsp 打開該文件進(jìn)行編輯。選擇 JSP 編輯器的 Source 選項(xiàng)卡。您將看到“if”代碼塊內(nèi)的錯(cuò)誤，如圖 16 所示。

    
    圖 16. 編輯 index.jsp 文件
    
    
17. 使用下面的代碼替換 if 代碼塊：
    
    

    com.scb.process.email.mail.smtp.MailSMTP service = (com.scb.process.email.mail.smtp.MailSMTP) com.ibm.websphere.sca.ServiceManager.INSTANCE. locateService("MailSMTPPartner"); boolean success = service.sendEmail( request.getParameter("server"), request.getParameter("from"), request.getParameter("to"), request.getParameter("contents"));

    
    
18. 保存對(duì) index.jsp 和部署描述符的更改。

現(xiàn)在，您可以通過下面列出的三種方法進(jìn)行測(cè)試，其中每一個(gè)測(cè)試都是相繼測(cè)試應(yīng)用程序的組件。

使用 Integration Developer 集成測(cè)試客戶機(jī)測(cè)試遷移的組件

現(xiàn)在您可以在 Integration Developer 中測(cè)試遷移的應(yīng)用程序。通過使用嵌入式測(cè)試服務(wù)器運(yùn)行應(yīng)用程序，集成測(cè)試客戶機(jī)允許您單獨(dú)測(cè)試每一個(gè)組件。

1. 轉(zhuǎn)到 Business Integration 視圖中的導(dǎo)航窗格。右鍵單擊 EmailService 項(xiàng)目。從上下文菜單中選擇 Test -> Test Module。對(duì)于要測(cè)試的組件，選擇 MailSMTP。

   請(qǐng)注意：您可以選擇調(diào)用的組件。在 MailSMTP 的第一個(gè)示例中，選擇 Java 組件。稍后，確定 Java 組件正確工作后，您可以執(zhí)行調(diào)用業(yè)務(wù)流程組件的更加全面的測(cè)試。

   
   圖 17. 調(diào)用事件
   
   
2. 在 Events 屏幕中，輸入 4 個(gè)輸入請(qǐng)求參數(shù)的值（電子郵件服務(wù)器的名稱、電子郵件地址以及用作電子郵件內(nèi)容的文本），并單擊 Continue。
3. Deployment Location 窗口彈出。請(qǐng)選擇突出顯示的 WebSphere Process Server v6.0 并單擊 Finish。
4. 集成測(cè)試客戶機(jī)將啟動(dòng)嵌入式 Process Server 測(cè)試服務(wù)器，安裝并啟動(dòng)遷移的應(yīng)用程序，并且使用您指定的參數(shù)調(diào)用 MailSMTP Java 服務(wù)。如果輸入?yún)?shù)是正確的，您將看到返回結(jié)果的值為“true”，如圖 18 所示。
   
   圖 18. 返回結(jié)果
   
   
5. 通過檢查電子郵件是否已發(fā)送到收件人，驗(yàn)證是否成功調(diào)用 Java 服務(wù)，如圖 19 所示。
   
   圖 19. 測(cè)試電子郵件
   
   

   該測(cè)試展示了如何使用 Integration Developer 集成測(cè)試客戶機(jī)調(diào)用 Java 組件 (MailSMTP)。

使用 Integration Developer 集成測(cè)試客戶機(jī)測(cè)試更多遷移的組件

1. 在 Business Integration 透視圖中右鍵單擊 EmailService 項(xiàng)目，回到 Events 屏幕，然后從上下文菜單中選擇 Test -> Test Module。
2. 在 Component 字段中，單擊下拉箭頭并選擇名為 EmailBusinessProcess 的組件。它是實(shí)現(xiàn)為 BPEL 流程的業(yè)務(wù)流程組件。它調(diào)用剛才測(cè)試的 MailSMTP Java 服務(wù)。這是一個(gè)更加全面的測(cè)試，演示了如何在業(yè)務(wù)集成模塊中增量測(cè)試組件。
3. 如上一個(gè)測(cè)試那樣，輸入 4 個(gè)請(qǐng)求參數(shù)的值，然后單擊 Continue。
   
   圖 20. 選擇組件
   
   
4. 這也將獲得一個(gè)成功的測(cè)試。收件人獲得了測(cè)試電子郵件，并且 Events 屏幕顯示圖 21 中所示的結(jié)果。
   
   圖 21. 成功的結(jié)果
   
   

使用遷移的 JSP 測(cè)試遷移的應(yīng)用程序

現(xiàn)在您可以使用遷移的 JSP 測(cè)試遷移的應(yīng)用程序。這是一個(gè)全面的測(cè)試，因?yàn)樗硎疽粋€(gè)端到端場(chǎng)景。

1. 轉(zhuǎn)到 J2EE 透視圖中的導(dǎo)航窗格。展開 Enterprise Applications 并右鍵單擊 EmailServiceApp 項(xiàng)目。從上下文菜單中選擇 Run -> Run on Server。
2. 在 Server Selection 屏幕中，選擇 WebSphere Process Server v6.0（如圖 22 所示）并單擊 Finish。
   
   圖 22. 定義新測(cè)試服務(wù)器
   
   
3. Process Server 測(cè)試服務(wù)器啟動(dòng)后，應(yīng)用程序發(fā)布到該測(cè)試服務(wù)器。在 Integration Developer 的主窗口中，Web 瀏覽器窗口打開。缺省情況下，它指向 http://localhost:9080/EmailServiceCustomWeb/，如圖 23 所示。
   
   圖 23. WebSphere Integration Developer 內(nèi)的 Web 瀏覽器
   
   
4. 在 Web 瀏覽器屏幕中，輸入 4 個(gè)輸入請(qǐng)求參數(shù)的值，然后單擊 Enter。請(qǐng)記住輸入電子郵件服務(wù)器的名稱和您自己的電子郵件地址。（作者不希望得到所有這些測(cè)試電子郵件！）
5. 如果一切進(jìn)展順利，您將看到在 Web 頁(yè)面下部輸出的消息“Result is: true”。驗(yàn)證 JSP 是否成功調(diào)用了業(yè)務(wù)流程。JSP 調(diào)用您創(chuàng)建的獨(dú)立引用，獨(dú)立引用反過來(lái)調(diào)用遷移的業(yè)務(wù)流程和 Java 服務(wù)。當(dāng)收件人接收到電子郵件時(shí)測(cè)試完成，如圖 24 所示。
   
   圖 24. 測(cè)試電子郵件
   
   
   

   請(qǐng)注意：如果您關(guān)閉了 AutoBuild 選項(xiàng)，可以再次啟用（Integration Developer Main Menu -> Project -> Build Automatically）。

您已經(jīng)通過三種不同方式成功測(cè)試了遷移的應(yīng)用程序，這就在環(huán)境中為您準(zhǔn)備了一個(gè)完整的端到端場(chǎng)景。

結(jié)束語(yǔ)

本文介紹了如何遷移發(fā)送電子郵件的簡(jiǎn)單業(yè)務(wù)流程，如何在 WebSphere Process Server 運(yùn)行時(shí)運(yùn)行該業(yè)務(wù)流程，以及如何測(cè)試遷移的流程。從 WebSphere Studio Application Developer Integration Edition v5.1.x 遷移一個(gè)簡(jiǎn)單的服務(wù)項(xiàng)目以使其在 WebSphere Integration Developer v6.0 中工作是相當(dāng)簡(jiǎn)單的，當(dāng)服務(wù)項(xiàng)目具有一個(gè)項(xiàng)目文件（如 EmailService 示例和一些簡(jiǎn)單的 Java 代碼）時(shí)尤為如此。我們了解這不是一個(gè)典型的 BPEL 業(yè)務(wù)流程示例，但是使用它在 Integration Developer 中引入了遷移向?qū)РⅢw驗(yàn)了源構(gòu)件遷移。我們希望實(shí)際的遷移項(xiàng)目使用遷移向?qū)В撬矔?huì)涉及到大量的手動(dòng)遷移工作。