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 サービス・クライアント・バインディングの設定に関する情報を参照してください。

アセンブリー・プロパティー

次のリストは、アプリケーションに定義可能なサポートされる一連のプロパティーと属性です。
トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): Java API for XML-Based Web Services (JAX-WS) Web サービスに適用できるプロパティーは、overriddenEndpointURI プロパティーだけです。gotcha
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.xmlweb.xmlapplication-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 で稼働している場合にのみ使用されます。

[z/OS]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>

トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwbs_assembpropclient
ファイル名:rwbs_assembpropclient.html