Syntax ng SOAP

Mga modulong gumagawa ng SOAP

Isang mensahe ng SOAP ay isang pangkaraniwang dokumentong XML, na naglalaman ng mga sumusunod na elemento:

  • Mandahil na Envelope na elemento, na nagpapahiwatig na ang dokumentong XML na ito ay isang mensahe ng SOAP
  • Opisyonal na Header na elemento, na naglalaman ng impormasyon ng ulo
  • Mandahil na Body na elemento, na naglalaman ng lahat ng impormasyon ng pagtawag at tugon
  • Opisyonal na Fault na elemento, nagbibigay ng impormasyon tungkol sa mga error na nangyari sa pagproseso ng mensahe na ito

Lahat ng mga ito ay nadeklara sa default na nangangalaga ng pangalan ng space para sa SOAP na pagsasaklaw:

http://www.w3.org/2001/12/soap-envelope

at ang default namespace para sa encoding at data type ng SOAP:

http://www.w3.org/2001/12/soap-encoding

Patakaran ng Syntax

Ito ay ilang mahalagang patakaran ng syntax:

  • Ang mensaheng SOAP ay dapat magiging XML encoded
  • Ang mensaheng SOAP ay dapat gamitin ang SOAP Envelope namespace
  • Ang mensaheng SOAP ay dapat gamitin ang SOAP Encoding namespace
  • Ang mensaheng SOAP ay hindi puwedeng magkaroon ng DTD reference
  • Ang mensaheng SOAP ay hindi puwedeng magkaroon ng XML processing instruction

Ang pangunahing istraktura ng mensaheng SOAP

<?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"
<soap:Header>
  ...
  ...
</soap:Header>
<soap:Body>
  ...
  ...
  <soap:Fault>
    ...
    ...
  </soap:Fault>
</soap:Body>
</soap:Envelope>