Riepilogo dello standard OTATA per un'implementazione minimale di sola lettura
Domanda
The Specifica ODATA è lunga.Anche il "< Documento ODATA CORE " è piuttosto lungo.
Allora, che ne dici di un riassunto condensato di ciò che è necessario implementare un editore ODATA di sola lettura da implementare al minimo?
Soluzione
Inizierò. Un servizio ODATA fornisce un endpoint HTTP che:
- .
- deve capire le intestazioni "
Accept
" - deve supportare l'intestazione del tipo di contenuto e deve supportare il formato Atom (opzionalmente JSON)
- può restituire un documento di servizio (elenco di raccolte) a
GET /
(10.1.1)- .
- Se il formato Atom (Atompub?), la gerarchia è
service/workspace/collection/title
- deve restituire le descrizioni delle raccolte alle richieste come
GET /Customers
(10.2)- .
- Se Atom, la gerarchia è
feed/entry/content
- deve riportare le descrizioni delle singole entità alle richieste come
GET /Customers(3)
(10.2.1) - può restituire singole proprietà delle singole entità per richieste come
GET /Customers(3)/Name
(10.2.2) - deve rendere disponibile un csdl schema Descrizione avvolta in un documento EDMX (10.1.2)
- .
- Questo dovrebbe essere disponibile su
/$metadata
- può supportare una di queste query (10.2.3)
- .
- filtri (righe limite restituite):
Products?$filter=Price lt 10.00
- Seleziona (campi limite restituiti):
Products?$select=Rating,ReleaseDate
- Ordina per:
Products?$orderby=ReleaseDate asc, Rating desc
- Top, skip:
Products?$top=5&$skip=2
- inlinecount (includi un conteggio di entità):
Products?$inlinecount=allpages
- deve (?) Fornire un elenco di relazioni per un'entità (10.2.4):
Products(0)/$links/Orders
- deve fornire un conteggio di entità (10.2.5):
Products/$count
- può supportare altri formati con specificatore
$format
(10.2.3.7)Quando viene restituito un feed Atom (ad esempio per una raccolta), è necessario conformarsi ad alcune convenzioni di Odata: http://www.odata.org/documentation/odata-v3-documentation/atom-format/ ad esempio:
- .
- Tipi utilizzati sono "
edm:String
" ecc. - Gli elementi
link
vengono utilizzati generosamente - Gli elementi
content
contengono contenuti in linea (ad esempio, dati di testo) o collegamento ad esso (ad es. Immagini, file binari) con attributosrc=
.Quando viene restituito un feed JSON, segue anche determinate regole:
- .
- http://www.odata.org/documentation / OTATA-V3-DOCUMENTAZIONE / JSON-VERBOSE-FORMATO /
Gli URL sono incoraggiati a seguire questo schema:
- http://www.odata.org/documentation / OTATA-V3-DOCUMENTAZIONE / JSON-VERBOSE-FORMATO /
- Tipi utilizzati sono "
- filtri (righe limite restituite):
- Questo dovrebbe essere disponibile su
- Se Atom, la gerarchia è
- Se il formato Atom (Atompub?), la gerarchia è
Autorizzato sotto: CC-BY-SA insieme a attribuzione
Non affiliato a StackOverflow