10.3 cosminexus-jaxws.xmlによるカスタマイズ
cosminexus-jaxws.xmlは,POJOのWebサービスのURLとWebサービス実装クラスまたはプロバイダ実装クラスのマッピングをカスタマイズするためのDDです。Webサービス実装クラスまたはプロバイダ実装クラスを見つけ出す処理(ディスカバリ)をカスタマイズしたい場合,または複数のURLに対して単一のWebサービス実装クラスおよびプロバイダ実装クラスを割り当てたい場合に作成します。
マッピングをカスタマイズしない場合,cosminexus-jaxws.xmlは不要です。また,cosminexus-jaxws.xmlをEJB JARファイルに含めても,EJBのWebサービスには適用されません。
マッピングのカスタマイズについては,「10.2.2(1) ディスカバリ」を参照してください。
マッピングをカスタマイズする場合,cosminexus-jaxws.xmlが正しく記述されているか注意してください。cosminexus-jaxws.xmlはWebサービスの初期化時に読み込まれます。したがって,cosminexus-jaxws.xmlの読み込みでエラーが発生した場合,Webサービスの初期化に失敗します。Webサービスの初期化については,「10.9.1 Webサービスの初期化」を参照してください。
ここでは,cosminexus-jaxws.xmlのファイル名と格納先,および書式について説明します。