[ODATA-1503] Instance annotations of absent complex properties - OASIS Technical Committees Issue Tracker

XML

Word

Printable

Proposal:

Hide

Annotations are always expressed as name/value pairs. For entity data model constructs represented as JSON objects the annotation name/value pairs are placed within the object; for constructs represented as JSON arrays or primitives, including null, they are placed next to the annotated model construct and have the name of the annotated property before the @. An annotation in the latter format can also take the place of an absent property.

Show
Annotations are always expressed as name/value pairs. For entity data model constructs represented as JSON objects the annotation name/value pairs are placed within the object; for constructs represented as JSON arrays or primitives, including null, they are placed next to the annotated model construct and have the name of the annotated property before the @ . An annotation in the latter format can also take the place of an absent property.

According to OData-JSON section 20, a complex property has its instance annotations embedded into the JSON object:

{
 "ComplexProperty": {
  "@ns.term": ...
  "SubProperty": ...
 }
}

However, if the property is null, it looks different:

{
 "ComplexProperty": null,
 "ComplexProperty@ns.term": ...
}

How shall the instance annotation look if the property is absent? So

{
 "ComplexProperty@ns.term": ...
}

or so?

{
 "ComplexProperty": {
  "@ns.term": ...
 }
}

Section 20 does not cover the case "When annotating a name/value pair for which the value is absent".