WSDL ファイル : Web サービスの記述

WSDL という拡張子の付いたファイルには、Web Service Description Language(WSDL)で表された Web サービス インタフェースが含まれます。WSDL は、World Wide Web Consortium(W3C)によって設定された標準の XML 文書型です(詳細については www.w3.org を参照)。

WSDL ファイルは、Web サービス プロデューサとコンシューマの間でインタフェース情報をやり取りする場合に使用されます。インタフェースを使用することで、サービスのソース コードを処理することなく、サービスの機能を利用できます。

WSDL ファイルの内容

WSDL ファイルには、クライアントが Web サービスのメソッドを呼び出すのに必要なすべての情報が含まれます。WSDL ファイルで定義される情報は、以下のとおりです。

WSDL ファイルのインポート

WebLogic Workshop で構築されていない別の Web サービスを使用する場合は、まず、使用する Web サービスの WSDL ファイルを取得する必要があります。パブリックな Web サービスの場合、WSDL は通常、その Web サービスをパブリッシュしている組織の Web サイトで入手できます。プライベートな Web サービスの場合は、その Web サービスをサポートしている組織に問い合わせて、WSDL ファイルを取得します。

WSDL ファイルは、パブリックな UDDI レジストリおよびプライベートな UDDI レジストリを通じても入手できます。UDDI の詳細については、http://www.uddi.org を参照してください。

WSDL ファイルを入手したら、WebLogic Workshop を使用して、サービス コントロールを作成できます。その後、他の WebLogic Workshop コントロールと同じようにそのサービス コントロールを Web サービスから使用できます。

注意 : Web サービス ツールの中には、XML 宣言 を含まない WSDL ファイルを生成するものもあります。WebLogic Workshop では、すべての XML ファイルに XML 宣言が含まれている必要があります。XML 宣言は、次のような形式で XML ファイルの最初の行に置かれます。

<?xml version="1.0" encoding="utf-8" ?>

XML 宣言を持たない WSDL ファイルを受け取った場合、その WSDL ファイルを WebLogic Workshop で使用するには、テキスト エディタで XML 宣言を追加する必要があります。

encoding 属性は必須ではありません。encoding 属性が指定されていない場合のデフォルト エンコーディングは、utf-8 になります。

注意 : WebLogic Platform 7.0 サービス パック 2 では、WebLogic Workshop は複数のサービス定義を含む WSDL ファイルを受け入れます。ただし、WSDL ファイルで最初に定義されたサービスのサービス コントロールだけが生成され、生成された CTRL ファイルに警告メッセージが書き込まれます。

WSDL ファイルから CTRL ファイルを生成する詳細については、WSDL ファイルからサービス コントロールを作成するを参照してください。

CTRL ファイルの詳細については、CTRL ファイル : コントロールを実装するを参照してください。

使用する Web サービスが WebLogic Workshop で構築されている場合は、JWS ファイルから直接、サービス コントロールの CTRL ファイルを使用できます。

サービス コントロールの詳細については、サービス コントロール : 他の Web サービスを使用するを参照してください。

WSDL ファイルの生成

Web サービスを他の Web サービスで使用できるようにするには、Web サービスの WSDL ファイルを生成して、それをサービスのクライアントで使用できるようにします。

WSDL ファイルを生成する詳細については、Web サービスの WSDL ファイルをパブリッシュするにはを参照してください。

クライアントが WebLogic Workshop で構築されている Web サービスである場合は、使用する Web サービスの JWS ファイルから直接生成されたサービス コントロールの CTRL ファイルを、クライアントで使用できます。

CTRL ファイルの詳細については、CTRL ファイル : コントロールを実装するを参照してください。

サービス コントロールの詳細については、サービス コントロール : 他の Web サービスを使用するを参照してください。

関連トピック

WebLogic Workshop プロジェクト

W3C WSDL 仕様