バイナリデータを渡す Web サービス (パート 7): サービスのログ作成および最適化
JAX-WS は、バイナリデータの転送を最適化するための簡単で効率的な方法を提供します。これは、MTOM (Message Transmission Optimization Mechanism) によって提供される「メッセージの最適化」としても知られています。メッセージの最適化とは、Web サービスのメッセージをもっとも効率的な手法で送信する処理のことです。これは、Web サービス通信で、送信前にメッセージをエンコーディングし、最終的な送信先に到達したときにエンコーディングを解除することによって実現されます。MTOM は、XOP (XML-binary Optimized Packaging) を使用して、Web サービスとの間でバイナリデータの送受信を行います。この節で示し、またここで説明するとおり、Web サービスのビジュアルデザイナを使用すると、MTOM を簡単に有効にすることができます。
チュートリアルの内容
- 概要
- EJB モジュールの作成
- Web サービスの作成
- Web サービスのテスト
- バイナリデータを渡すためのスキーマと WSDL ファイルの変更
- Swing クライアントの作成
- => Web サービスのログ作成および最適化
Web サービスのログ作成および最適化
MTOM が正しく動作していることをあとで検証できるようにするには、まずサーバーでログ作成メカニズムを設定することから始めます。これにより、クライアントコードを変更せずに要求メッセージと応答メッセージを監視できます。システムプロパティー -Dcom.sun.xml.ws.transport.http.HttpAdapter.dump=true をサーバーに渡すことで、Web サービスがクライアントとの間で送受信する SOAP メッセージと HTTP ヘッダーを監視できます。
Web サービスのログを作成し、最適化するには、次の手順に従います。
- 次に示すように、「サービス」ウィンドウのサーバーのノードから管理コンソールを開きます。
ブラウザで管理コンソールが開きます。ユーザー名とパスワードを入力し、Enter キーを押します。
- 管理コンソールで、次に示すように「JVM オプション」を使用して、サーバー上でこのプロパティーを設定します。
-Dcom.sun.xml.ws.transport.http.HttpAdapter.dump=true
- 「サービス」ウィンドウで、サーバーを再起動します。
- サーバーの起動中、次に示すように、ほかのサーバー出力とともにこのプロパティーが「出力」ウィンドウに表示されていることを確認します。
- エンタープライズアプリケーションをテスターアプリケーションに再配備し、テスターアプリケーションを介してオペレーションを呼び出し、前の手順で有効にしたログ作成メカニズムによって「出力」ウィンドウに HTTP の要求と応答が表示されていることをふたたび確認します。
これで、HTTP ログ作成は正しく動作しており、このあと、イメージのメッセージ転送を最適化します。
- Web サービスのビジュアルデザイナで Web サービスを開き、「バイナリデータの転送の最適化 (MTOM)」を選択します。
- 「サービス」ウィンドウで、サーバーを再起動します。
- サーバーを再起動中、「出力」ウィンドウで次を確認します。
「出力」ウィンドウで強調表示されている行が示すとおり、MTOM を使用することで、バイナリデータが SOAP 本体に含まれないようにします。代わりに、SOAP アタッチメントとして送信されます。アタッチメントは SOAP メッセージに含まれます。
関連項目
NetBeans IDE 6.1 を使用した Java EE アプリケーションの開発方法についての詳細は、次のリソースを参照してください。
メーリングリストに登録することによって、NetBeans IDE Java EE 開発機能に関するご意見やご提案を送信したり、サポートを受けたり、最新の開発情報を入手したりできます。
