属性 | 説明 | 値型 | 制約 |
---|---|---|---|
qtypeName | =QEntity.qtypeName | 同左 | 同左 |
id | =QEntity.id | 同左 | 同左 |
qvalues | 自QEntityを親に持つQValueQValue配列 | List<Quad.QValue> | 100配列以下 |
version | =QEntity.version | 同左 | 同左 |
GET http://(server):(port)/(webapp)/quads?(パラメータ)...
クエリパラメータ | 説明 | 値型 | 制約等 |
---|---|---|---|
type | QTypeと同じ | 同左 | 同左 |
limitRange | QTypeと同じ | 同左 | 同左 |
qattributeOrderIndexRange | QAttribute方向の結果配列の取得範囲。QAttribute.orderIndex昇順ソート時の順番で指定。1~ 例){"start":1,"end":10} | Range<Integer> | default=1~10, 100間隔未満, 開始/終了逆転不可 |
qtypeNameRanges | QEntityと同じ | 同左 | 同左 |
whereExpressions | 絞り込み条件配列 | List<Expression> | 5配列以下 |
sortOrderExpressions | ソート条件配列 | List<Expression> | 5配列以下 |
属性 | 説明 | 値型 | 制約等 |
---|---|---|---|
qattributeNameRanges | QValueと同じ 例)[{"start":"カラム01","end":"カラム09"}] ソート条件として[{"start":"カラム01","end":"カラム99"}]のような範囲を指定した場合、カラム01~カラム99のいずれかの値がソートに利用され、どのカラム値が使われるか不定になってしまう。ソート条件においては、単一の値のみを指定し、範囲や範囲配列を指定させないものとする。 | 同左 | required(有効値が1つもない場合は、Expression全体が無視される), 100文字以下。ソート条件時は1配列以下, 開始/終了同値 |
qvalueType | QValue.qtypeName, .qentityId, .qattributeNameで特定されるQAttribute.qvalueType | 同左 | required |
qvalueRanges | Quad.QValue.xxxValueの範囲 | Quad.QValue.xxxValueに準拠 | 100文字以下(stringValueの場合), 5配列以下 |
desc | ソートを降順にするか否か。ソート条件時のみ有効 | boolean |
ヘッダ/ボディ | 説明 |
---|---|
ボディ | QTypeと同じ。recordsは「List<Quad>」となる。 |
上記は正常時のレスポンスです。異常時の場合は例外情報が出力されます。
例
http://(server):(port)/(webapp)/quads?type=RECORDSANDCOUNT&limitRange={"end":10,"start":1}&qattributeOrderIndexRange={"end":10,"start":1}&whereExpressions=[{"qattributeNameRanges":[{"end":"年齢99","start":"年齢01"}],"qvalueType":"LONG","qvalueRanges":[{"end":69,"start":10}]}]&sortOrderExpressions=[{"desc":false,"qattributeNameRanges":[{"end":"性別","start":"性別"}],"qvalueType":"STRING","qvalueRanges":[{"end":"男","start":"男"}]}]
ポイント
Quadは仮想的な存在であるため、Quadの中で、QEntityとQValue配列とを組み立て、1つの構造体として見せているに過ぎません。例えば、versionやETagは、Quad単位で管理されているものではなく、QEntityだけのものであることに注意してください。
POST http://(server):(port)/(webapp)/quads
ヘッダ/ボディ | 説明 |
---|---|
ボディ | JSON形式のQuadデータ |
Quadのid/version, QValue配列のqentityId/versionには値をセットしないで下さい。登録時、サーバで新規採番/Id特定されます。
ヘッダ/ボディ | 説明 |
---|---|
ETagヘッダ | QTypeと同じ |
ボディ | JSON形式の登録後Quadデータ |
Etagは、Quadに含まれるQEntityのETagと同義です。Quadに含まれるQValueのETagではありません。