Στοιχείο SOAP Header

Επιλογής στοιχείο του κεφαλιού περιέχει πληροφορίες κεφαλιού.

Στοιχείο SOAP Header

Επιλογής στοιχείο του κεφαλιού SOAP μπορεί να περιέχει πληροφορίες για την εφαρμογή του μηνύματος SOAP (π.χ. πιστοποίηση, πληρωμή κ.λπ.). Αν το στοιχείο κεφαλιού παρέχεται, πρέπει να είναι ο πρώτος υποκείμενος του στοιχείου Envelope.

Σημείωση:Οι άμεσοι υποκείμενοι του στοιχείου Header πρέπει να είναι σε αποδεκτή ονομαστική διάσταση.

<?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" του στοιχείου "Trans" έχει τιμή "1".

Το SOAP ορίζει τρεις ιδιότητες στην προεπιλεγμένη ονομαστική διάσταση ("http://www.w3.org/2001/12/soap-envelope"). Αυτές οι τρεις ιδιότητες είναι: actor, mustUnderstand και encodingStyle. Αυτές οι ορισμένες ιδιότητες στο κεφάλι του SOAP καθορίζουν πώς η κουτίδα θα χειριστεί το μήνυμα SOAP.

ιδιότητα του actor

Με την κατεύθυνση του δρόμου του μηνύματος και τη διαφορά των σημείων τελικού προορισμού, το μήνυμα SOAP μπορεί να διαδοθεί από έναν αποστολέα σε έναν παραλήπτη. Όχι όλες οι μερίδες του μηνύματος SOAP έχουν σκοπό να παραδοθούν στο τελικό σημείο τελικού προορισμού, αλλά από την άλλη πλευρά, μπορεί να έχουν σκοπό να παραδοθούν σε ένα ή περισσότερα σημεία του δρόμου του μηνύματος.

Η ιδιότητα του actor του SOAP μπορεί να χρησιμοποιηθεί για να αποστέλλει το στοιχείο Header σε συγκεκριμένο σημείο τελικού προορισμού.

Γλώσσα Γράφησης

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 έχει εξηγήθεί στο προηγούμενο κεφάλαιο.