Embarcadero RAD Studio は、Delphi およびC++Builder アプリケーション用の開発環境を提供します。CData FireDAC Components for JSON を利用してRAD Studio 内のライブJSON にアクセスし、データの取得と更新の両方に使用できるテーブル、ビュー、ストアドプロシージャにデータを抽象化します。この記事では、JSON への接続と、フォームデザイナを使用した簡単なVCL アプリケーションの作成について説明します。
VCL Application for JSON データを作成する
以下の手順では、、シンプルなVCL フォームアプリケーションを作成する方法を示しています。これにより、フォームデザイナを使用し、任意のアプリケーションからJSON に接続するために必要である基本的なFireDAC オブジェクトを示すことができます。
次の例では、TDBGrid コントロールを設定します。
- 新しいVCL フォームアプリケーションを作成します。
- TFDPhysJSONDriverLink およびTFDConnection オブジェクトをフォームにドロップします。
TFDConnection オブジェクトをダブルクリックします。［FireDAC Connection Editor］が表示されます。［DriverId］メニューの［CData.JSON］を選択し、接続プロパティを構成します。
データソースへの認証については、ヘルプドキュメントの「はじめに」を参照してください。本製品は、JSON API を双方向データベーステーブルとして、JSON ファイルを読み取り専用ビュー（ローカル ファイル、一般的なクラウドサービスに保存されているファイル、FTP サーバー）としてモデル化します。HTTP Basic、Digest、NTLM、OAuth、FTP などの主要な認証スキームがサポートされています。詳細はヘルプドキュメントの「はじめに」を参照してください。
URI を設定して認証値を入力したら、DataModel を設定してデータ表現とデータ構造をより厳密に一致させます。
DataModel プロパティは、データをどのようにテーブルに表現するかを制御するプロパティで、次の基本設定を切り替えます。
- Document（デフォルト）：JSON データのトップレベルのドキュメントビューをモデル化します。本製品 は、ネストされたオブジェクト配列を集約されたJSON オブジェクトとして返します。
- FlattenedDocuments：ネストされた配列オブジェクトと親オブジェクトを、単一テーブルに暗黙的に結合します。
- Relational：階層データから個々の関連テーブルを返します。テーブルには、親ドキュメントにリンクする主キーと外部キーが含まれています。
リレーショナル表現の設定についての詳細は、ヘルプドキュメントの「JSON データのモデリング」を参照してください。また、以下の例で使用されているサンプルデータも確認できます。データには人や所有する車、それらの車に行われたさまざまなメンテナンスサービスのエントリが含まれています。
- TFDQuery オブジェクトをフォームにドロップし、以下のプロパティを設定します。
- 接続 - オブジェクトが未指定の場合、このプロパティをTFDConnection オブジェクトに設定します。
- SQL - SQL プロパティのボタンをクリックし、クエリを入力します。
- アクティブ - このプロパティをtrue に設定します。
- TDataSource オブジェクトをフォームにドロップし、以下のプロパティを設定します。
- データセット - このプロパティのメニューで、TFDQuery オブジェクトの名前を選択します。
- TDBGrid オブジェクトをフォームにドロップし、以下のプロパティを設定します。
- データソース - TDataSource の名前を選択します。
TFDGUIxWaitCursor をフォームにドロップします。これは、実行時のエラーを回避するために必要です。
これで、TFDQuery オブジェクトに設定されたSQL クエリの結果を表示する、実行可能なアプリケーションが構築されます。
