Các phần tử SOAP Header

Các phần tử tiêu đề Header của SOAP tùy chọn chứa thông tin tiêu đề.

Các phần tử SOAP Header

Các phần tử tiêu đề Header của SOAP tùy chọn có thể chứa thông tin chuyên dụng cho ứng dụng liên quan đến thông điệp SOAP (ví dụ: xác thực, thanh toán, v.v.). Nếu phần tử tiêu đề được cung cấp, thì nó phải là phần tử con đầu tiên của phần bọc Envelope.

Ghi chú:Tất cả các phần tử con trực tiếp của phần tiêu đề phải là không gian tên hợp lệ.

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

Ví dụ trên chứa một phần tiêu đề với một phần tử "Trans" có giá trị là 234, giá trị thuộc tính "mustUnderstand" của phần tử này là "1".

SOAP định nghĩa ba thuộc tính trong không gian tên mặc định ("http://www.w3.org/2001/12/soap-envelope"). Ba thuộc tính này là: actor, mustUnderstand và encodingStyle. Các thuộc tính được định nghĩa này trong phần tiêu đề SOAP có thể xác định cách bộ xử lý xử lý thông điệp SOAP.

Thuộc tính actor

Bằng cách theo đường dẫn thông điệp qua các điểm cuối khác nhau, thông điệp SOAP có thể được truyền từ một người gửi đến một người nhận. Không phải tất cả các phần của thông điệp SOAP đều được định nghĩa để truyền đến điểm cuối cuối cùng của thông điệp SOAP, nhưng từ另一方面, có thể được định nghĩa để truyền đến một hoặc nhiều điểm cuối trên đường dẫn thông điệp.

Thuộc tính actor của SOAP có thể được sử dụng để định vị phần tiêu đề Header đến một điểm cuối cụ thể.

Cú pháp

soap:actor="URI"

Mẫu

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

Thuộc tính mustUnderstand

Thuộc tính mustUnderstand của SOAP có thể được sử dụng để xác định một mục tiêu trong tiêu đề là bắt buộc hay tùy chọn đối với người nhận xử lý.

Nếu bạn thêm "mustUnderstand="1" vào một thành phần con của phần tử Header, nó có thể chỉ thị người nhận xử lý phần tử này phải chấp nhận phần tử này. Nếu người nhận này không thể chấp nhận phần tử này, người nhận phải từ chối xử lý phần tử này khi xử lý phần đầu.

Cú pháp

soap:mustUnderstand="0|1"

Mẫu

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

Thuộc tính encodingStyle

Thuộc tính encodingStyle của SOAP đã được giải thích trong phần trước.