"IS NOT SET"句に適したAPIフォーマットは何でしょうか？

Question

私はこの（JSONっぽい形式）のように見えること、私のサービスに対してクエリAPIを持っています。

{ 
    filter: { 
      ,attribute2: [val21, val22] 
      ,attribute3: [] 
    } 
} 

は意味（SQLっぽい構文で効果的に、選択したデータWHERE attribute2 in ("val21", "val22") AND attribute3 IS NOT NULLを意味し、返されるオブジェクトは、属性3を持っています私のデータはキー値ストアであり、キーはヌル値ではなく「全く設定されない」かもしれないので、SQLはこれをもちろん表現するのはあまり良くありません）。

IS NOT SETという述語を表現できるようにするには、このAPIを拡張する必要があります。そのためには、どうすればよいかわかりません。

私が考えることのできる唯一のことは、特別な "NOT_SET"という値を要求APIに追加して、NOT SETセマンティクスを生成することです。それは把握することは、本当にklunkyとハードようだ：

API構文は限りその表現/機能としてJSONとして考えることができ

理想的な答えがあることを示すために、APIの設計上のいくつかのよく受け入れられたルールを参照しますそれは良いです"。

{ 
    filter: { 
      ,attribute2: [val21, val22] 
      ,attribute4: [__NOT_SET__] 
    } 
} 

Answer 1

私の提案は、述語フレーズを表すためにキーと値のペアを使用しようとすることから離れることです。あなたは、同様の構造を持つ多くの柔軟性を持っている必要があります。

{ 
    filters: [ 
     { attribute: "attribute2", verb: "IN", values: [val21, val22] }, 
     { attribute: "attribute2", verb: "NOT IN", values: [val21, val22] }, 
     { attribute: "attribute4", verb: "IS NOT SET" }, 
    ] 
} 

あなたはもちろん、動詞の列挙型をしたいと思い、その値はオプションでなければならないであろう。後で必要に応じて動詞を追加することができます。もう貧しい人々にも大きな圧力をかけません。:サポートされている動詞のリストと、使用するタイプの数（存在する場合）の数をクライアントに提供することもできます。クライアントは必要に応じて動的にUIを構築できます。

もちろん、これは大きな変更であり、問​​題である場合もありません。