Wie SEIFE Arbeitet

Share

|

Ein SEIFE Antrag bezieht, einen Antrag mit einumschlag herzustellen und zu bevölkern, der alle erforderlichen Informationen (wie durch das WSDL Dokument spezifiziert) enthält, diesen Umschlag dem API Bediener übermittelt, und die Antwort anfaßt.

Ein SEIFE Antrag enthält im Allgemeinen alle folgenden Elemente:

• SEIFE Umschlag — mit namespace Einbeziehungen.

• SEIFE Körper, der — vielleicht zusätzliche namespaces definiert.

• Gewünschte Tätigkeit — , wie die gewünschte Tätigkeit dargestellt wird, hängt von der API in der Frage ab. Sie kann wie ein Parameter so einfach sein, oder beziehen Sie zusätzliche namespaces mit ein.

• Einzigartiger Bezeichner — des Entwickler-Schlüssels A zugewiesen durch den Bediener dem Bittsteller.

• Antrag-Parameter, die — den Antrag durchgeführt wird genau schildern.

Mit diesen Informationen im Verstand, kann ein SEIFE Antrag erzeugt werden.

< kodierendes?xmlversion="1.0" = 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 >
< Tätigkeit xsi:type="xsd:string">search</action >
< schreiben Sie xsi:type="xsd:string">book</type >
< Schlüsselwort xsi:type="xsd:string">style</keyword >
</SOAP-ENV:Body >
</SOAP-ENV:Envelope >

Die Parameter, die im Antrag eingeschlossen sind, sind einfach auszuwählen, und obwohl das variable Schreiben nicht vom großen Wert für PHP Entwicklung ist, kommt sie in handliches für stärker geschriebene Sprachen. Das fehlende Einzelteil hier ist der Endpunkt, klar gebildet im REST-Beispiel, weil es das URL war, zu dem der Antrag bekanntgegeben wurde. SEIFE Anträge selbstverständlich werden gegen spezifiziertes URIs laufen gelassen, die nicht brauchen, innerhalb des Antrags selbst Re-spezifiziert zu werden.

Die SEIFE Antwort würde wie dieses aussehen:

<?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 >
< Tätigkeit xsi:type="xsd:string">search</action >
< schreiben Sie xsi:type="xsd:string">book</type >
< Schlüsselwort xsi:type="xsd:string">style</keyword >
</RequestInfo >
< ResponseInfo >
< ResultCount>2</ResultCount >
< Einzelteil >
< Buch Vol. 1</Title des Titel-xsi:type="xsd:string">Style >
< Status xsi:type="xsd:string">Out</Status >
< Einflüsse xsi:type="xsd:int">3</Holds >
< CopiesOnHand xsi:type="xsd:int">2</CopiesOnHand >
< Autor xsi:type="xsd:string">Jon Doe</Author >
</Einzelteil >
< Einzelteil >
< Buch Vol. 2</Title des Titel-xsi:type="xsd:string">Style >
< Status xsi:type="xsd:string">In</Status >
< Einflüsse xsi:type="xsd:int">0</Holds >
< CopiesOnHand xsi:type="xsd:int">1</CopiesOnHand >
< Autor xsi:type="xsd:string">Jon Doe</Author >
</Einzelteil >
</ResponseInfo >
</LibrarySearchResponse >
</SOAP-ENV:Body >
</SOAP-ENV:Envelope >

Die SEIFE Antwort ist nicht zu der REST-Antwort zu unterschiedlich, die früh gezeigt wird. Tatsächlich könnte viel des Namensabstandes wirklich ausgelassen werden (obwohl es selten ist, eine SEIFE Antwort ohne sie zu sehen), an dem Punkt, mit Ausnahme von der zusätzlichen Verkapselung, die zwei Dokumente sehr ähnlich sein würde.

Wie Sie in der LageSEIN sollten, von der gezeigten Antwort zu erkennen, erklärt sich sie, um XML 1.0 zu sein und verwendet UTF-8 für die Kodierung. Das SOAP-ENV:Envelope Element ist das Wurzelelement für das Dokument und hat threenamespaces, einschließlich das SOAP-ENV namespace. Der Körper enthält dann das LibrarySearchResponse Element unter anderem, das auch sein eigenes namespace definiert.

Das RequestInfo Elternteil folgt nach, und dieses enthält die Antragparameter, die die Antwort erzeugten, die an von dort folgt. Ist der Antrag zurückbringt Parameter mit der Antwort ein allgemeines Auftreten in der SEIFE.

Schließlich wird die Antwort selbst zurückgebracht. Beachten Sie, daß das ResultCount Element als direktes Kind von ResponseInfo sitzt, und die Resultat Einzelteile selbst werden gespeichert wieder unter einem wiederholenden Element, Einzelteil.