$catalog
カタログには、プロジェクトで利用可能なすべてのデータクラス、属性、インタープロセス (共有) シングルトン が記述されています。
使用可能なシンタックス
| シンタックス | 例題 | 説明 |
|---|---|---|
| $catalog | /$catalog | プロジェクト内の 共有シングルトン (あれば) と、データクラスのリストを、2つの URI とともに返します。 |
| $catalog/$all | /$catalog/$all | プロジェクト内の 共有シングルトン (あれば) と、すべてのデータクラスおよびそれらの属性の情報を返します。 |
| $catalog/{dataClass} | /$catalog/Employee | 特定のデータクラスとその属性の情報を返します。 |
| $catalog/DataStoreClassFunction | /$catalog/authentify | DataStoreクラス関数を実行します (あれば) |
$catalog
プロジェクト内の 共有シングルトン (あれば) と、データクラスのリストを、2つの URI とともに返します。1つはデータクラスのストラクチャー情報にアクセスするためのもので、もう 1つはデータクラスのデータを取得するためのものです。
説明
$catalog を呼び出すと、プロジェクトのデータストア内のデータクラスのリストを、データクラス毎に 2つの URI とともに返します。
プロジェクトのデータストア内の、公開されているデータクラスのみがリストされます。 詳細については、テーブルやフィールドの公開 を参照してください。
データクラス毎に返されるプロパティの説明です:
| プロパティ | 型 | 説明 |
|---|---|---|
| name | Text | データクラスの名称。 |
| uri | Text | データクラスとその属性に関する情報を取得するための URI です。 |
| dataURI | Text | データクラスのデータを取得するための URI です。 |
例題
GET /rest/$catalog
結果:
{
dataClass: [
{
name: "Company",
uri: "http://127.0.0.1:8081/rest/$catalog/Company",
dataURI: "http://127.0.0.1:8081/rest/Company"
},
{
name: "Employee",
uri: "http://127.0.0.1:8081/rest/$catalog/Employee",
dataURI: "http://127.0.0.1:8081/rest/Employee"
}
]
}
$catalog/$all
プロジェクト内の 共有シングルトン (あれば) と、すべてのデータクラスおよびそれらの属性の情報を返します。
説明
$catalog/$all を呼び出すと、プロジェクトのデータストア内の各データクラスについて属性の情報を取得します。
各データクラスと属性について取得される情報についての詳細は $catalog/{dataClass} を参照ください。
例題
GET /rest/$catalog/$all
結果:
{
"dataClasses": [
{
"name": "Company",
"className": "Company",
"collectionName": "CompanySelection",
"tableNumber": 2,
"scope": "public",
"dataURI": "/rest/Company",
"attributes": [
{
"name": "ID",
"kind": "storage",
"fieldPos": 1,
"scope": "public",
"indexed": true,
"type": "long",
"identifying": true
},
{
"name": "name",
"kind": "storage",
"fieldPos": 2,
"scope": "public",
"type": "string"
},
{
"name": "revenues",
"kind": "storage",
"fieldPos": 3,
"scope": "public",
"type": "number"
},
{
"name": "staff",
"kind": "relatedEntities",
"fieldPos": 4,
"scope": "public",
"type": "EmployeeSelection",
"reversePath": true,
"path": "employer"
},
{
"name": "url",
"kind": "storage",
"scope": "public",
"type": "string"
}
],
"key": [
{
"name": "ID"
}
]
},
{
"name": "Employee",
"className": "Employee",
"collectionName": "EmployeeSelection",
"tableNumber": 1,
"scope": "public",
"dataURI": "/rest/Employee",
"attributes": [
{
"name": "ID",
"kind": "storage",
"scope": "public",
"indexed": true,
"type": "long",
"identifying": true
},
{
"name": "firstname",
"kind": "storage",
"scope": "public",
"type": "string"
},
{
"name": "lastname",
"kind": "storage",
"scope": "public",
"type": "string"
},
{
"name": "employer",
"kind": "relatedEntity",
"scope": "public",
"type": "Company",
"path": "Company"
}
],
"key": [
{
"name": "ID"
}
]
}
]
}
$catalog/{dataClass}
特定のデータクラスとその属性の情報を返します。
説明
$catalog/\{dataClass\} を呼び出すと、指定したデータクラスとその属性について詳細な情報が返されます。 プロジェクトのデータストア内のすべてのデータクラスに関して同様の情報を得るには $catalog/$all を使います。
返される情報は次の通りです:
- データクラス
- 属性
- メソッド (あれば)
- プライマリーキー
DataClass
公開されているデータクラスについて、次のプロパティが返されます:
| プロパティ | 型 | 説明 |
|---|---|---|
| name | Text | データクラスの名称 |
| collectionName | Text | データクラスにおいて作成されるエンティティセレクションの名称 |
| tableNumber | Number | 4Dデータベース内のテーブル番号 |
| scope | Text | データクラスのスコープ (公開 (public) に設定されているデータクラスのみ返されます) |
| dataURI | Text | データクラスのデータを取得するための URI |
属性
公開されている各属性について、次のプロパティが返されます:
| プロパティ | 型 | 説明 |
|---|---|---|
| name | Text | 属性の名称 |
| kind | Text | 属性タイプ (ストレージ (storage) またはリレートエンティティ (relatedEntity)) |
| fieldPos | Number | データベーステーブルのフィールド番号 |
| scope | Text | 属性のスコープ (公開 (public) に設定されている属性のみ返されます) |
| indexed | Text | 属性に インデックス が設定されていれば、このプロパティは true を返します。 それ以外の場合には、このプロパティは表示されません。 |
| type | Text | 属性タイプ (bool, blob, byte, date, duration, image, long, long64, number, string, uuid, word)、または、N->1 リレーション属性の場合はリレーション先のデータクラス |
| identifying | Boolean | 属性がプライマリーキーの場合、プロパティは true を返します。 それ以外の場合には、このプロパティは表示されません。 |
| path | Text | relatedEntity 属性の場合はデータクラス名、relatedEntities 属性の場合はリレーション名 |
| foreignKey | Text | relatedEntity 属性の場合、リレート先の属性名 |
| inverseName | Text | relatedEntity または relatedEntities 属性の逆方向リレーション名 |
プライマリーキー
key オブジェクトには、データクラスの プライマリーキー として定義された属性の 名称 (name プロパティ) が返されます。
例題
特定のデータクラスに関する情報を取得します。
GET /rest/$catalog/Employee
結果:
{
name: "Employee",
className: "Employee",
collectionName: "EmployeeCollection",
scope: "public",
dataURI: "http://127.0.0.1:8081/rest/Employee",
defaultTopSize: 20,
extraProperties: {
panelColor: "#76923C",
__CDATA: "\n\n\t\t\n",
panel: {
isOpen: "true",
pathVisible: "true",
__CDATA: "\n\n\t\t\t\n",
position: {
X: "394",
Y: "42"
}
}
},
attributes: [
{
name: "ID",
kind: "storage",
scope: "public",
indexed: true,
type: "long",
identifying: true
},
{
name: "firstName",
kind: "storage",
scope: "public",
type: "string"
},
{
name: "lastName",
kind: "storage",
scope: "public",
type: "string"
},
{
name: "fullName",
kind: "calculated",
scope: "public",
type: "string",
readOnly: true
},
{
name: "salary",
kind: "storage",
scope: "public",
type: "number",
defaultFormat: {
format: "$###,###.00"
}
},
{
name: "photo",
kind: "storage",
scope: "public",
type: "image"
},
{
name: "employer",
kind: "relatedEntity",
scope: "public",
type: "Company",
path: "Company"
},
{
name: "employerName",
kind: "alias",
scope: "public",
type: "string",
path: "employer.name",
readOnly: true
},
{
name: "description",
kind: "storage",
scope: "public",
type: "string",
multiLine: true
},
],
key: [
{
name: "ID"
}
]
}
シングルトン
1つ以上の 公開関数 を含む 共有シングルトン を定義している場合、/$catalog と /$catalog/$all の両方の構文で、返される json に singletons セクションが追加されます。 コレクションの形でまとめられたシングルトンクラスは、それぞれ name (クラス名) と method (公開関数名) を持つオブジェクト要素として格納されます。
シングルトン関数は、$singleton コマンド を使用した RESTリクエストで呼び出すことができます。
例題
GET /rest/$catalog/$all
結果:
{...
singletons": [
{
"name": "VehicleFactory",
"methods": [
{
"name": "buildVehicle",
"allowedOnHTTPGET": false,
"exposed": true
}
]
}
],
dataClasses: [...]
}