JAX アプリケーションの ibm-webservicesclient-bnd.xmi アセンブリー・プロパティー
デプロイメント記述子ファイル ibm-webservicesclient-bnd.xmi には、WebSphere® 製品固有の Web サービス・ランタイムの情報が含まれています。このデプロイメント記述子ファイルは、Java™ API for XML-based Web サービスで使用できます。
WebSphere Application Server で提供されるアセンブリー・ツールを使用して、 デプロイメント記述子を構成できます。このデプロイメント記述子の構成について詳しくは、デプロイメント記述子 ibm-webservicesclient-bnd.xmi 内の JAX-RPC Web サービス・クライアント・バインディングの設定に関する情報を参照してください。
アセンブリー・プロパティー
次のリストは、アプリケーションに定義可能なサポートされる一連のプロパティーと属性です。
- componentNameLink
- componentScopedRefs エレメントの属性。Web サービスが Enterprise JavaBeans (EJB) 実装によって実装されると、各 <componentScopedRefs> エレメントには、個々のエンタープライズ Bean 用のアセンブリー・プロパティーが含まれます。 <componentScopedRefs> エレメントの componentNameLink 属性は、 エンタープライズ Bean を識別します。<ejb-name> を指定することにより、アセンブリー・プロパティーが エンタープライズ Bean に適用されます。このプロパティーは、Web サービス・クライアントが Enterprise Bean である場合にのみ使用されます。
- serviceRefLink
- serviceRefs エレメントの属性。 クライアント・デプロイメント記述子の <service-ref> エレメント内の <service-ref-name> への リンクを指定します。クライアント・デプロイメント記述子は、ejb-jar.xml、web.xml、application-client.xml のいずれかです。
- deployedWSDLFile
- serviceRefs エレメントの属性は、オプションです。 代替 Web サービス記述言語 (WSDL) ファイルを許可し、クライアント・デプロイメント記述子の <service-ref> エレメントの <wsdl-file> エレメントで指定されたもの以外でも使用できるようにします。 属性を指定する場合は、同じモジュールに代替 WSDL ファイルをパッケージする必要があり、そのファイルは開発 WSDL ファイルと互換性がなければなりません。deployedWSDLFile プロパティーは、オリジナルの WSDL ファイルではなく、異なるエンドポイント Web アドレスを含む新規 WSDL ファイルを提供します。
- defaultMappings
- 提示された portType に使用するポートをクライアントが選択していない場合に、それを識別するエレメント。このエレメントには、 portTypeNamespace、portTypeLocalName、portNamespace、portLocalName の 属性があります。これらの属性は、wsdl:portType に使用する wsdl:port を識別します。
- syncTimeout
- portQnameBindings エレメントの属性。 同期呼び出しからの応答を待機する時間を秒単位で指定します。デフォルトは、 300 秒です。
- basicAuth
- portQnameBindings エレメントの要素。 HTTP、HTTPS、および Java Message Service (JMS) を含む基本トランスポートとは別に、サービス・エンドポイントに対してサービス・クライアントを認証します。必要に応じて、ユーザー ID およびパスワードの属性を設定します。
- sslConfig
- 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 鍵リングの作成』の情報を参照してください。
- overriddenEndpointURI
- 要求送信先の最終 URL を指定するプロパティー。 クライアントが実行されて Web サービスを呼び出すと、要求はこのプロパティーの URL に送信されます。 この URL は、WSDL ファイルおよびクライアント・コードに指定されたアドレスより優先されます。 ibm-webservicesclient-bnd.xmi ファイルの中で JAX-WS サービスに適用できるプロパティーは、このプロパティーだけです。
バインディング・ファイルの例
以下の例では、各種属性のスペルと位置を示します。 ここには必須の ID 属性が含まれていないため、これらの例をカット・アンド・ペーストすることはできません。 WSDL2Java コマンドで生成されるバインディング・ファイル・テンプレートにエレメントを追加する場合は、 各エレメントに、値が固有のストリングである ID 属性があることを確認してください。 ID ストリングの例については、WSDL2Java コマンドで生成される テンプレート xmi ファイルを参照してください。 このツールについて詳しくは、Java API for XML-based Remote Procedure Call (JAX-RPC) アプリケーションの WSDL2Java コマンド行ツールに関する資料を参照してください。
<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>