SOAP-grammatiikka

SOAP-rakennusmoduuli

Yksi SOAP-viesti on tavallinen XML-dokumentti, joka sisältää seuraavat elementit:

  • Välttämätön Envelope-elementti, joka voi merkitä tämän XML-dokumentin SOAP-viestiksi
  • Valinnainen Header-elementti, joka sisältää otsikkotiedot
  • Välttämätön Body-elementti, joka sisältää kaikki kutsu- ja vastaus tiedot
  • Valinnainen Fault-elementti, joka tarjoaa tietoja virheistä, jotka ovat tapahtuneet tämän viestin käsittelyssä

Kaikki edellä mainitut elementit on määritelty SOAP-kuoren oletusnimeäspaceissa:

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

ja oletuksena SOAP-koodauksen ja datatyypien nimistö:

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

Grammatiikkasäännöt

Tässä on joitakin tärkeitä grammatiikkasääntöjä:

  • SOAP-viestin on käytettävä XML-koodausta
  • SOAP-viestin on käytettävä SOAP Envelope-nimistöä
  • SOAP-viestin on käytettävä SOAP Encoding-nimistöä
  • SOAP-viesti ei voi sisältää DTD-viittauksia
  • SOAP-viesti ei voi sisältää XML-käsittelyohjeita

SOAP-viestin perusrakenne

<?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>