67 lines
1.6 KiB
Markdown
67 lines
1.6 KiB
Markdown
# Object Expression
|
|
|
|
object expression は、名前付き field の集合を表す。
|
|
|
|
```dcdl
|
|
{
|
|
host = "127.0.0.1";
|
|
port = 8000;
|
|
}
|
|
```
|
|
|
|
object は設定値にもスキーマにも使う。
|
|
|
|
```dcdl
|
|
MyConfig = {
|
|
host = String;
|
|
port = Int default 8080;
|
|
};
|
|
```
|
|
|
|
## Dot-path Field
|
|
|
|
ネストした field はドットパスでも定義できる。
|
|
|
|
```dcdl
|
|
{
|
|
feature_hoge.enable = false;
|
|
}
|
|
```
|
|
|
|
これは以下と同じ構造を表す。
|
|
|
|
```dcdl
|
|
{
|
|
feature_hoge = {
|
|
enable = false;
|
|
};
|
|
}
|
|
```
|
|
|
|
## Map constraint
|
|
|
|
連想配列の制約は、object の任意の field value に同じ schema を適用する。
|
|
|
|
```dcdl
|
|
Services = {...{
|
|
port = Int;
|
|
enabled = Bool default true;
|
|
}};
|
|
```
|
|
|
|
`{...T}` は key の集合を固定せず、すべての value が `T` を満たす object を表す。
|
|
空 object も許容される。runtime と materialize 後の表現は通常の object と共通であり、別の map value variant は持たない。
|
|
|
|
```dcdl
|
|
services = {
|
|
api = { port = 8080; };
|
|
worker = { port = 8081; enabled = false; };
|
|
} as Services;
|
|
```
|
|
|
|
各 entry は `as` によって右辺の field domain 内へ絞り込まれるため、左辺に `port` や `enabled` 以外の field があればエラーになる。
|
|
右辺にしかない field は default の有無にかかわらず abstract のまま残る。
|
|
host から渡した object は識別子構文に収まらない文字列 key も保持できるが、DCDL source の object field name は通常の識別子に限られる。
|
|
|
|
固定 field と任意 key を一つの object schema に混在させる rest-field 構文は、現在サポートしない。
|