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.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 で稼働している場合にのみ使用されます。
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-base-dist&topic=rwbs_assembpropclient
ファイル名:rwbs_assembpropclient.html