The Java EE 5 Tutorial (PDF) - Oracle Software Downloads

SAAJTutorial
SAAJTutorial
588
SOAPConnectionFactory factory = SOAPConnectionFactory.newInstance();
SOAPConnection connection = factory.createConnection();
. . .// create a request message and give it content
java.net.URL endpoint = new URL("http://fabulous.com/gizmo/order");
SOAPMessage response = connection.call(request, endpoint);
Note that the second argument to the call method, which identifies where the message is being
sent, can be a String object or a URL object. Thus, the last two lines of code from the preceding
example could also have been the following:
String endpoint = "http://fabulous.com/gizmo/order";
SOAPMessage response = connection.call(request, endpoint);
A web service implemented for request-response messaging must return a response to any
message it receives. The response is a SOAPMessage object, just as the request is a SOAPMessage
object. When the request message is an update, the response is an acknowledgment that the
update was received. Such an acknowledgment implies that the update was successful. Some
messages may not require any response at all. The service that gets such a message is still
required to send back a response because one is needed to unblock the call method. In this
case, the response is not related to the content of the message; it is simply a message to unblock
the call method.
Now that you have some background on SOAP messages and SOAP connections, in the next
section you will see how to use the SAAJ API.
This tutorial walks you through how to use the SAAJ API. First, it covers the basics of creating
and sending a simple SOAP message. Then you will learn more details about adding content to
messages, including how to create SOAP faults and attributes. Finally, you will learn how to
send a message and retrieve the content of the response.
After going through this tutorial, you will know how to perform the following tasks:
■ “Creating and Sending a Simple Message” on page 589
■ “Adding Content to the Header” on page 597
■ “Adding Content to the SOAPPart Object” on page 598
■ “Adding a Document to the SOAP Body” on page 599
■ “Manipulating Message Content Using SAAJ or DOM APIs” on page 599
■ “Adding Attachments” on page 599
■ “Adding Attributes” on page 602
■ “Using SOAP Faults” on page 607
The Java EE 5Tutorial • June 2010