配置連接器

如果您使用 WebSphere MQ Integrator Broker 作為整合分配管理系統,則您可從「連接器配置程式」配置連接器內容。如果您使用 WebSphere ICS 作為整合分配管理系統,則您可從「系統管理程式」存取的「連接器配置程式」來配置連接器內容。

配置資料處理常式

配置用於 XML 資料處理常式的 Meta 物件。如需配置 Meta 物件的相關資訊,請參閱"針對資料處理常式配置最上層 Meta 物件"

標準連接器內容

標準配置內容提供所有連接器使用的資訊。 請參閱附錄 A, 連接器的標準配置內容,以取得這些內容的文件。

重要事項:
因為此連接器支援所有整合分配管理系統,所以所有分配管理系統的配置內容都與它相關。

表 1 附錄中提供此連接器所特有的配置內容資訊。

表 1. 此連接器特有的內容資訊
內容 附註
CharacterEncoding 此連接器不使用此內容。
Locale 因為已國際化此連接器,所以您可變更此內容的值。

您必須在執行連接器之前,提供 ApplicationName 的配置內容值。您也必須在執行連接器之前,至少設定下列標準連接器配置內容。

連接器特有內容

連接器特有配置內容提供連接器於執行時期所需的資訊。 連接器特有內容也會提供一種可在連接器內變更靜態資訊或邏輯的方法,而不必重新編碼及重新建置連接器。

表 2 列出了連接器的特有配置內容。請參閱後續章節的內容說明。

表 2. 連接器特有配置內容
名稱 可能值 預設值 必要?
ArchiveDirectory 保存目錄名稱 \connectors\xml\archive
DataHandlerConfigMO 資料處理常式 Meta 物件名稱 MO_DataHandler_ Default YES
HttpProxyHost Http 主機名稱

HttpProxyPort Http Proxy 埠 80
HttpsDebug 將內容設為表 3 中的其中一個值。

HttpsProxyHost Http 主機名稱

HttpsProxyPort Http Proxy 埠 443
JavaProtocolHandlerPkgs 通訊協定處理常式名稱 com.crossworlds. connectors.utils. ProtocolHandlers YES
MaxNumRetries 正整數 10
PollingBusinessObjects 商業物件名稱

ReturnBusObjResponse true 或 false true
SecurityProvider SSL 實作 com.sun.net.ssl. internal.ssl. Provider.sun. security.provider. Sun YES
UseCaches true 或 false false
UseDefaults true 或 false false
UseDigitalSignature true 或 false false

ArchiveDirectory

包含保存事件的目錄。每個事件可由其商業物件名稱及動詞來識別。依預設,會將 Create 動詞附加到商業物件物件名稱中。預設值為 \connectors\xml\ archive

DataHandlerConfigMO

XML 連接器用來判斷其資料處理常式支援之最上層 Meta 物件的名稱。此 Meta 物件必須包含 XML 資料處理常式用來設定配置內容之子項 Meta 物件的名稱。此內容也由 DataHandler 基礎類別用來判斷要為特定內容類型建立哪個 DataHandler 類別的實例。預設為 MO_DataHandler_Default。如需詳細資訊,請參閱針對資料處理常式配置最上層 Meta 物件

HttpProxyHost

充當 HTTP 之 Proxy 的主機名稱。僅當網路使用 Proxy 伺服器 (使用 HTTP 通訊協定) 時,才需要此內容。

HttpProxyPort

用於連接 HTTP 的 Proxy 埠號。僅當網路使用 Proxy 伺服器 (使用 HTTP 通訊協定) 時,才需要此內容。 預設埠號為 80

HttpsDebug

決定為 HTTPS 階段作業產生何種除錯資訊之內容的設定。表 3 列示 HTTPS 通訊協定處理常式的 HTTPS 除錯值。


表 3. HttpsDebug 值
名稱 意義
all 開啟所有的除錯
data 每個交換訊息的十六進位傾出。它可用於擴大訊息交換除錯。
handshake 列印每個交換訊息。它可以與 SSL 一起使用。
keygen 列印金鑰產生資料。它可以與 SSL 一起使用。
plaintext 記錄純文字的十六進位傾出。它可以用於擴充記錄除錯。
record 啟用每一記錄追蹤。它可以與 SSL 一起使用。
session 列印階段作業活動。它可以與 SSL 一起使用。
ssl 僅開啟 SSL 除錯。
verbose 列印冗餘交換訊息。它可以用於擴充記錄除錯。

HttpsProxyHost

HTTPS Proxy 機器名稱。僅當網路使用 Proxy 伺服器 (使用 HTTPS 通訊協定) 時,才需要此內容。

HttpsProxyPort

用於連接 HTTPS 的 Proxy 埠號。僅當網路使用 Proxy 伺服器 (使用 HTTPS 通訊協定) 時,才需要此內容。

JavaProtocolHandlerPkgs

如果有此屬性,則它會指定用作通訊協定處理常式,而不是預設 Java 處理常式的套件。這些類別必須符合「Java 的通訊協定處理常式組織架構」。例如,若要使用名為 com.mycompany.http (適於 HTTP) 的通訊協定處理常式,請將此欄位設為 com.mycompany。也請確定對應類別的 .jar 檔案在您的類別路徑中。

如需「Java 通訊協定處理常式」的詳細資訊,請參閱下面網站的指導教學,網址為:http://developer.java.sun.com/developer/onlineTraining/protocolhandlers/

也可以為此值指定多個套件,中間以垂直線 『|』 隔開。例如,com.crossworlds.Protocol Handlers|com.mycompany

WebSphere Business Integration Adapter 會遞送兩個套件:

預設值為 com.crossworlds.connectors.utils.ProtocolHandlers

MaxNumRetries

指定在非同步通訊協定處理常式沒有接收目的地 URL 之回應後的重試次數。只有非同步通訊協定處理常式才需使用此內容。如果您不指定值,則此內容會預設為零。預設值是 0

PollingBusinessObjects

用於事件通知的商業物件。請以逗點隔開多個項目 (例如,XMLPoll_Cust, XMLPoll_Order)。每個商業物件都必須是連接器支援的物件。如果針對事件通知而設定了連接器,則需要此內容。

ReturnBusObjResponse

判斷連接器是否預期從通訊協定處理常式傳回商業物件。如果將值設為 true,則連接器會預期傳回商業物件。如果將值設為 false,則連接器不會預期傳回商業物件。它僅預期傳回成功或失敗回應。預設值為 true。

註:
如果您正在配置非同步通訊協定處理常式,則必須將值設為 false,因為非同步通訊協定處理常式不會預期傳回商業物件回應。

SecurityProvider

在 SSL 訊息交換期間,由 HTTPS 使用。此屬性值以逗點區隔,判斷當連接到 HTTPS URL 時,使用哪個 SSL 實作。如果未設定值,則 HTTPS 連線無法運作。預設值為 com.sun.net.ssl. internal.ssl.Provider.sun.security.provider.Sun

UseCaches

如果將此屬性設為 false,連接器會試圖擷取 XML 文件的非快取版本。這僅是要求;它無法由連接器嚴格地施行。請將此值設為 true,以僅擷取快取的 XML 文件。

UseDefaults

在「建立」作業上,如果 UseDefaults 設為 true,連接器會檢查提供給每一個 isRequired 商業物件屬性的是有效值或預設值。 如果已提供值,表示「建立」作業成功。如果參數設為 false,連接器僅檢查有效值,如果未提供, 則會導致「建立」作業失敗。預設值是 false

UseDigitalSignature

指定是否將數位簽章長度 (二進位為 0) 新增至由使用 HTTP 或 HTTPS 通訊協定傳送之訊息的結尾。如果您的連接器支援數位簽章,請將此內容設為 true。預設值是 false

註:
本產品提供的連接器並不支援數位簽章。

Copyright IBM Corp. 1997, 2003