RESTを介したデータ・アクセスの理解
クライアント・アプリケーションとの間のすべてのデータ・アクセスは、REpresentational State Transfer (REST)呼び出しによって行われます。
Visual Builderユーザー・インタフェースを使用すると、基本的な2種類のデータにアクセスできます:
- Visual Builderのビジネス・オブジェクト。自分で作成し、アプリケーションで使用できます。
- サービス接続(Oracleサービスまたは外部RESTサービス)
ビジネス・オブジェクトを作成すると、GET、POST、PATCHおよびDELETEエンドポイントを使用してREST APIが自動的に作成されます。
サービス接続を作成すると、次のいずれかの方法でREST APIを取得できます:
- サービス・カタログからオブジェクトを選択
- サービス仕様ドキュメントをOpenAPI/SwaggerまたはOracle Application Developer Framework (「ADF)説明」形式)で指定
- エンドポイントURL、HTTPメソッド、およびアクション・ヒントを指定
これらの各メカニズムは、使用するためのREST APIを生成します。 リクエストとレスポンスのペイロード構造をJSON形式で指定することができ、Visual Builderユーザー・インタフェースに公開する問合せパラメータのサブセットを提供することができます。 パラメータは型を持つことができます(ただし、プリミティブと見なされます)。 提供されている「RESTヘルパー・ユーティリティ」を使用して、RESTエンドポイントを呼び出すこともできます。
Visual Builderのデータ・アクセスに対するRESTの使用に関する完全な詳細は、「REST APIを使用したビジネス・オブジェクトへのアクセス」の「ビジネス・オブジェクトへのアクセスの概要」を参照してください。
データバインディング
変数とアクション・チェーンを作成して、アプリケーションからRESTエンドポイントを呼び出し、エンドポイントとの間でデータを取得および送信することができます。 通常、変数のタイプはRESTペイロードの構造と一致します。 ユースケースに一番近い独自の型を定義し、RESTペイロードからその型を使用する変数インスタンスにマッピングするオプションがあります。 たとえば、高度なケースでは、独自のページ設計と一致する変数タイプを定義し、1つ以上のRESTペイロードをそのタイプにマッピングできます。 そのデータをサービスに戻すには、その変数のデータを再度RESTペイロードにマップします。
コンポーネントは変数にバインドされています。 これらの変数には、データがどこから得られたのか、データがどのような目的で使用されたのかに関する固有の知識はありません。 REST呼び出しから変数を取り込むには、そのREST呼び出しを行うアクションからアクション・チェーンをアセンブルし、その変数に結果を割り当てるアクションを行います。 一般的なケースでは、Visual Builderユーザー・インタフェースによって、RESTコールのペイロードと一致するようにその変数の作成が自動化されるため、RESTコールのペイロードをアプリケーション・ページにすばやくバインドできます。 POSTまたはDELETEアクションを処理するには、RESTアクションでアクション・チェーンを構成し、その変数をペイロードとして渡します。