この項目では、ibm-webservicesclient-bnd.xmi デプロイメント記述子ファイルの 概要を説明します。
ibm-webservicesclient-bnd.xmi ファイルには、WebSphere 製品固有の Web サービス・ランタイム情報が含まれています。
WebSphere Application Server で提供されるアセンブリー・ツールを使用して、デプロイメント記述子を構成することができます。詳しくは、ibm-webservicesclient-bnd.xmi デプロイメント記述子の構成を参照してください。
アセンブリー・プロパティー
componentScopedRefs エレメントの属性。 Web サービスが Enterprise JavaBeans (EJB) インプリメンテーションによってインプリメントされると、各 <componentScopedRefs> エレメントは、個々の Enterprise Bean 用のアセンブリー・プロパティーを含みます。<componentScopedRefs> エレメントの componentNameLink 属性は、Enterprise Bean を識別します。<ejb-name> を指定することにより、アセンブリー・プロパティーが Enterprise Bean に適用されます。このプロパティーは、Web サービス・クライアントが Enterprise Bean である場合にのみ使用されます。
serviceRefs エレメントの属性。 クライアント・デプロイメント記述子の <service-ref> エレメント内の <service-ref-name> へのリンクを指定します。クライアント・デプロイメント記述子は、ejb-jar.xml、web.xml、application-client.xml のいずれかです。
serviceRefs エレメントの属性は、オプションです。代替 Web Services Description Language (WSDL) ファイルを許可し、クライアント・デプロイメント記述子の <service-ref> エレメントの <wsdl-file> エレメントで指定されたもの以外でも使用できるようにします。 属性を指定する場合は、同じモジュールに代替 WSDL ファイルをパッケージする必要があり、そのファイルは開発 WSDL ファイルと互換性がなければなりません。deployedWSDLFile プロパティーは、オリジナルの WSDL ファイルではなく、異なるエンドポイント Web アドレスを含む新規 WSDL ファイルを提供します。
提示された portType に 使用するポートを識別します (ユーザーが選択していない場合)。このエレメントには、 portTypeNamespace、portTypeLocalName、portNamespace、portLocalName の 属性があります。これらの属性は、wsdl:portType に使用するべき wsdl:port を識別します。
portQnameBindings エレメントの属性。 同期呼び出しからの応答を待機する時間を秒単位で指定します。デフォルトは、300 秒です。
portQnameBindings エレメントの要素。 HTTP、HTTPS、および Java Message Service (JMS) を含む基本トランスポートとは別に、サービス・エンドポイントに対してサービス・クライアントを認証します。必要に応じて、ユーザー ID およびパスワードの属性を設定します。
portQnameBindings エレメントの要素。 HTTPS アウトバウンド要求の Secure Sockets Layer (SSL) 構成を指定します。name 属性には、SSL 構成レパートリーで定義されている SSL 構成項目の名前または別名が入ります。 この属性は、クライアントが WebSphere Application Server で稼働している場合にのみ使用されます。
WebSphere Application Server for z/OS では、いくつかのデジタル証明書と鍵リング管理が要求されます。 詳しくは、Secure Sockets Layer デジタル証明書、 およびアプリケーションが HTTPS 要求の開始に使用する System Authorization Facility 鍵リングの作成を参照してください。
以下の例では、各種属性のスペルと位置を示します。 ここには必須の ID 属性が含まれていないため、これらの例をカット・アンド・ペーストすることはできません。 WSDL2Java コマンドで生成されるバインディング・ファイル・テンプレートにエレメントを追加する場合は、 各エレメントに、値が固有のストリングである ID 属性があることを確認してください。 ID ストリングの例については、WSDL2Java コマンドで生成される テンプレート xmi ファイルを参照してください。
<com.ibm.etools.webservice.wscbnd:ClientBinding xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI" xmlns:com.ibm.etools.webservice.wscbnd= "http://www.ibm.com/websphere/appserver/schemas/5.0.2/wscbnd.xmi"> <componentScopedRefs componentNameLink="myComponent ref"/> <serviceRefs serviceRefLink="myService ref" deployedWSDLFile="META-INF/wsdl/alternate.wsdl"> <defaultMappings portTypeLocalName="AddressBook" portTypeNamespace="http://www.com.ibm" portLocalName="AddressBookPort" portNamespace="http://www.com.ibm"/> <portQnameBindings portQnameNamespaceLink="http://www.com.ibm" portQnameLocalNameLink="AddressBookPort" syncTimeout="99"> <basicAuth userid="myId" password="myPassword"/> <sslConfig name="mynode/DefaultSSLSettings"/> </portQnameBindings> </serviceRefs> </com.ibm.etools.webservice.wscbnd:ClientBinding>
ibm-webservicesclient-bnd.xmi デプロイメント記述子を構成する場合は、この記事を参照してください。