WebLogic Web サービスの概要



\| WebLogic Server ホーム \| Web サービス \| 前へ \| 次へ \| 目次 \| 索引 \| PDF 版

この章では、Web サービスの概要と WebLogic Server に実装する方法について説明します。

Web サービス

Web サービスは、分散型 Web ベースアプリケーションのコンポーネントとして共有および使用されるサービスのタイプです。これらのサービスは一般的に、CRM（又はカスタマリレーションシップマネージメント）、注文処理システムなどの既存のバックエンドアプリケーションとインタフェースします。

従来、ソフトウェアアプリケーションアーキテクチャは、メインフレーム上で実行する巨大なモノリシックシステムまたはデスクトップ上で実行するクライアントアプリケーションの 2 つのカテゴリに分けられていました。これらのアーキテクチャはアプリケーションが扱うことを意図している目的においては効率よく機能しますが、外部に対して閉鎖的で、Web の多様なユーザが簡単にアクセスすることができません。

ソフトウェア業界は、Web 上で動的に対話する疎結合なサービス指向アプリケーションの方向に向かっています。このアプリケーションは、大規模なソフトウェアシステムを小規模なモジュラーコンポーネントまたは共有サービスに分割します。これらのサービスは別々のコンピュータ上に常駐することができ、多様なテクノロジを使用して実装できますが、XML や HTTP などの標準の Web プロトコルを使用してパッケージ化され転送されます。そのため、Web 上のすべてのユーザが簡単にアクセスできるようになります。

サービスの概念は新しいものではありません。RMI、COM、および CORBA は、すべてサービス指向テクノロジです。ただし、これらのテクノロジをベースにしたアプリケーションは、特定のベンダの特定のテクノロジを使用して記述されていることが要求されます。この要件は、一般的に Web 上のアプリケーションが広く受け入れられることの妨げになります。この問題を解決するために、Web サービスが異種環境から簡単にアクセスできるようにするための次の特性を共有するように定義されています。

Web サービスが Web 上でアクセス可能であること。
Web サービスが XML ベースの記述言語を使用して記述されていること。
Web サービスが HTTP などの標準のインターネットプロトコルによって転送される XML メッセージを介してクライアント（エンドユーザアプリケーションまたは Web サービスの両方）と通信すること。

Web サービスを使用する理由

Web サービスを使用する主な理由は、以下の利点が得られることです。

多様なハードウェアおよびソフトウェアプラットフォームにわたる分散型アプリケーション間の相互運用性
Web プロトコルを使用したファイアウォールを通過するアプリケーションの利用可能性
異機種分散型アプリケーションの開発を容易にするクロスプラットフォーム、クロス言語データモデル（XML）

Web サービスは、XML や HTTP などの標準の Web プロトコルを使用してアクセスされるので、Web 上の多様な異種アプリケーション（一般的に XML および HTTP を理解する）は自動的に Web サービスにアクセスでき、異なるシステム間での通信の問題を解決します。

これらの異なるシステムには Microsoft SOAP ToolKit クライアント、J2EE アプリケーション、レガシーアプリケーションなどがあります。これらのシステムは、Java、C++、Perl などのさまざまな言語で記述されています。この機能を提供するアプリケーションが Web サービスとしてパッケージ化されている限り、それぞれのシステムは相互に通信できます。

Web サービスコンポーネント

Web サービスは、次のコンポーネントで構成されています。

Web 上のサーバによってホストされる実装
WebLogic Web サービスは、WebLogic Server によってホストされ、標準の J2EE コンポーネント（エンタープライズ JavaBean および JMS など）を使用して実装され、標準の J2EE エンタープライズアプリケーションとしてパッケージ化されます。
標準のデータ転送および Web サービスは、Web サービスと Web サービスのユーザ間で呼び出します。
WebLogic Web サービスでは、Simple Object Access Protocol（SOAP）1.1 をメッセージフォーマットとして使用し、HTTP を接続プロトコルとして使用します。SOAP については、添付ファイル付き SOAP 1.1を参照してください。
Web サービスを起動できるようにクライアントに記述する標準的な方法
WebLogic Web サービスは、XML ベースの仕様である Web Services Description Language（WSDL）1.1 を使用して記述しています。WSDL の詳細については、 WSDL 1.1を参照してください。

添付ファイル付き SOAP 1.1

SOAP（Simple Object Access Protocol）は、分散型環境で情報を交換するために使用する軽量 XML ベースのプロトコルです。プロトコルの構成は次のとおりです。

SOAP メッセージを記述するエンベロープ。特に、メッセージの本文を含むエンベロープは、処理するユーザを識別し、処理方法を記述します。
アプリケーション固有のデータ型のインスタンスを表現するためのエンコーディングルールセット。
リモートプロシージャ呼び出しおよび応答を表す規則。

この情報は、HTTP またはその他の Web プロトコル上で転送可能な Multipurpose Internet Mail Extensions（MIME）エンコードパッケージ内に埋め込まれています。MIME は、非 ASCII メッセージをインターネット上で送信できるようにフォーマットするための仕様です。

次の例は、HTTP リクエスト内に埋め込まれている株取引情報用の SOAP リクエストを示しています。

POST /StockQuote HTTP/1.1
Host: www.sample.com
Content-Type: text/xml; charset="utf-8"
Content-Length: nnnn
SOAPAction: "Some-URI"

<SOAP-ENV:Envelope 
   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
         SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
     <SOAP-ENV:Body>
          <m:GetLastStockQuote xmlns:m="Some-URI">
               <symbol>BEAS</symbol>
          </m:GetLastStockQuote>
     </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

WSDL 1.1

Web Services Description Language（WDSL）は、Web サービスを記述するために使用される XML ベースの仕様です。WSDL ドキュメントは Web サービスによって提供されるメソッド、入力および出力パラメータ、および接続方法を記述します。

WebLogic Web サービスの開発者は、WSDL ファイルを作成する必要はありません。これらのファイルは WebLogic Web サービス開発プロセスの一部として自動的に生成されます。

次の例は参照用で GetLastStockQuote メソッドを含む株取引 Web サービス StockQuoteService を記述する WSDL ファイルを示しています。

<?xml version="1.0"?>
  <definitions name="StockQuote"
               targetNamespace="http://sample.com/stockquote.wsdl"
               xmlns:tns="http://sample.com/stockquote.wsdl"
               xmlns:xsd="http://www.w3.org/2000/10/XMLSchema"
               xmlns:xsd1="http://sample.com/stockquote.xsd"
               xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
               xmlns="http://schemas.xmlsoap.org/wsdl/">
      <message name="GetStockPriceInput">
          <part name="symbol" element="xsd:string"/>
      </message>
      <message name="GetStockPriceOutput">
          <part name="result" type="xsd:float"/>
      </message>
      <portType name="StockQuotePortType">
          <operation name="GetLastStockQuote">
             <input message="tns:GetStockPriceInput"/>
             <output message="tns:GetStockPriceOutput"/>
          </operation>
      </portType>
      <binding name="StockQuoteSoapBinding" type="tns:StockQuotePortType">
          <soap:binding style="rpc" 
                        transport="http://schemas.xmlsoap.org/soap/http"/>
          <operation name="GetLastStockQuote">
             <soap:operation soapAction="http://sample.com/GetLastStockQuote"/>
             <input>
                 <soap:body use="encoded" namespace="http://sample.com/stockquote"
                           encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
             </input>
             <output>
             <soap:body use="encoded" namespace="http://sample.com/stockquote"
                           encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
             </output>
          </operation>>
      </binding>
      <service name="StockQuoteService">
          <documentation>My first service</documentation>
          <port name="StockQuotePort" binding="tns:StockQuoteSoapBinding">
             <soap:address location="http://sample.com/stockquote"/>
          </port>
      </service>
  </definitions>

WebLogic Web サービスの機能

この章では、WebLogic Web サービスサブシステムの機能について説明します。

Web サービスプログラミングモデル

プログラミングモデルには、WebLogic Server によってホストされる Web サービスの実装、アセンブル、デプロイ、および呼び出し方法が記述されています。Web サービスの実際の作業を実行するエンタープライズ JavaBean コードは別として、Web サービス自体のほとんどは、Web サービスのコンポーネントを生成してパッケージ化する Java Ant タスク wsgen を使用して開発できます。

WebLogic Server は、リモートプロシージャ呼び出し（RPC）スタイルとメッセージスタイルの 2 種類の Web サービスをサポートします。

RPC スタイル Web サービス

リモートプロシージャ呼び出し（RPC）スタイル Web サービスは、ステートレスセッション EJB を使用して実装されます。これは、クライアントアプリケーションへのリモートオブジェクトになります。

クライアントと RPC スタイル Web サービスとの対話は、サービス固有のインタフェースに集中します。クライアントが Web サービスを起動すると、パラメータ値が Web サービスに送信され、必要なメソッドが実行されて戻り値が送り返されます。クライアントと Web サービス間のこの対話により、RPC スタイル Web サービスは密に結合され、RMI または DCOM などの従来の分散型オブジェクトパラダイムと類似したものになります。

RPC スタイル Web サービスは同期です。つまり、クライアントがリクエストを送信したときは応答があるまで何もしないで待機します。

メッセージスタイル Web サービス

メッセージスタイル Web サービスは、メッセージ駆動型 Bean などの JMS メッセージリスナを使用して実装され、JMS の送り先と関連付けられている必要があります。

メッセージスタイル Web サービスは疎結合で、サービス固有のインタフェースに関連付けられるのではなく、ドキュメント駆動型です。クライアントがメッセージスタイル Web サービスを起動すると、クライアントでは一般的にディスクリートなパラメータのセットではなく発注書などの全ドキュメントを送信します。Web サービスでは、ドキュメント全体を受け入れて処理し、結果メッセージを返す場合と返さない場合があります。クライアントと Web サービス間のリクエストと応答が密に結合されていないため、メッセージスタイル Web サービスではクライアントとサーバ間の結合が緩やかになります。

メッセージスタイル Web サービスは非同期です。Web サービスを呼び出すクライアントは、応答を待機しません。Web サービスからの応答がある場合は、数時間または数日後に示されることもあります。

クライアントは、メッセージスタイル Web サービスとの間でドキュメントの送信も受信も実行できますが、同じ Web サービスを使用して両方を行うことはできません。

SOAP 1.1 の実装

WebLogic Server には、開発者が Web サービスを呼び出すクライアントを作成するために使用できる独自の SOAP 1.1 および添付ファイル付き SOAP 1.1 仕様実装があります。

RPC スタイル Web サービスでは、SOAP 1.1 メッセージフォーマットを使用し、メッセージスタイル Web サービスでは、添付ファイル付き SOAP 1.1 メッセージフォーマットを使用します。

注意: 現在 WebLogic Web サービスでは、添付ファイル付き SOAP メッセージの実際の添付ファイルは無視されます。

Web サービス実行時コンポーネント

WebLogic Web サービス実行時コンポーネントは、Web サービスの作成に必要なサーブレットと関連インフラストラクチャのセットです。実行時の要素の 1 つは、クライアントからの SOAP リクエストを処理するサーブレットのセットです。これらのサーブレットは、WebLogic Server 配布キットに含まれているため、記述する必要はありません。実行時のもう一つの要素は、WebLogic Web サービスのすべてのコンポーネントを生成しアセンブルする Ant タスクです。

標準化 J2EE Web サービスアセンブリおよびデプロイメント

Web サービス開発者は、wsgen という Ant タスクと Administration Console を使用し、Web サービスを標準 J2EE エンタープライズアプリケーションとして *.ear ファイルにアセンブルおよびデプロイします。*.ear ファイルには、EJB、SOAP サーブレットへの参照、web.xml ファイル、weblogic.xml ファイルなど、Web サービスのすべてのコンポーネントが含まれます。

WSDL ファイルの生成

WebLogic Web サービスを呼び出すクライアントを作成する開発者には、Web サービスを記述する WSDL が必要です。WebLogic Server では、デプロイされた Web サービスの WSDL を自動的に生成します。Web サービスの WSDL には、特別な URL を介してアクセスします。

WebLogic Web サービスを呼び出す Java クライアント

WebLogic Server は、開発者が Web サービスを呼び出す Java クライアントを開発するために使用するシン Java クライアントを自動的に生成できます。Java クライアント JAR ファイルには、Web サービスを呼び出すために必要なすべてのクラスがあります。これらのクラスには、Java クライアント API クラスおよびインタフェース、SOAP リクエストおよび応答を解析するパーサ、EJB への Java インタフェースなどがあります。この Java クライアント JAR ファイルを使用して Web サービスを呼び出すクライアントアプリケーションは、クライアントコンピュータ上に完全な WebLogic Server JAR ファイルを持っている必要はありません。

Java クライアント JAR ファイルは、WebLogic Web サービスのホームページからダウンロードできます。この Web ページの詳細については、 WebLogic Web サービスの呼び出しの WebLogic Web サービスホームページの呼び出しを参照してください。

注意: BEA では現在、クライアント機能をサーバ機能と別個にはライセンスしていないため、必要な場合には、この Java クライアント JAR ファイルをユーザ自身の顧客に再配布できます。

Web サービスの作成および呼び出し例

WebLogic Server には、RPC スタイル Web サービスおよびメッセージスタイル Web サービスを作成する両方の例と、Web サービスを呼び出す Java および Microsoft VisualBasic クライアントアプリケーションの両方の例があります。

これらの例は、BEA_HOME\samples\examples\webservices ディレクトリにあります。BEA_HOME は、メイン WebLogic Server インストールディレクトリを指します。RPC スタイル Web サービスの例は rpc ディレクトリにあり、メッセージスタイル Web サービスの例は message ディレクトリにあります。

例を作成して実行する方法の詳細については、ブラウザで Web ページ BEA_HOME\samples\examples\webservices\package-summary.html を呼び出してください。

WebLogic Web サービスのアーキテクチャ

WebLogic Web サービスを開発するときは、ステートレスセッション EJB、メッセージ駆動型 Bean、および JMS の送り先などの標準 J2EE コンポーネントを使用します。WebLogic Web サービスは完全に J2EE プラットフォームに基づいているため、簡単で一般的なコンポーネントベースの開発モデル、優れたスケーラビリティ、トランザクションのサポート、自動ライフサイクル管理、既存のエンタープライズシステムへの J2EE API（JDBC および JTA など）を介した簡単なアクセス、簡単な統一セキュリティモデルなど、すべての標準 J2EE の利点を自動的に継承します。

WebLogic Server Web サービスは、次の特定のコンポーネントから構成される標準 J2EE エンタープライズアプリケーションとしてパッケージ化されます。

少なくとも SOAP メッセージをクライアントとの間で送受信するサーブレットを含む Web アプリケーション
このサーブレットは、Web サービス開発プロセスの一部となっているため、開発者が自分で記述することはありません。
RPC スタイル Web サービスを実装するステートレスセッション EJB またはメッセージスタイル Web サービス用の JMS リスナ（メッセージ駆動型 Bean など）
RPC スタイルサービスでは、ステートレスセッション EJB が Web サービスの実際の作業のすべてを実行するか、または他の EJB に作業を分配します。Web サービスの実装によって、どの EJB が実際の作業を行うかが決まります。メッセージスタイル Web サービスでは、J2EE オブジェクト（一般的にメッセージ駆動型 Bean）が JMS の送り先からメッセージを取得して処理します。

WebLogic Web サービスは、Web アプリケーションの Web アーカイブ（*.war）ファイルおよび EJB アーカイブ（*.jar）ファイルを含むエンタープライズアーカイブ（*.ear）ファイルとしてパッケージ化されます。

次の 2 つの節では、RPC スタイルおよびメッセージスタイル Web サービスのアーキテクチャについて説明します。

RPC スタイル WebLogic Web サービスアーキテクチャ

図 1-1 は、RPC スタイル WebLogic Web サービスのアーキテクチャを示しています。

図1-1 RPC スタイル WebLogic Web サービスアーキテクチャ

クライアントが RPC スタイル WebLogic Web サービスを呼び出すときの動作を次に示します。

クライアントは HTTP/HTTPS を介して SOAP メッセージを WebLogic Server に送信します。SOAP メッセージには、RPC スタイル Web サービスを呼び出すための Web サービスの WSDL に準拠した指示が含まれます。
SOAP サーブレット（クライアントによって呼び出される Web アプリケーションの一部）は、RPC SOAP リクエストを処理するために設計されており、SOAP メッセージエンベロープを開き、その情報に従って適切なステートレスセッション EJB ターゲットを識別します。次に、このサーブレットではパラメータのマーシャリングを解除して適切な Java オブジェクトにバインドし、ターゲットステートレスセッション EJB を呼び出してパラメータに渡します。
ステートレスセッション EJB では、Web サービスのすべての作業を実行するか、部分的またはすべての作業を他の EJB に分配します。
呼び出されたステートレスセッション EJB は、戻り値がある場合にはそれを RPC SOAP サーブレットに送信します。
RPC SOAP サーブレットは、戻り値をステートレスセッション EJB から SOAP メッセージにマーシャリングし、HTTP/HTTPS を介してクライアントに戻します。
エラーが発生した場合、RPC SOAP サーブレットは SOAP エラーメッセージ（SOAP 障害）もクライアントに送信します。

メッセージスタイル WebLogic Web サービスアーキテクチャ

メッセージスタイル Web サービスでは、一方向通信をサポートします。クライアントアプリケーションは Web サービスからドキュメントを受け取るか、または Web サービスにドキュメントを送信しますが、単一メッセージスタイル Web サービスでクライアントが両方を行うことは許可されません。メッセージスタイル Web サービスを開発するときに、クライアントが Web サービスにメッセージを送信するか、または Web サービスからメッセージを受信するかを指定します。送信用と受信用の 2 つのメッセージスタイル Web サービスを結合して双方向通信をサポートすることができます。同じクライアントが両方のタイプ、またはいずれかのタイプのサービスを使用することができます。

図 1-2 は、メッセージスタイル WebLogic Web サービスの両方のスタイルが一緒に機能するアーキテクチャを示しています。

注意: 点線は、2 つの異なるメッセージスタイル Web サービスをカプセル化します。JMS の送り先からメッセージを取り出すのにメッセージ駆動型 Bean を使用する必要はありませんが、一般的には最適な方法です。

図1-2 メッセージスタイル WebLogic Web サービスアーキテクチャ

クライアントがメッセージスタイル WebLogic Web サービスを呼び出すときの動作を次に示します。

クライアントは HTTP/HTTPS を介して SOAP メッセージを WebLogic Server に送信します。SOAP メッセージには、メッセージスタイル Web サービスを呼び出すための Web サービスの WSDL に準拠した指示が含まれます。
クライアントによって呼び出される Web アプリケーションの一部であるメッセージング SOAP サーブレットは、SOAP メッセージエンベロープを開いて、メッセージの本文をデコードし、結果オブジェクトを適切な JMS の送り先に配置します。
注意: WebLogic Server 6.1 では、添付ファイル付き SOAP 1.1 メッセージの添付ファイルの内容にアクセスすることはサポートしていません。
メッセージは、適切な JMS リスナ（一般的にはメッセージ駆動型 Bean）によって取り出されるまで JMS の送り先に残ります。
メッセージ駆動型 Bean は、メッセージを JMS の送り先から取り出します。メッセージ駆動型 Bean では、Web サービスのすべての作業を実行するか、部分的またはすべての作業を他の EJB に分配します。
メッセージ駆動型 Bean は、クライアントでメッセージを受信するようにコンフィグレーションされた別のメッセージスタイル Web サービスに関連付けられている別の JMS の送り先に、結果ドキュメントを送信します。
2 番目の Web サービスに関連付けられているメッセージング SOAP サーブレットは、メッセージを JMS の送り先から取り出します。
メッセージング SOAP サーブレットは、クライアントが 2 番目の受信 Web サービスを呼び出したときにドキュメントをクライアントに送り返します。

このサンプルアーキテクチャは、クライアントと情報を送受信するために一緒に機能する 2 つのメッセージスタイル Web サービスを示しています。クライアントは、2 つのメッセージスタイル Web サービスを呼び出す必要があります。

WebLogic Web サービスでサポートされていない SOAP および WSDL 機能

次の SOAP 機能は、WebLogic Web サービスではサポートされていません。

Header 要素 - WebLogic Web サービスのクライアント API を使って、SOAP の Header 要素を設定または取得することはできません。さらに、内部の WebLogic Web サービスランタイムは、SOAP の Header 要素を無視します。処理されるのは SOAP の Body 要素だけです。
SOAP添付ファイル

次の WSDL 機能は、WebLogic Web サービスではサポートされていません。

import 要素
part 要素の element 属性

XML ファイルの編集

WebLogic Web サービスを作成する際または呼び出す際は、EJB デプロイメント記述子、Java Ant ビルドファイルなどの XML ファイルを編集しなければならない場合があります。これらのファイルを編集するには、BEA が提供する BEA XML エディタを使用します。BEA XML エディタは、完全な Java ベースのスタンドアロン XML エディタです。

BEA XML エディタは、XML ファイルを作成および編集するためのシンプルでユーザフレンドリなツールです。このツールでは、XML ファイルの中身を、階層的な XML ツリー構造と実際の XML コードの両方で表示します。ドキュメントを 2 通りに表示することにより、以下の 2 つの方法で XML ドキュメントを編集できます。

階層ツリー表示では、階層 XML ツリー構造の各ポイントでいくつかの指定可能な機能を使用する形で、構造化された制約のある編集が可能です。指定可能な機能は、構文的に決定されており、指定されているものがある場合は XML ドキュメントの DTD またはスキーマに従っています。
XML コード表示では、データを自由に編集できます。

BEA XML エディタは、指定した DTD または XML スキーマを基に XML コードを検証します。

使用方法の詳細については、BEA XML エディタのオンラインヘルプを参照してください。

BEA XML エディタは、BEA dev2devからダウンロードできます。