如果您使用 WebSphere MQ Integrator Broker 作為整合分配管理系統,則您可從「連接器配置程式」配置連接器內容。如果您使用 WebSphere ICS 作為整合分配管理系統,則您可從「系統管理程式」存取的「連接器配置程式」來配置連接器內容。
配置用於 XML 資料處理常式的 Meta 物件。如需配置 Meta 物件的相關資訊,請參閱"針對資料處理常式配置最上層 Meta 物件"。
標準配置內容提供所有連接器使用的資訊。 請參閱附錄 A, 連接器的標準配置內容,以取得這些內容的文件。
表 1 附錄中提供此連接器所特有的配置內容資訊。
內容 | 附註 |
---|---|
CharacterEncoding | 此連接器不使用此內容。 |
Locale | 因為已國際化此連接器,所以您可變更此內容的值。 |
您必須在執行連接器之前,提供 ApplicationName 的配置內容值。您也必須在執行連接器之前,至少設定下列標準連接器配置內容。
連接器特有配置內容提供連接器於執行時期所需的資訊。 連接器特有內容也會提供一種可在連接器內變更靜態資訊或邏輯的方法,而不必重新編碼及重新建置連接器。
表 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 |
|
包含保存事件的目錄。每個事件可由其商業物件名稱及動詞來識別。依預設,會將 Create 動詞附加到商業物件物件名稱中。預設值為 \connectors\xml\ archive。
XML 連接器用來判斷其資料處理常式支援之最上層 Meta 物件的名稱。此 Meta 物件必須包含 XML 資料處理常式用來設定配置內容之子項 Meta 物件的名稱。此內容也由 DataHandler 基礎類別用來判斷要為特定內容類型建立哪個 DataHandler 類別的實例。預設為 MO_DataHandler_Default。如需詳細資訊,請參閱針對資料處理常式配置最上層 Meta 物件。
充當 HTTP 之 Proxy 的主機名稱。僅當網路使用 Proxy 伺服器 (使用 HTTP 通訊協定) 時,才需要此內容。
用於連接 HTTP 的 Proxy 埠號。僅當網路使用 Proxy 伺服器 (使用 HTTP 通訊協定) 時,才需要此內容。 預設埠號為 80。
決定為 HTTPS 階段作業產生何種除錯資訊之內容的設定。表 3 列示 HTTPS 通訊協定處理常式的 HTTPS 除錯值。
HTTPS Proxy 機器名稱。僅當網路使用 Proxy 伺服器 (使用 HTTPS 通訊協定) 時,才需要此內容。
用於連接 HTTPS 的 Proxy 埠號。僅當網路使用 Proxy 伺服器 (使用 HTTPS 通訊協定) 時,才需要此內容。
如果有此屬性,則它會指定用作通訊協定處理常式,而不是預設 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。
指定在非同步通訊協定處理常式沒有接收目的地 URL 之回應後的重試次數。只有非同步通訊協定處理常式才需使用此內容。如果您不指定值,則此內容會預設為零。預設值是 0。
用於事件通知的商業物件。請以逗點隔開多個項目 (例如,XMLPoll_Cust, XMLPoll_Order)。每個商業物件都必須是連接器支援的物件。如果針對事件通知而設定了連接器,則需要此內容。
判斷連接器是否預期從通訊協定處理常式傳回商業物件。如果將值設為 true,則連接器會預期傳回商業物件。如果將值設為 false,則連接器不會預期傳回商業物件。它僅預期傳回成功或失敗回應。預設值為 true。
在 SSL 訊息交換期間,由 HTTPS 使用。此屬性值以逗點區隔,判斷當連接到 HTTPS URL 時,使用哪個 SSL 實作。如果未設定值,則 HTTPS 連線無法運作。預設值為 com.sun.net.ssl. internal.ssl.Provider.sun.security.provider.Sun。
如果將此屬性設為 false,連接器會試圖擷取 XML 文件的非快取版本。這僅是要求;它無法由連接器嚴格地施行。請將此值設為 true,以僅擷取快取的 XML 文件。
在「建立」作業上,如果 UseDefaults 設為 true,連接器會檢查提供給每一個 isRequired 商業物件屬性的是有效值或預設值。 如果已提供值,表示「建立」作業成功。如果參數設為 false,連接器僅檢查有效值,如果未提供, 則會導致「建立」作業失敗。預設值是 false。
指定是否將數位簽章長度 (二進位為 0) 新增至由使用 HTTP 或 HTTPS 通訊協定傳送之訊息的結尾。如果您的連接器支援數位簽章,請將此內容設為 true。預設值是 false。