在安裝、配置及使用配接器之前,您必須先了解它的環境需求:
配接器使用的配接器組織架構必須與所通訊的整合分配管理系統 (或分配管理系統)
版本相容。下列配接器組織架構及整合分配管理系統, 可支援 3.2 版的 Web
服務配接器:
- 配接器組織架構:WebSphere Business Integration Adapter Framework,版本:
- 僅限 WebSphere InterChange Server,版本:
請參閱「版本注意事項」,查看是否有任何例外狀況。
- 註:
- 若要利用 3.2 版配接器所記載的所有功能,您必須安裝 WebSphere
InterChange Server 4.2.2 版。
請先檢視下列假設及軟體需求,再安裝 Web 服務連接器:
- 連接器及其他元件的設計,是依據針對 SOAP 1.1 來公佈的規格。
- 若您正使用 SOAP/JMS Web 服務,則必須安裝您自己的 JMS 及 JNDI 實作方式。
- 若您正使用
HTTPS/SSL,則需要您自己的協力廠商軟體,來建立金鑰儲存庫及信任儲存庫。
配接器可在下列平台 (作業系統) 上執行:
- Microsoft Windows 2000
- Solaris 7、8 或 AIX 5.1、5.2 或 HP-UX 11i
各種的標準及技術讓 Web 服務能夠透過網路來存取其功能。
配接器使用的標準如下:
- SOAP 1.1 版,請參閱 SOAP 規格 1.1 版
- WSDL 1.1 SOAP 連結
- HTTP 1.0
- JMS 1.0.2
配接器使用的 API 如下:
- Apache SOAP 2.3.1 API:連接器從 Apache Foundation 納入了
SOAP API。 Apache SOAP API 是 SOAP 1.1 版的開放原始碼實作方式。 Apache
SOAP API 的基本需求如下:
- Java Activation Framework 1.0.1 (activation.jar)
- JavaMail(TM) API 1.2 (mail.jar)
- Xerces Java 剖析器 1.4.3 及以上版本,Xerces2 是完全符合的
XML 綱目處理器
- JMS API 1.0.2 版
- WSDL4J 1.2.1 - Web Service Description Language for Java API
(WSDL4J) 提供 WSDL 文件的物件模型
- UDDI4J-WSDL 2.1.0 - UDDI4J-WSDL API 封裝存在於 UDDI4J API
中的類別,以及一些由 WSDL4J API 所定義的類別
- JNDI 1.2.1
- WSDL4J 1.0
- IBM JSSE 1.0.2
根據您的配置,您可能需要安裝其他軟體。下面各節將會討論這些情況。
若您正使用 JMS 通訊協定,則必須安裝 JMS 提供者,並建立佇列。
至於要建立哪些佇列,就要視您的需求而定了。 您可使用 JMS
通訊協定將協同作業顯現成 Web 服務,亦可使用它來呼叫外部 Web 服務。
如需進一步資訊,請參閱連接器及 JMS。
您必須配置 JNDI,然後在連接器的 JNDI 配置內容中輸入適當的參數。
您也必須確定,在 JNDI 上,Connection Factory 及 JMS 目的地 (佇列)
物件都是可用的。 若您要使用 JNDI,但沒有實行 JNDI,您可以從 Sun Microsystems
來下載 File System JNDI 的參照實作方式。 如需進一步資訊,請參閱連接器及 JMS。
若您計劃要使用
SSL,則必須使用協力廠商的軟體來管理您的金鑰儲存庫、憑證及金鑰產生作業。
我們並未提供任何工具來設定金鑰儲存庫、憑證或金鑰產生作業。 您可以選擇使用
Keytool (隨附於 IBM JRE) 來建立自行簽章的憑證以及管理金鑰儲存庫。
如需進一步資訊,請參閱SSL。
連接器已全球化,可以支援雙位元組字集。
當連接器將資料從使用某種字元碼的地方,轉送到使用不同字碼集的地方時,
它會執行字元轉換作業,保留該資料的意義。
「Java 虛擬機器 (JVM)」中的 Java 執行時期環境,代表 Unicode 字碼集的資料。
Unicode 包含大部分已知字碼集的字元編碼 (包括單位元組及多位元組)。 WebSphere
Business Integration 系統中的大部分元件都是用 Java 來撰寫的。
因此,當資料在大部分的整合元件之間轉送時,不需要轉換字元。
- 註:
- 連接器尚未國際化。 這表示追蹤和日誌訊息都沒有翻譯。
本節討論區域化及連接器。
連接器使用可插入的通訊協定接聽器來執行事件通知。
通訊協定接聽器會從傳輸埠擷取 SOAP 訊息,並呼叫 SOAP 資料處理常式。
本節將說明各接聽器如何透過傳輸埠以將 SOAP 訊息編碼。
- SOAP/HTTP 及 SOAP/HTTPS 接聽器
這二種接聽器會以位元組為單位來讀取 HTTP 要求訊息的主體。 主體的編碼是由 HTTP
Content-Type 標頭的 charset 參數所指定。 若 charset 參數遺失,就會採用
ISO-8859-1(ISO Latin 1)。 接聽器會使用此編碼將要求訊息的主體轉換成 Java 字串。
此 Java 字串可用來呼叫 SOAP 資料處理常式。 若為同步的 (要求與回應) Web
服務,會使用協同作業所傳回商業物件來呼叫 SOAP 資料處理常式。 然後會使用 HTTP
要求訊息的編碼來將 SOAP 資料處理常式傳回的 Java 字串會轉換成位元組。
- SOAP/JMS 接聽器此接聽器可支援 JMS 文字訊息以及 JMS 位元組訊息。
連接器使用可插入的通訊協定處理常式來執行要求處理程序。 通訊協定處理常式呼叫
SOAP 資料處理常式。 本節將說明各處理常式如何透過傳輸埠來將 SOAP 訊息編碼。
- SOAP/HTTP-HTTPS 處理常式這些處理常式會呼叫 SOAP 資料處理常式。
為了編製 Web 服務要求,會使用 UTF 8 編碼將資料處理常式傳回的字串轉換成位元組。
若為同步的 (要求與回應) Web 服務,通訊協定處理常式會讀取 HTTP 回應訊息的主體。
主體的編碼是由 HTTP Content-Type 標頭的 charset 參數所指定。 若 charset
參數遺失,就會採用 ISO-8859-1。 處理常式會使用此編碼將回應訊息的主體轉換成
Java 字串。 將會使用此字串來呼叫 SOAP 資料處理常式。
- SOAP/JMS 處理常式此接聽器可支援 JMS 文字訊息。
本節討論區域化及 SOAP 資料處理常式。
XML 元素名稱及屬性名稱必須是商業物件名稱、商業物件屬性名稱或商業物件
應用程式特有資訊所允許的合法的 ascii 字元。
商業物件名稱或商業物件屬性名稱不支援國際化的字元。 只有屬性值可以國際化。
將 SOAP 訊息轉換成商業物件時,資料處理常式只能接收字串。
資料處理常式只會將字串值移入商業物件,並傳回商業物件。 Java 字串是
UCS2,所以可轉送雙位元組的字元,沒有問題。 只有 XML 元素及屬性值可為非 ascii
字元 (請參閱字元限制)。 將商業物件轉換成 SOAP 訊息時,資料處理常式會使用
Xerces 剖析器將商業物件轉換成字串。 Java 字串是
UCS2,所以可轉送雙位元組的字元,沒有問題。 只有 XML 元素及屬性值可為非 ascii
字元 (請參閱字元限制)。
本節討論區域化及 WSDL ODA。
除了 WSDL 檔案中的合法 ASCII 字元之外,WSDL ODA 不支援其他字元。 WSDL ODA
可以支援其他字集的檔案名稱及 URL。 但是這些檔案的內容必須是合法的 ASCII。
WSDL ODA 的「配置代理程式」表格中的內容已全球化,如下所示:
- WSDL_URL URL 可為當地的語言
- UDDI_InquiryAPI_URL 檢查 UDDI 登錄支援
- WebServiceProvider 僅限合法的 ASCII 字元
- WebService 僅限合法的 ASCII 字元
- MimeType 僅限合法的 ASCII 字元
- BOPrefix 僅限合法的 ASCII 字元
- BOVerb 僅限合法的 ASCII 字元
- Collaboration 僅限合法的 ASCII 字元
