RESTful サービスの JAX-RS リソースの作成

統合オブジェクト用の JAX-RS リソースを作成するには、「ZIETrans プロジェクト」ビューで次のようにします。

使用する統合オブジェクトが含まれるプロジェクトを展開し、続いてソース・フォルダー、IntegrationObject フォルダーを展開します。
統合オブジェクトを右クリックし、「作成」を選択しますRESTfulサービスファイル。ザ・クリエイトRESTfulサービスファイルウィザードが開きます。
「JAX-RS リソース・クラス名と統合オブジェクトの指定」ページの「名前」フィールドに、Source フォルダーに生成する JAX-RS リソース・クラスの名前を指定します。この名前は、汎用 Java™™ クラスの名前構文に従っている必要があります。
オプションで、「警告なしでリソースを上書き」するかどうかを選択します。
[次]をクリックします。
「JAX-RS リソース・クラスの構成」ページの「URI 接尾部」フィールドに、JAX-RS リソースへのマッピングで使用する完全な URI を作成する接尾部を指定します。たとえば、ZIETrans がRESTfulインストールされているサービスは www.myHost.com、ZIETrans プロジェクト (アプリケーション) 名は myApp、URI サフィックスは mySuffix であり、JAX-RS リソースの結果の URI は http://www.myHost.com:9080/ です。 myApp/rest/mySuffix.
注: URI と HTTP メソッドの組み合わせは、定義するすべての JAX-RS リソースの中で固有でなければなりません。そうでない場合、JAX-RS ランタイムは、コンテンツタイプの消費と生成の組み合わせを使用した優先度アルゴリズムに基づいて、呼び出すリソース関数を 1 つだけ選択します (RESTful サービスの JAX-RS リソース・メソッドのカスタマイズ）。
デフォルトでは、「Swagger を有効にする」が選択されています。Swagger サポートを組み込みたくない場合は、これを無効にすることができます。「URI 接尾部を Swagger API 値にコピー」を選択することにより、「URI 接尾部」値を自動的に「Swagger API 値」フィールドコピーできます。「URI 接尾部を Swagger API 値にコピー」のチェック・マークを外せば、新しい値を入力できます。このフィールドの値は ZIETrans ツールキットによって、アノテーション @Api としてそれぞれのサービスに追加されます。
「追加」ボタンをクリックして、少なくとも 1 つのメソッドをリソース・クラスに追加します。JAX-RS の定義RESTfulサービスメソッドウィザードが開きます。
「HTTP メソッド」フィールドで、URI と組み合わせてこの JAX-RS リソース・メソッドへのマップに使用する HTTP メソッド (GET、POST、PUT、DELETE) をドロップダウン・リストから選択します。
このメソッドで統合オブジェクトを呼び出す場合は、「統合オブジェクトの使用 (統合オブジェクトの使用)」ボックスを選択します。統合オブジェクト処理コードを含まない空のメソッドを生成する場合は、このボックスをクリアします。独自のカスタマイズ済みメソッドを作成する場合は、これを行ってください。
「統合オブジェクトの使用」ボックスを選択した場合は、ドロップダウン・リストから、このメソッドで呼び出す統合オブジェクトを選択します。
前のステップで「Swagger を有効にする」を選択した場合は、「Swagger API 演算値」フィールドにテキストを入力できます。このフィールドは、値を指定しない場合は無視されます。このフィールドの値は ZIETrans ツールキットによって、アノテーション @ApiOperation としてそれぞれのメソッドに追加されます。
注: パス /<ZIETranscontextroot>/rest/swagger.json を使用して ZIETrans RESTful Swagger 記述資料にアクセスできます。
[次]をクリックします。
「統合オブジェクトの使用」ボックスを選択した場合は、「統合オブジェクト・プロパティーの選択ページが表示されます。このパラメーターとして公開する入力および出力プロパティを選択します。RESTfulウェブサービス。プロパティーの別名を「別名」フィールドに指定することもできます。「全選択」ボタン、「全選択解除」ボタン、および「デフォルトを選択」ボタンを使用して、プロパティーを選択してください。
注:
1. 単一統合オブジェクトおよび EJB Access Bean のデフォルトは、入力プロパティーについては全マクロ・プロンプト、出力プロパティーについては全マクロ抽出です。
2. チェーニングされた統合オブジェクトのデフォルトは、入力プロパティーについては、全マクロ・プロンプトと hPubLinkKey (必須)、出力プロパティーについては、全マクロ抽出と hPubLinkKey (必須) です。
3. チェーニングされた EJB Access Bean のデフォルトは、入力プロパティーについては、全マクロ・プロンプトと hPubLinkKey および hPubAccessHandle (両者必須)、出力プロパティーについては、全マクロ抽出と hPubLinkKey および hPubAccessHandle (両者必須) です。
4. 統合オブジェクトの接続オーバーライドが Web サービスに公開されるよう指定するには、hPubConnectionOverrides プロパティーや hPubStartPoolName プロパティーなど、デフォルトでは選択されない適切なプロパティーを選択する必要があります。詳細については、接続オーバーライドの指定を参照してください。
5. 他の統合オブジェクト・メソッドの使用について詳しくは、統合オブジェクトを使用したプログラミングを参照してください。
[次]をクリックします。
「JAX-RS リソース・メソッドの構成」ページでは、選択した HTTP メソッドと統合オブジェクトを反映したデフォルトが設定されています。これらのメソッド設定とカスタマイズ方法の詳細については、RESTful サービスの JAX-RS リソース・メソッドのカスタマイズ .次を参照してください。
「終了」をクリックします。
「JAX-RS リソース・クラスの構成」ページの「メソッド」セクションに、追加したメソッドがリストされます。別のメソッドの追加には「追加」ボタンを、選択したメソッドの編集には「編集」ボタンを、選択したメソッドの削除には「除去」ボタンを使用します。
「完了」をクリックすると、ZIETrans が JAX-RS リソース・ファイルを作成し、プロジェクトの Source\restfulserviceclasses フォルダーに格納します。
この手順は、前の手順で Swagger が有効になっている場合にのみ適用されます。REST クラスファイルを開き、以下のようにクラス定義の前に @SwaggerDefinition アノテーションを追加します。
@SwaggerDefinition(basePath="< ZIETransProjName >\<接尾部>”)
さらに、ZIETrans は、RestServlet サーブレットが一致を走査できるようにサービスのリストに JAX-RS リソースを追加します。このリストは、ナビゲータービューで表示可能なWEB-INF/wink-resources.lstファイルに保持されます。
注:
1. プロジェクトで最初の JAX-RS リソースが作成されると、ZIETrans はWEB-INF/wink-resources.lstファイルを作成します。
2. これにより、ZIETrans アプリケーションのデフォルト WAR クラス・ローダー・ポリシーが、「アプリケーションの単一クラス・ローダー」に更新されます。
3. ZIETrans では、JAX-RS ファセットのプロジェクトへの追加も行います。
4. 「RESTful サービス・ファイルの作成」ウィザードを使用せずに JAX-RS リソース・ファイルを手動で作成した場合は、WEB-INF/wink-resources.lst ファイルを更新して、JAX-RS リソースを RestServlet サーブレットにマップする必要があります。