例: 既存のRESTサービス・コンポーネントの有効化

RESTバインディング構成ウィザードの「構成ショートカット」からRESTコンポーネントやサービスの有効化 オプションを使用して、既存のRESTサービス・コンポーネントを有効化できます。

1. SOAコンポジット・エディタの「公開されたサービス」スイムレーンを右クリックし、「挿入」→「REST」を選択します。

   RESTバインディング構成ウィザードが表示されます。

2. 「サービスはWSDLインタフェースを使用してコンポーネントを起動します」を選択します。

3. 「次へ」をクリックします。

4. 「構成ショートカット」でRESTコンポーネントやサービスの有効化を選択します。

   「サービス・エクスプローラ」ダイアログが表示されます。

5. ナビゲータを開いて、サービス・コンポーネントのWSDL (この例ではBPELプロセス)を選択し、「OK」をクリックします。この操作で、WSDL操作をリソース・パスおよびHTTP動詞にマッピングできます。

   図37-1 REST操作をリソース・パスおよびHTTP動詞にマッピングするために選択されたWSDL

   
   「図37-1 REST操作をリソース・パスおよびHTTP動詞にマッピングするために選択されたWSDL」の説明

   RESTバインディング構成ウィザードの「リソース」ページが更新され、図37-2に示すように表示されます。

   選択したWSDLが読み取られ、WSDL操作が、「操作バインディング」セクションのリソース・パスおよびHTTP動詞にマッピングされます。「リソース・パス」および「HTTP動詞」セクションには、構成マッピングを追加する必要があることに注意してください。これは、「完了」列の「いいえ」の値でも示されます。

   図37-2 RESTバインディング構成ウィザードの「リソース」ページ

   
   「図37-2 RESTバインディング構成ウィザードの「リソース」ページ」の説明

   今度は、各操作のリソース・パスおよびHTTP動詞を構成する必要があります。この例では、操作は1回のみです。WSDLによっては、「操作」列に複数の操作が表示される可能性があります。

6. 「リソース」セクションの「リソース・パス」表で、「/」のデフォルト・パス・エントリをダブルクリックします。操作バインディングを開始する前にリソース・パスを定義することもできます。この場合、選択されているリソースが新しいバインディングに使用されます。

   「RESTリソースの更新」が起動します。

7. 「相対パス」フィールドで、リソース・パス(この例では/orders)を入力し、「OK」をクリックします。

   図37-3 「RESTリソースの更新」ダイアログ

   
   「図37-3 「RESTリソースの更新」ダイアログ」の説明

   古いリソース・パスを持つ操作マッピングが、「リソース」セクションおよび「操作バインディング」セクション(この例では、/orders)の新しいリソース・パスで更新されます。既存のコンポーネントを更新する場合は、通常はすべての操作が更新されます。

   必要に応じて、「リソース」セクションの「追加」アイコンをクリックし、「RESTリソースの作成」ダイアログを表示して、追加のリソース・パスを作成できます。

   今度は、「操作バインディング」セクションの「HTTP動詞」列を構成する必要があります。

8. 「操作バインディング」セクションで操作を選択して、「編集」をクリックします。

   「REST操作バインディング」ダイアログが表示されます。このダイアログを使用して、操作のHTTP動詞を選択し、HTTP動詞およびリソースをWSDL操作にバインドしてRESTパラメータをコンポーネント・サービスのWSDLスキーマにマッピングするために「URIパラメータ」セクションに移入できます。「REST操作バインディング」ダイアログを参照してください。

9. 必要に応じて、「リソース」リストで新しいリソースを選択します。

   「URIパラメータ」セクションが更新され、選択内容が反映されます。

10. 「HTTP動詞」リストで操作(この例ではGET)を選択します。

    「URIパラメータ」セクションが更新され、選択内容が反映されます。

    スタイル(queryまたはtemplate)は、「URIパラメータ」セクションの「スタイル」列で自動的に選択されます。

    テンプレート変数を含む新規RESTリソースを選択または作成する場合、Oracle JDeveloperでは、同じ名前のテンプレート・パラメータの作成を試みます。その名前のパラメータがすでに存在する場合、その名前が再使用されます(また、問合せパラメータだった場合はテンプレート・パラメータになります)。重複したパラメータ名は決して作成されません。重複したパラメータが手動で作成されると、エラーが返されます。

11. 「レスポンス」タブをクリックして、HTTPステータス・コード、ペイロード出力タイプ、スキーマおよびフォルト・バインディングの詳細を表示します。スキーマはこの例ですでに定義したので、選択項目の編集が無効になっています。

12. フォルト名をダブルクリックして、「RESTフォルト・バインディング」ダイアログを表示します。このダイアログの詳細は、「ヘルプ」アイコンをクリックするか、「RESTフォルト・バインディングに関する必知事項」を参照してください。

13. 必要に応じて編集し、「OK」をクリックします。

14. 「OK」をクリックして「リソース」ページに戻ります。追加したHTTP動詞が表示されます。

15. 「操作バインディング」セクションで、操作を選択し、「編集」をクリックして、残りの操作についてもリソースおよびHTTP動詞を定義します。

16. 「OK」をクリックしてSOAコンポジット・エディタに戻ります。

    RESTサービスはBPELプロセス・サービス・コンポーネントに接続されます。