Come il SAPONE Funziona

Share

|

Una richiesta del SAPONE coinvolgerà generare e popolare una busta di richiesta, che contiene tutte le informazioni richieste (come specificato dal documento di WSDL), trasmettenti quella busta all'assistente di api e maneggianti la risposta.

Una richiesta del SAPONE contiene generalmente tutti gli seguenti elementi:

• Busta del SAPONE — con le inclusioni del namespace.

• Corpo del SAPONE — possibilmente che definisce i namespaces supplementari.

• L'azione voluta — come l'azione voluta è rappresentata dipenderà dall'api in questione. Può essere semplice come parametro, o coinvolga i namespaces supplementari.

• Contrassegno unico — di chiave A dello sviluppatore assegnato dall'assistente al richiedente.

• Parametri di richiesta — che dettagliano la richiesta che è effettuata.

Con quelle informazioni in mente, una richiesta del SAPONE può essere generata.

<?xmlversion="1.0" che mette = standalone="no" UTF-8 ""? >
< SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
< SOAP-ENV:Body >
< devkey xsi:type="xsd:int">123</devkey >
< azione xsi:type="xsd:string">search</action >
< scriva xsi:type="xsd:string">book</type a macchina >
< parola chiave xsi:type="xsd:string">style</keyword >
</SOAP-ENV:Body >
</SOAP-ENV:Envelope >

I parametri inclusi nella richiesta sono facili da selezionare e benchè la battitura a macchina variabile non sia di importanza grande per sviluppo di PHP, viene in pratico per le lingue più fortemente scritte. L'articolo mancante qui è il punto finale, fatto chiaramente nell'esempio di RESTO perché era il URL a cui la richiesta è stata inviata. Le richieste del SAPONE, naturalmente, sono fatte funzionare contro URIs specificato, che non devono re-essere specificate all'interno della richiesta in se.

La risposta del SAPONE assomiglierebbe a questa:

<?xmlversion='1.0 'encoding='UTF-8 '? >
< SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/1999/XMLSchema" >
< SOAP-ENV:Body >
< LibrarySearchResponsexmlns="http://library.example.com/api/ns" >
< RequestInfo >
< devkey xsi:type = "xsd:string">123</devkey >
< azione xsi:type="xsd:string">search</action >
< scriva xsi:type="xsd:string">book</type a macchina >
< parola chiave xsi:type="xsd:string">style</keyword >
</RequestInfo >
< ResponseInfo >
< ResultCount>2</ResultCount >
< articolo >
< volume 1</Title del libro di titolo xsi:type="xsd:string">Style >
< condizione xsi:type="xsd:string">Out</Status >
< strette xsi:type="xsd:int">3</Holds >
< CopiesOnHand xsi:type="xsd:int">2</CopiesOnHand >
< autore xsi:type="xsd:string">Jon Doe</Author >
</articolo >
< articolo >
< volume 2</Title del libro di titolo xsi:type="xsd:string">Style >
< condizione xsi:type="xsd:string">In</Status >
< strette xsi:type="xsd:int">0</Holds >
< CopiesOnHand xsi:type="xsd:int">1</CopiesOnHand >
< autore xsi:type="xsd:string">Jon Doe</Author >
</articolo >
</ResponseInfo >
</LibrarySearchResponse >
</SOAP-ENV:Body >
</SOAP-ENV:Envelope >

La risposta del SAPONE non è troppo differente dalla risposta di RESTO indicata più presto. Infatti, gran parte del gioco nome potrebbe realmente essere omesso (benchè fosse raro da vederle una risposta del SAPONE), il punto in cui, con l'eccezione dell'incapsulamento supplementare, i due documenti sarebbe molto simile.

Come dovreste potere discernere dalla risposta indicata, si dichiara per essere XML 1.0 ed usa UTF-8 per mettere. L'elemento di SOAP-ENV:Envelope è l'elemento della radice per il documento ed ha threenamespaces, compreso il namespace di SOAP-ENV. Il corpo allora contiene l'elemento di LibrarySearchResponse tra l'altro, che inoltre definisce il relativo proprio namespace.

Il genitore di RequestInfo segue dopo e questo contiene i parametri di richiesta che hanno generato la risposta che segue sopra da là. Che restituisce la richiesta i parametri con la risposta è un caso comune in SAPONE.

Per concludere, la risposta in se è restituita. Noti che l'elemento di ResultCount si siede come bambino diretto di ResponseInfo e gli articoli essi stessi di risultato di nuovo sono immagazzinati sotto un elemento ripetente, articolo.