3.10.1 Webサービスの実装手順(WSDL起点)
WSDLを起点にJAX-WS機能でWebサービスを開発する場合の流れを次に示します。
-
WSDLファイルの作成
-
Javaソースの生成
-
Webサービスの実装
-
DDの作成
-
EARファイルの作成
-
EARファイルのデプロイと開始
Webサービスセキュリティ機能を組み込むためには,開発ステップ3でWebサービスセキュリティハンドラを追加し,開発ステップ5で各種定義ファイルと設定ファイルを追加する必要があります。
- 注意事項
-
Webサービスセキュリティハンドラは,必ず単独で使用する必要があります。ほかのハンドラとの併用はできないため,注意してください。
ここでは,開発ステップ3と開発ステップ5についてだけ説明します。そのほかの開発ステップの詳細は,マニュアル「アプリケーションサーバ Webサービス開発ガイド」を参照してください。
- 〈この項の構成〉
(1) Webサービスセキュリティハンドラを追加する
Application Serverでは,ハンドラチェイン設定ファイルのテンプレート( cwsshandler.xml)を提供しています。WebサービスにWebサービスセキュリティ機能を組み込む場合は,テンプレートをコピーして作成したハンドラチェイン設定ファイルを利用して,Webサービスセキュリティハンドラ( com.cosminexus.wss.handlers.WSSServerHandler)を追加してください。
Webサービス実装時,javax.jws.HandlerChainアノテーションでWebサービス実装クラスをアノテートし,同アノテーションのfile要素に作成したハンドラチェイン設定ファイルを指定します。指定例を次に示します。
@javax.jws.WebService @javax.jws.HandlerChain(file="cwsshandler.xml") public class AddNumbersImpl{ public int add( int number1, int number2 ) throws AddNumbersFault{ ... } }
(2) Webサービスセキュリティ機能定義ファイル,Webサービスセキュリティ方針定義ファイル,ハンドラチェイン設定ファイルを追加する
Webサービスセキュリティ機能定義ファイル,Webサービスセキュリティ方針定義ファイル,およびハンドラチェイン設定ファイルは,すべてEARファイルに配置する必要があります。
Webサービスセキュリティ機能定義ファイルおよびWebサービスセキュリティ方針定義ファイルは,組み込みたいWebサービスセキュリティ機能の種類によって編集方法が異なります。編集方法については,目的に応じて「3.2 署名付与/検証機能を設定する」,「3.3 暗号化/復号化機能を設定する」,「3.4 認証機能を設定する」,または「3.5 メッセージに有効期限を設定する」を参照してください。配置方法については,「3.9.1(3) WARファイルを作成する」を参照してください。
ハンドラチェイン設定ファイルは,どのWebサービスセキュリティ機能を使用する場合も同じです。ハンドラチェイン設定ファイルの編集方法については「3.10.1(1) Webサービスセキュリティハンドラを追加する」を,配置方法についてはマニュアル「アプリケーションサーバ Webサービス開発ガイド」を参照してください。