Structura mesajului de solicitare a săpunului

În codul de mai sus, valoarea câmpului antet HTTP SoapAction este numele metodei înaintea căreia urmează spațiul său de nume. Această valoare este aceeași metodă și același spațiu de nume ca și cel adăugat la punctul final care a fost creat utilizând instrucțiunea CREATE ENDPOINT. Trebuie menționat faptul că completarea acestui câmp este opțională. Câmpul Antet gazdă HTTP specifică serverul la care este trimisă solicitarea HTTP.

Informații despre solicitarea SOAP sunt incluse în element plicul SOAP. În exemplul anterior, este solicitată metoda GetCustomerInfo. Atributul xmlns în Are același spațiu de nume ca cel specificat în metoda pentru care a fost creat punctul final utilizând instrucțiunea CREATE ENDPOINT. Pentru mai multe informații despre procedurile stocate și spațiile de nume, consultați Exemple de aplicații care trimit interogări la servicii Web native XML. Următorii parametri de metodă sunt transmiși ca elemente copil pentru .

element cu o valoare de 1 este parametrul de intrare.

element Este parametrul de ieșire.

Procesarea parametrilor de intrare

Parametrii de intrare sunt procesați în următoarele moduri.

Dacă metoda SOAP necesită un parametru de intrare care nu este inclus în solicitarea SOAP, valorile nu sunt transmise procedurii memorate memorate. Se efectuează acțiunea implicită definită în procedura stocată.

Dacă metoda SOAP necesită un parametru de intrare, care este inclusă în cerere, dar nu a fost atribuită o valoare, acest parametru este transmis la o procedură stocată cu un șir gol ca valoare. Trebuie notat că această valoare nu este NULL.

Dacă operația SOAP necesită un parametru de intrare, și acesta trebuie să fie setat la NULL, trebuie să setați atributul XSi: valoarea zero „true“ în cerere SOAP. De exemplu:

Puteți oferi parametri pentru mai multe aspecte. Mai departe, în secțiune există un tabel care conține mai multe aspecte care pot fi specificate atunci când se efectuează interogări SQL neregulate. În acest tabel, toate aspectele care pot fi stabilite pentru un nod , pot fi definite în nodurile parametrilor metodelor RPC.

Când trimiteți o solicitare SOAP pentru o interogare SQL ad-hoc, apelați metoda sqlbatch și transmiteți cererile și toți parametrii necesari.

În următorul exemplu, solicitarea SOTP HTTP apelează metoda sqlbatch. Rețineți că este afișat numai fragmentul HTTP header.

Trebuie notat că valoarea câmpului de antet HTTP SoapAction este numele metodei (sqlbatch) utilizată de client pentru a specifica interogările SQL. Trebuie menționat faptul că acest antet este opțional.

Informații despre solicitarea SOAP sunt afișate în element . Elementul SOAP are doar un element copil ( ), care definește metoda solicitată. Spațiul de nume specificat în element aparține spațiului în care este definită operația sqlbatch. Acest element are următoarele elemente copil.

element Specifică una sau mai multe interogări executabile, separate de punct și virgulă (;).

element conține o listă opțională de parametri. În plicul de solicitare din exemplul anterior, numai un parametru este transmis la interogare. Toți parametrii sunt adăugați la mesajul SOAP ca elemente copil element . Când le trimiteți, trebuie să specificați cel puțin numele parametrului (atributul Name al elementului ) și valoarea parametrului (elementul copil element ).

Pentru a evita schimbările neașteptate, furnizați cele mai detaliate informații despre parametri. Următorul tabel afișează aspectele parametrilor pe care îi puteți specifica pentru un element . Unele dintre ele pot fi, de asemenea, setate pentru un element .