[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: RE: [odata-comment] Public review for #OData JSON Format for Common Schema Definition Language (CSDL) V4.0 - ends February 26th
Hello! My team is consuming OData v4 in the browser as part of
OpenUI5 with the goal to support business applications. Here are some comments based on this background. “This JSON format for CSDL is based on JSON Schema.” I fully understand the idea to express CSDL as s.th. which can be validated by a tool, but I think this is only one aspect.
There is for sure a need for code to inspect the CSDL and react on it programmatically, not with a focus on validation, but on generic UI support (derive type information, labels, structures of tables or forms, etc.). I believe this can benefit from a JSON
format which is tailored for programmatic access and not constrained by some validation tool’s data structures. Such code would have some knowledge about OData and its semantics, in contrast to generic validators which are unaware of that. I appreciate that the chosen MIME type “application/schema+json”
leaves room for coexistence of such formats. ·
“If the structured type has a base type, the schema contains the keyword
allOf whose value is an array with a single item: a JSON Reference to the definition of the base type.”
This is fine for validators, but unwieldy for normal _javascript_ access. ·
“4.1.3 Enumeration Types”: The emphasis on member names is fine for human readability, documentation, debugging etc., but it does not help
to build applications which are really fast. To do so, integers would be much better, both in data and meta data. (4.3) “The
entityContainer object may contain name/value pairs
entitySets,
singletons,
actionImports, and
functionImports.” This is a nice way to tell entity sets and singletons apart,
but on the other hand, if you only got a name you need to look into different maps until you find it. At times, it is more convenient to look into a single map and then inspect a type information contained inside the resulting object. “An object describing an entity set must have an
entityType”, “An object describing a singleton must have a
type”: This inconsistency hurts sometimes. Ciao, Thomas Dr. Thomas Chadzelek T +49 6894 981-2029, E
thomas.chadzelek@sap.com |
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]