「使用傳訊系統撰寫服務程式」的範例

下列範例說明如何使用傳訊系統撰寫服務程式。如果您有名稱為 DemoStore 的商店,且您要指派電子郵件和檔案這兩種傳輸方法給 OrderAuthorized 訊息類型,您會執行下列動作:

  1. 新增項目到 JSP 檔的 VIEWREG 表格中,以撰寫這個出埠訊息。VIEWREG 表格的關鍵字是檢視畫面名稱、商店 ID 和裝置格式 ID。如果需要如何使用 VIEWREG 表格的詳細資訊,請參閱 WebSphere Commerce 程式設計手冊

    重要事項: 每一個建立以供傳訊系統之撰寫服務程式使用的檢視畫面,在介面與類別名稱欄位方面必須使用傳訊檢視畫面指令。 且在 docname 欄位中亦必須含有 JSP 檔的名稱。 總結來說:

    INTERFACENAME
    com.ibm.commerce.messaging.viewcommands.MessagingViewCommand
    CLASSNAME
    com.ibm.commerce.messaging.viewcommands.MessagingViewCommandImpl
    PROPERTIES
    使用下列格式來指向 JSP 檔 'docname=jsp file'。
    DEVICEFMT_ID
    代表裝置格式,且應使用值 -3(標準裝置格式), 除非您的應用程式所用的是自訂的裝置格式。VIEWREG 項目中指定的 DEVICEFMT_ID 必須對應於您為傳輸方法指定訊息類型時所選取的裝置格式。

    比方說,如果 DemoStore 的商店 ID 是 5,檢視畫面名稱是 OrderAuthorized,您可以利用下列 SQL 陳述式來插入記錄:

    insert into viewreg (VIEWNAME,STOREENT_ID,DEVICEFMT_ID,INTERFACENAME,CLASSNAME, PROPERTIES)values
    ('OrderAuthorizedView',5,-3,
    'ibm.commerce.messaging.viewcommands.MessagingViewCommand'
    'ibm.commerce.messaging.viewcommands.MessagingViewCommandImpl',
    'docname=OrderAuthorized.jsp');

  2. 使用管理主控台將電子郵件和檔案這兩種傳輸方法指派給 OrderAuthorized 訊息及架構設定。這可使用網站或商店層次的管理權限來完成。 若在網站層次建立設定,則所有商店都可存取之。
  3. 在實作指令時,會建立 SendMsgCmd 指令案例來使用傳訊服務,且會利用 OrderAuthorized 訊息類型的訊息 ID 及 DemoStore 的商店 ID 來呼叫 setMsgType() 和 setStoreID() 方法。如果您必須使用網站層次的架構,請將商店 ID 設為 0,並在 JSP 名稱尾端加上 "&storeDir=no"。否則,請使用您的商店 ID。(若您商店沒有任何架構, 則傳訊系統會自動預設為網站層次的架構。)
  4. 呼叫出埠傳訊系統介面的撰寫方法, 並以 TypedProperty 物件格式傳遞其它任何參數。若您有指定檢視畫面名稱, 則會改寫撰寫訊息時所用之訊息類型的預設檢視畫面名稱。
  5. 如果您想立即傳送訊息,或在交易異動確定之後再傳送,請呼叫 SendMsgCmd 中的 sendImediate 或 sendTransacted。有關這些方法的用法說明,請參閱傳訊系統文件。
  6. 呼叫 SendMsgCmd 的 execute 方法以執行傳送。

相關概念

相關作業

相關參照

IBM copyright