Administration Console オンライン ヘルプ

  前 次 前/次ボタンと目次ボタンとの区切り線 目次  

Web サービス

始める前に

Administration Console を使用して WebLogic Web サービスをインストール、起動、およびコンフィグレーションするには、WebLogic Web サービスを作成しておく必要があります。


Web サービスは、SOAP を使用して呼び出せるようにするためのアーティファクトが追加された Java クラスまたはステートレス セッション EJB です。追加されるアーティファクトとしては、Web サービス固有のデプロイメント記述子、WSDL ファイル (Web サービスのパブリック コントラクト)、およびデータ バインディング コンポーネント (データを、その内部 Java 表現と、SOAP の要求および応答メッセージで使用される外部 XML 表現との間で変換するために使用) があります。

WebLogic Web サービスのプログラミング モデルで中心となるのは、Java Web サービス (JWS) ファイルと、JWS ファイルに対して実行される Ant タスクです。JWS ファイルは Java ファイルであり、JWS メタデータ アノテーションを使用して Web サービスの形式や動作を指定します。プログラマは、JWS ファイルを最初からプログラミングしたり、既存の WSDL ファイル (Web サービスのパブリック コントラクト) からスタブを生成することで Web サービスの作成を開始し、それを各自のビジネス ロジックの Java コードで更新します。プログラマは次に、jwsc Ant タスクを使用して、JWS ファイルから、Web サービスを表す、デプロイ可能な JEE 5 アプリケーションまたはモジュールを生成します。プログラマはこれらのタスクを繰り返して、Web サービスの記述と生成を行い、目的の機能を実現します。

プログラマは、Web サービスをプログラミングする際、JAX-WS と JAX-RPC という 2 つの種類の実装のいずれか一方を選択できます。この 2 種類の Web サービスは、呼び出し方法とサポートするその他の仕様が若干異なりますが、それ以外の点ではよく似ています。たとえば、プログラミング モデルは実質的に同じであり、どちらも JWS ファイルとメタデータ アノテーションを使用します。

Web サービスは、その実装に応じて、Web アプリケーションまたは EJB としてデプロイされます。Web アプリケーションと EJB は、単体でデプロイすることも、エンタープライズ アプリケーションの一部としてデプロイすることもできます。管理サーバに現在インストールされている Web サービスを表示する手順については、インストールされている Web サービスの表示を参照してください。

プログラマはまた、Administration Console を使用して、生成された Web サービスが正常にデプロイまたは機能することをテストします。また、以下の節で説明するように、管理者は完成した Web サービスに対して、インストール、起動、コンフィグレーションなどのタスクを行うことができます。

WebLogic Web サービスの作成と手順の詳細については、以下を参照してください。

以下の主要な手順では、Administration Console を使用して Web サービスに対して実行できる管理タスクについて説明します。

  1. まだ行っていない場合、Administration Console のチェンジ センタで [ロックして編集] をクリックします (チェンジ センタの使用を参照)。
  2. Web サービスをインストールして、そのアーカイブまたは展開されたディレクトリを Administration Console に認識させます。Web サービスのインストールを参照してください。
  3. Web サービスを起動して、クライアント アプリケーションが Web サービスを使用できるようにします。Web サービスの起動と停止を参照してください。このタスクでは、クライアント アプリケーションがアクセスできなくなるように Web サービスを停止する方法についても説明します。
  4. Web サービスの基本的なコンフィグレーションを表示します。基本的なコンフィグレーションとは、Web サービスがパッケージ化されているアーカイブ ファイル、Web サービスのデプロイ名、実装の種類 (JAX-WS または JAX-RPC)、WSDL ファイル内の名前などです。Web サービスのコンフィグレーションの表示を参照してください。
  5. Web サービスに関連付けられた SOAP メッセージ ハンドラを表示します。Web サービスの SOAP メッセージ ハンドラの表示を参照してください。
  6. Web サービスの WSDL を表示します。Web サービスの WSDL の表示を参照してください。
  7. 呼び出された回数や最長呼び出し時間など、Web サービスのアクティビティをモニタします。Web サービスのモニタを参照してください。
  8. 信頼性のある SOAP メッセージングやバッファリングに必要な JMS リソースをコンフィグレーションします。信頼性のある SOAP メッセージングのためのリソースのコンフィグレーションを参照してください。

    注意: このタスクが適用されるのは JAX-RPC Web サービスのみです。JAX-WS Web サービスには適用されません。またこのタスクは、信頼性のある SOAP メッセージングやバッファリング機能を使用するように JAX-RPC Web サービスがプログラミングされている場合にのみ行います。Web サービスでこれらの機能をプログラミングする方法については、Web サービスの信頼性のあるメッセージングの使用およびバッファ付き Web サービスの作成を参照してください。

  9. WS-Policy ファイルを Web サービスやそのオペレーションに関連付けます。WS-Policy ファイルは、メッセージ レベルのセキュリティおよび信頼性のある SOAP メッセージングのコンフィグレーションに使用されます。WS-Policy ファイルと Web サービスとの関連付けを参照してください。

    注意: このタスクが適用されるのは JAX-RPC Web サービスのみです。JAX-WS Web サービスには適用されません。

  10. Web サービスに関連付けられた Web サービス セキュリティ コンフィグレーションを作成します。

    プログラマが Web サービスを作成したときに、@WssConfiguration JWS アノテーションを使用して、Web サービス セキュリティ コンフィグレーションをサービスに関連付けている場合があります。この関連付けられた Web サービス セキュリティ コンフィグレーションは、(関連付けられた WS-Policy ファイルに指定されているセキュリティ機能に加えて)、ID の確立に X.509 証明書を使用するかどうか、SOAP メッセージでパスワード ダイジェストを使用するかどうかなどの、セキュリティ機能のコンフィグレーションに使用されます。

    以下のタスクを参照してください。

  11. 必要に応じて、Web サービスを削除します。Web サービスを削除します。を参照してください。
  12. これらの変更をアクティブにするには、Administration Console のチェンジ センタで [変更のアクティブ化] をクリックします。
    すべての変更が即座に有効になるわけではありません。再起動が必要なものもあります (チェンジ センタの使用を参照)。

関連トピック

 

Skip navigation bar ページの先頭