ตัวแปร SOAP Header

องค์ประกอบหัวข้อที่เป็นตัวเลือกมีข้อมูลหัวข้อ

ตัวแปร SOAP Header

องค์ประกอบหัวข้อ SOAP ที่เป็นตัวเลือกสามารถมีข้อมูลที่เกี่ยวกับโปรแกรมของ SOAP ที่เป็นเจ้าของ (เช่น การรับรอง การจ่ายเงิน และอื่น ๆ) หากหัวข้อนี้ถูกจัดทำ มันต้องเป็นองค์ประกอบแรกขององค์ประกอบ Envelope

หมายเหตุ：องค์ประกอบในตรงต่อตรงของหัวข้อต้องมีชื่อพื้นฐานที่ถูกต้อง

<?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>
<m:Trans
xmlns:m="http://www.codew3c.com/transaction/"
soap:mustUnderstand="1">234</m:Trans>
</soap:Header>
...
...
</soap:Envelope>

ตัวอย่างด้านบนประกอบด้วยหัวข้อที่มีองค์ประกอบ "Trans" ซึ่งมีค่า 234 องค์ประกอบนี้มีอักษรยศ "mustUnderstand" มีค่า "1"

SOAP ได้กำหนดอักษรยศทั้งสามในชื่อพื้นฐาน ("http://www.w3.org/2001/12/soap-envelope") อย่างไรก็ตาม คือ: actor, mustUnderstand และ encodingStyle อักษรยศที่ถูกกำหนดเหล่านี้ในหัวข้อ SOAP สามารถกำหนดว่าหลักประกอบจะจัดการข้อความ SOAP อย่างไร

อักษรยศ actor

ด้วยการเดินทางตามหนทางของข้อความผ่านทางจุดปลายต่าง ๆ ของข้อความ SOAP สามารถแพร่หลายจากผู้ส่งถึงผู้รับ ไม่ใช่ทุกส่วนของข้อความ SOAP ต้องการถูกส่งมาถึงจุดปลายสุดท้ายของข้อความ SOAP แต่จากทางตรงกันข้าม อาจจะมีการส่งมาถึงจุดปลายของหนทางของข้อความหนึ่ง หรือหลายจุดปลาย

SOAP อักษรยศ actor สามารถใช้เพื่อที่จะทำการทำการจำลองศูนย์ปลายขององค์ประกอบหัวข้อ สำหรับจุดประสงค์ที่เฉพาะเจาะจง

การใช้ภาษา

soap:actor="URI"

ตัวอย่าง

<?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>
<m:Trans
xmlns:m="http://www.codew3c.com/transaction/"
soap:actor="http://www.codew3c.com/appml/">
234
</m:Trans>
</soap:Header>
...
...
</soap:Envelope>

ตัวแปร mustUnderstand

ตัวแปร mustUnderstand ของ SOAP สามารถใช้เพื่อหมายถึงว่าตัวแปรหัวข้อนี้เป็นสิ่งบังคับหรือเลือกใช้สำหรับผู้รับที่จะจัดการกับมัน。

หากคุณเพิ่ม "mustUnderstand="1" ในองค์ประกอบของตัวแปร Header มันสามารถบอกให้ผู้รับที่จะจัดการกับหัวข้อนี้ต้องยอมรับตัวแปรนี้ หากผู้รับไม่สามารถยอมรับตัวแปรนี้ ตัวแปรนี้จะต้องทำงานอย่างไม่เหมาะสมเมื่อจัดการกับหัวข้อนี้。

การใช้ภาษา

soap:mustUnderstand="0|1"

ตัวอย่าง

<?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>
<m:Trans
xmlns:m="http://www.codew3c.com/transaction/"
soap:mustUnderstand="1">
234
</m:Trans>
</soap:Header>
...
...
</soap:Envelope>

encodingStyle ของตัวแปร

การใช้ encodingStyle ของ SOAP ได้ถูกอธิบายในบทก่อนหน้านี้แล้ว。