JSON-WSP - JSON-WSP

JSON-WSP on verkkopalveluprotokolla, joka käyttää JSONia palvelujen kuvaamiseen, pyyntöihin ja vastauksiin. Se on saanut inspiraationsa JSON-RPC: stä , mutta palvelukuvauksen määrittelyn puuttuminen JSON-RPC: n dokumentaatioineen sai aikaan JSON-WSP: n suunnittelun.

Kuvausmuodolla on sama tarkoitus JSON-WSP: llä kuin WSDL: llä SOAP: lla tai IDL : llä CORBA: lle , eli kuvaamaan tietyssä palvelussa käytettyjä tyyppejä ja menetelmiä. Se kuvaa myös tyyppien välisiä suhteita (ts. Sisäkkäisiä tyyppejä) ja määrittelee, mitkä tyypit ovat odotettavissa metodiargumentteina ja mitkä tyypit käyttäjä voi odottaa saavansa menetelmän palautusarvoina. Lopuksi kuvaus avaa mahdollisuuden lisätä palveluiden, menetelmien, parametrien ja palautustasojen dokumentaatiota.

Viestintä asiakkaiden ja JSON-WSP-palvelimen välillä tapahtuu HTTP POST -pyyntöjen ja vastausten avulla, ja JSON-objektit ovat tietoja sisältötyyppisen sovelluksen / json kanssa.

Tekniset tiedot

JSON-WSP koostuu neljästä JSON-objektimäärityksestä:

Erittely Kuvaus
kuvaus Palvelun kuvauksen määrittely (kuten WSDL ). Tämä eritelmä kuvaa menetelmiä, menetelmäparametreja, tyyppejä ja palautustyyppejä. Se tukee myös käyttäjän dokumentaatiota palvelusta, menetelmästä ja parametritasoista.
pyyntö JSON-pyyntöjen määrittely. Se sisältää tietoja käytettävästä menetelmästä ja kaikki menetelmän kutsun argumentit. Pyynnössä olevien argumenttien on noudatettava saman menetelmän parametrimäärittelyä, joka on kuvattu vastaavassa JSON-WSP-kuvauksessa.
vastaus JSON-vastausten määrittely. Vastausobjekti sisältää palvelumenetelmän kutsun tuloksen. Palautustyypin on noudatettava saman menetelmän määritettyä palautustyyppiä vastaavassa JSON-WSP-kuvauksessa.
vika JSON-vikareaktioiden määrittely. Vikaobjekti sisältää vikakoodin ja vikamerkkijonon. Vikatiedot määrittävät, tapahtuiko vika asiakas- tai palvelinpuolella. Palvelinpuolen palvelukehyksestä riippuen voidaan poimia yksityiskohtaisempia tietoja, eli tiedostonimi ja rivinumero, jossa vika tapahtui.

Viitteet