11 Webサービス・クライアントのサンプル

この章では、Oracle RTD Webサービスを企業の業務系システムと統合する方法について、NetBeans IDEとOracle RTD DecisionService.wsdlを例に説明します。

Real-Time Decision Serverの統合点は、ゼロ・クライアントの手法でも使用できます。デプロイ済のインライン・サービスの統合点は、Webサービスの定義によって公開されます。

デプロイ済の統合点を同期して起動したり非同期で起動する機能は、Real-Time Decision ServerによってWebサービスとして公開されます。これらの操作の定義は、次の場所からWSDLファイルとして入手できます。

RTD_HOME\deploy\DecisionService\DecisionService.wsdl

WSDLファイルには、使用可能なすべての複合型と操作が定義されています。

Oracle Real-Time Decisionsリリース2.2では構造がわずかに変更されて、デシジョン・サービスがWS-I Basicレベルに準拠するように改良されています。以前のバージョンのWSDLファイルの名前は次のとおりです。

RTD_HOME\deploy\DecisionService\DecisionServiceLegacy.wsdl

新しいWSDLを使用して新しいクライアントを開発することをお薦めしますが、DecisionServiceLegacy.wsdlに定義されているプロトコルにもサーバーはこれまでと同様に対応でき、既存クライアント機能が実現されます。

この章では、NetBeans IDEを使用して、RTD DecisionService WSDLファイルからJava WSDL Webサービス・クライアントを作成する方法について詳細に説明します。また、Webサービス・プロジェクトのMainクラスのコードも示します。

この章には次のトピックが含まれます:

• 第11.1項「前提作業」

• 第11.2項「新しいNetBeans Javaアプリケーション・プロジェクトの作成」

• 第11.3項「用意されているJavaコードの追加およびクライアントのテスト」

11.1 作業前の準備

Webサービス・クライアントで作業を行う前に、次の作業を実行する必要があります。

1. http://www.netbeans.org/downloads/index.htmlからNetBeans IDE (Javaバンドル)をダウンロードします。

2. NetBeans IDEをインストールして起動します。

11.2 新しいNetBeans Javaアプリケーション・プロジェクトの作成

Netbeans IDEで、新しいNetBeans Javaアプリケーション・プロジェクトを作成するには、次の手順を実行します:

1. 上部のメニューで「File」→「New Project」を選択します。

2. 「New Project」ダイアログで次のようにします。

   • 「Categories」で「Java」を選択します。

   • 「Projects」で「Java Application」を選択し、「Next」をクリックします。

3. 「Project」に名前を入力し、「Finish」をクリックします。

   JAX-RPC Webサービス・プラグインのインストール

4. 上部のメニューで「Tools」→「Plugins」→「Available Plugins」を選択します。

5. 「Plugins｜Plugins」ダイアログで「Available Plugins｜Available Plugins」タブをクリックします。

6. 「Web Services plug-in」チェック・ボックスを選択し、「Install」をクリックします。プラグインをインストールします。

   Oracle RTD Webサービス・クライアントの作成

7. 「Projects」エクスプローラで、使用するプロジェクトを右クリックし、 「New」→「Web Service Client...」を選択します。

8. 「New Web Service Client」ダイアログで「Local File」ラジオ・ボタンを選択します。

9. 「Local File:」の横にある「Browse...」ボタンをクリックします。

10. Oracle Real-Time Decisionsインストール内にあるDecisionService.wsdlファイルを探します。

    例:

    C:\OracleBI\RTD\client\Client Examples\Web Service Client Example\DecisionService.wsdl

    C:\OracleBI\RTD\deploy\DecisionService\DecisionService.wsdl

11. 「Client Style」で「JAX-WS Style」を選択します。

12. 「Package」でプロジェクト・パッケージを選択します。

13. 「Finish」をクリックします。

11.3 用意されているJavaコードの追加およびクライアントのテスト

用意されているJavaコードを追加してクライアントをテストするには、次の手順を実行します:

1. 「Projects」エクスプローラで「oracle.rtd.test」パッケージを作成します。

2. このパッケージの下にMainクラスとSecurityHandlerクラスを作成します。RTD_HOME\client\Client Examples\Web Service Client ExampleにあるファイルMain.javaとSecurityHandler.javaと同様に、このサンプルのクラス・コンテンツを使用してください。

   システムによって生成されたMainクラスは削除してかまいません。

3. 「Web Service References」の下にある「DecisionService」を右クリックし、「Configure Handlers...」をクリックします。

4. 「Configure Message Handlers」ウィンドウで「Add」をクリックして、oracle.rtd.test.SecurityHandlerクラスをハンドラとして追加し、「OK」をクリックします。

5. 上部のメニューから「Run」→「Run Main Project」を選択します。

6. IDEの下部にある「Output」タブで出力を確認します。