REST.Backend.EMSApi.TEMSClientAPI.QueryResource
Delphi
procedure QueryResource(const AResource: string;
const AQuery: array of string; const AJSONArray: TJSONArray;
AReset: Boolean; const AAddParameters: TProc = nil);
C++
void __fastcall QueryResource(const System::UnicodeString AResource, const System::UnicodeString *AQuery, const System::NativeInt AQuery_High, System::Json::TJSONArray* const AJSONArray, bool AReset, const System::Sysutils::_di_TProc AAddParameters = System::Sysutils::_di_TProc());
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
procedure function |
protected | REST.Backend.EMSApi.pas REST.Backend.EMSApi.hpp |
REST.Backend.EMSApi | TEMSClientAPI |
説明
指定されたリソース タイプのリソースのリストを EMS サーバーに問い合わせます。
QueryResource が受け取るパラメータは次のとおりです。
AResource
: 対象となるリソース タイプです。AQuery
: 等号で区切られたキーと値のペアの文字列(たとえば、"my_parameter=my_value" など)を要素とする文字列配列です。QueryResource では、これらのキー/値ペアをパラメータとして要求に追加します。AJSONArray
: QueryResource で EMS サーバーから取得された結果の格納先です。AReset
: QueryResource で要求パラメータをリセットするか(True
)、それとも、前回の要求のパラメータを基に新しい要求を作成するか(False
)を指定します。たとえば、パラメータが同じで対象リソースだけが異なる問い合わせを 1 つの行で数回実行する場合は、
AReset
としてFalse
を渡してパフォーマンスを向上させることができます。
AAddParameters
(任意指定): 要求の更新に使用できるパラメータなしの手続きです。たとえば、要求にパラメータを追加できます。
例外
例外 | メッセージ | 説明 |
---|---|---|
MasterSecret が必要です |
Authentication が TAuthentication.MasterSecret で、ConnectionInfo.MasterSecret が空の文字列になっています。 | |
セッション トークンが必要です |
Authentication が TAuthentication.Session で、かつ、ログインが行われなかったか、Login の呼び出し時に渡されたセッション認証トークンが空の文字列になっています。 |