| A representation of the SOAP header element. A SOAP header element consists of XML data that
affects the way the application-specific content is processed by the message provider. For
example, transaction semantics, authentication information, and so on, can be specified as the
content of a SOAPHeader object.
A SOAPEnvelope object contains an empty SOAPHeader object by
default. If the SOAPHeader object, which is optional, is not needed, it can be
retrieved and deleted with the following line of code. The variable se is a
SOAPEnvelope object. se.getHeader().detachNode(); A
SOAPHeader object is created with the SOAPEnvelope method
addHeaderBlock. This method, which creates a new header and adds it to the envelope,
may be called only after the existing header has been removed. se.getHeader().detachNode();
SOAPHeader sh = se.addHeaderBlock();
A SOAPHeader object can have only SOAPHeaderElement objects as its
immediate children. The method addHeaderElement creates a new
HeaderElement object and adds it to the SOAPHeader object. In the following
line of code, the argument to the method addHeaderElement is a Name
object that is the name for the new HeaderElement object.
SOAPHeaderElement shElement = sh.addHeaderElement(name);
See Also: SOAPHeaderElement
See Also: SOAPHeaderElement |