Cosminexus アプリケーションサーバ V8 Webサービス開発の手引

[目次][用語][索引][前へ][次へ]

1.3.2 機能および仕様に関する前提条件

Cosminexus上でWebサービスを開発するときに利用できる機能および仕様について説明します。標準仕様のサポート範囲については,「14. 標準仕様のサポート範囲」を参照してください。

<この項の構成>
(1) デフォルトマッピング
(2) マッピングのカスタマイズ
(3) JavaとWSDL間のバインディング
(4) WSDL仕様
(5) SOAP仕様
(6) Message Exchange Pattern(MEP)
(7) 非同期関連の機能
(8) Dispatch/Providerインタフェース関連の機能
(9) Endpointクラスおよび発行関連の機能
(10) ハンドラ関連の機能
(11) 添付ファイルの使用
(12) メッセージコンテキスト
(13) API
(14) XML/HTTPバインディング
(15) 関連する標準仕様

(1) デフォルトマッピング

CosminexusのJAX-WS機能で提供しているコマンドは,JAX-WS 2.1仕様の2章で規定されたWSDLからJavaへのデフォルトのマッピング,JAX-WS 2.1仕様の3章で規定されたJavaからWSDLへのデフォルトのマッピングに従って動作します。

また,Webサービス側のJAX-WSエンジンは,WebサービスのメタデータであるWSDLを要求された場合,WARファイルまたはEJB JARファイルにWSDLがなければ,JAX-WS 2.1仕様の3章で規定されたJavaからWSDLへのデフォルトのマッピングに従って,WSDLを生成します。

WSDLからJavaへのデフォルトのマッピングについては,「12.1 WSDLからJavaへのデフォルトマッピング」を参照してください。JavaからWSDLへのデフォルトのマッピングについては,「13.1 JavaからWSDLへのデフォルトマッピング」を参照してください。

(2) マッピングのカスタマイズ

CosminexusのJAX-WS機能で提供しているコマンドは,JAX-WS 2.1仕様の7章で規定されたWSDLからJavaへのマッピングのカスタマイズ(バインディング宣言),およびJAX-WS 2.1仕様の8章で規定されたJavaからWSDLへのマッピングのカスタマイズ(アノテーション)に従って動作します。

また,Webサービス側のJAX-WSエンジンは,WebサービスのメタデータであるWSDLを要求された場合,WARファイルまたはEJB JARファイルにWSDLがなければ,JAX-WS 2.1仕様の7章で規定されたJavaからWSDLへのマッピングのカスタマイズに従って,WSDLを生成します。

WARファイルについては「3.5.1 WARファイルの構成」を参照してください。EJB JARファイルについては「3.5.2 EJB JARファイルの構成」を参照してください。WSDLからJavaへのマッピングのカスタマイズについては,「12.2 WSDLからJavaへのマッピングのカスタマイズ」を参照してください。JavaからWSDLへのデフォルトのマッピングについては,「13.2 JavaからWSDLへのマッピングのカスタマイズ」を参照してください。

(3) JavaとWSDL間のバインディング

CosminexusのJAX-WSエンジンは,WebサービスおよびWebサービスクライアントともに,JAX-WS 2.1仕様の2章および3章に従って,JavaとWSDL間をバインディングします。

CosminexusのJAX-WSエンジンのサポート範囲については,「10.2 JAX-WSエンジンの動作」を参照してください。

(4) WSDL仕様

CosminexusのJAX-WS機能では,WSDL 1.1仕様のWSDLをサポートしています。WSDL定義のスタイルとしては,document/literalスタイルだけサポートしています。document/literalスタイルであれば,wrapperスタイルおよびnon-wrapperスタイルのどちらも利用できます。

WSDL 1.1仕様のサポート範囲については,「14.1 WSDL 1.1仕様のサポート範囲」を参照してください。

(5) SOAP仕様

CosminexusのJAX-WS機能では,SOAP 1.1仕様およびSOAP 1.2仕様のSOAPメッセージをサポートしています。

(6) Message Exchange Pattern(MEP)

CosminexusのJAX-WS機能では,MEPとしてrequest-responseパターンだけサポートしています。

(7) 非同期関連の機能

CosminexusのJAX-WS機能では,JAX-WS 2.1仕様の2.3.4項や,4章などに記載されているWebサービスクライアントでの非同期呼び出しを実現する機能はサポートしていません。

(8) Dispatch/Providerインタフェース関連の機能

CosminexusのJAX-WS機能では,JAX-WS 2.1仕様の4章に記載されているDispatchインタフェース,JAX-WS 2.1仕様の5章に記載されているProviderインタフェース,およびDispatchインタフェースとProviderインタフェースに関連する機能をサポートしています。ただし,JAX-WS 2.1仕様の4章に記載されているオブジェクトのうち,次のオブジェクトはサポートしていません。

(9) Endpointクラスおよび発行関連の機能

CosminexusのJAX-WS機能では,JAX-WS 2.1仕様の5章に記載されているWebサービスのエンドポイントを動的に生成し,発行するための機能はサポートしていません。

(10) ハンドラ関連の機能

CosminexusのJAX-WS機能では,Webサービスクライアントの実装で,APIによる動的なハンドラ設定をサポートしています。また,Webサービスの実装で,アノテーションによる動的なハンドラ設定をサポートしています。JSR-109仕様を前提とする静的な設定はサポートしていません。

(11) 添付ファイルの使用

CosminexusのJAX-WS機能では,SAAJ 1.3仕様,およびWSDLにwsi:swaRef型を記述する形式の添付ファイルおよびMTOM/XOP仕様形式の添付ファイルをサポートしています。WSDL 1.1仕様のMIME拡張要素を使用する記述(MIMEバインディング)はサポートしていません。wsi:swaRef形式の添付ファイルの使用方法については,「18. 添付ファイル機能(wsi:swaRef形式)」を参照してください。MTOM/XOP仕様形式の添付ファイルの使用方法については,「20. 添付ファイル機能(MTOM/XOP)」を参照してください。

(12) メッセージコンテキスト

CosminexusのJAX-WS機能では,JAX-WS 2.1仕様の9章に記載されている標準のメッセージコンテキストプロパティは,読み取りだけサポートしています。Webサービスクライアントの実装でタイムアウトを設定するためのプロパティをサポートしています。メッセージコンテキストの使用方法および注意事項については,「15.5 メッセージコンテキストの使用」を参照してください。

(13) API

CosminexusのJAX-WS機能では,JAX-WS 2.1仕様のAPIをサポートしています。JAX-WS APIのサポート範囲については,「15. JAX-WS APIのサポート範囲」を参照してください。

(14) XML/HTTPバインディング

CosminexusのJAX-WS機能では,JAX-WS 2.1仕様の11章に記載されているXML/HTTPバインディングはサポートしていません。

(15) 関連する標準仕様

関連する標準仕様について説明します。