The Actor Attribute
142
SOAP
WITH
A
TTACHMENTS
API
FOR
J
AVA
An actor is identified by its URI. For example, the following line of code, in
which
orderHeader
is a
SOAPHeaderElement
object, sets the actor to the given
URI.
orderHeader.setActor("http://gizmos.com/orders");
Additional actors can be set in their own
SOAPHeaderElement
objects. The fol-
lowing code fragment first uses the
SOAPMessage
object
message
to get its
SOAP-
Header
object
header
. Then
header
creates four
SOAPHeaderElement
objects,
each of which sets its
actor
attribute.
SOAPHeader header = message.getSOAPHeader();
SOAPFactory soapFactory = SOAPFactory.newInstance();
String nameSpace = "ns";
String nameSpaceURI = "http://gizmos.com/NSURI";
QName order =
new QName(nameSpaceURI, "orderDesk", nameSpace);
SOAPHeaderElement orderHeader =
header.addHeaderElement(order);
orderHeader.setActor("http://gizmos.com/orders");
QName shipping =
new QName(nameSpaceURI, "shippingDesk", nameSpace);
SOAPHeaderElement shippingHeader =
header.addHeaderElement(shipping);
shippingHeader.setActor("http://gizmos.com/shipping");
QName confirmation =
new QName(nameSpaceURI, "confirmationDesk", nameSpace);
SOAPHeaderElement confirmationHeader =
header.addHeaderElement(confirmation);
confirmationHeader.setActor(
"http://gizmos.com/confirmations");
QName billing =
new QName(nameSpaceURI, "billingDesk", nameSpace);
SOAPHeaderElement billingHeader =
header.addHeaderElement(billing);
billingHeader.setActor("http://gizmos.com/billing");
The
SOAPHeader
interface provides two methods that return a
java.util.Iter-
ator
object over all the
SOAPHeaderElement
objects that have an actor that
