7.7 リソース・テンプレートの管理

リソース・テンプレートは、URIをグループ化して、特定のRESTfulサービス・モジュールに関連付ける方法です。

リソース・テンプレートには、1つ以上のリソース・ハンドラを含むことができます。1つのHTTPメソッドに指定できるリソース・ハンドラは1つのみです。たとえば、リソース・テンプレートには、1つのGETメソッドや1つのDELETEメソッドのみを指定できます。

• リソース・テンプレートの追加
  ORDS RESTfulサービス・モジュールにリソース・テンプレートを追加する方法を学習します。
• リソース・テンプレートの編集
  リソース・テンプレートを編集する方法を学習します。
• リソース・テンプレートの削除
  リソース・テンプレートを削除すると、テンプレートとともに、このテンプレートに関連するすべてのリソース・ハンドラが削除されます。

7.7.1 リソース・テンプレートの追加

ORDS RESTfulサービス・モジュールにリソース・テンプレートを追加する方法を学習します。

ORDS RESTfulサービス・モジュールにリソース・テンプレートを追加するには:

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。

   「RESTfulサービス」ホームページが表示されます。

2. 「ORDSベースのRESTfulサービス」をクリックします。

   ORDS RESTfulサービス・ページが表示されます。

3. リソース・テンプレートの追加先とするORDS RESTfulサービス・モジュールをクリックします。

   モジュール定義ページが表示されます。

4. 左のパネルのリソース・テンプレート・ブロックの下で、「テンプレートの作成」をクリックします。

   ORDSテンプレート定義ページが表示されます。

5. 適切なフィールドに入力し、適切なオプションを選択します。必須フィールドには、赤いアスタリスク(*)が付いています。特定のオプションの詳細は、フィールドレベル・ヘルプを参照してください。
6. 次の項目を指定します。

   • URIテンプレート: Uniform Resource Identifiersを識別するURIテンプレートを入力します。URIテンプレートは、次に示すように、URIを記述する単純な構文です。

     example/:id
     

   • 優先度: テンプレートの評価順序を指定します。高い数値から先に評価されます。

   • HTTPエンティティ・タグ: リソース・バージョンを一意に識別するために使用するエンティティ・タグのタイプを指定します

7. 「テンプレートの作成」をクリックします。

7.7.2 リソース・テンプレートの編集

リソース・テンプレートを編集する方法を学習します。

リソース・テンプレートを編集するには:

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。

   「RESTfulサービス」ホームページが表示されます。

2. 編集するORDS RESTfulサービス・テンプレートをクリックします。

   ORDSテンプレート定義ページが表示されます。

   ORDS RESTfulサービス・ページが表示されます。

3. 必要な変更を行います。
4. 「変更の適用」をクリックします。

関連項目:

「リソース・テンプレートの追加」

7.7.3 リソース・テンプレートの削除

リソース・テンプレートを削除すると、テンプレートとともに、このテンプレートに関連するすべてのリソース・ハンドラが削除されます。

リソース・テンプレートを削除するには:

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。

   「RESTfulサービス」ホームページが表示されます。

2. 「ORDSベースのRESTfulサービス」をクリックします。

   ORDS RESTfulサービス・ページが表示されます。

3. 削除するORDS RESTfulサービス・テンプレートをクリックします。

   ORDSテンプレート定義ページが表示されます。

4. 「削除」をクリックします。
5. 「OK」をクリックして確定します。
6. 「変更の適用」をクリックします。