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

Code Examples
newDetail. Not all SOAPFault objects are required to have a Detail object, so the code tests to
see whether newDetail is null. If it is not, the code prints the values of the DetailEntry objects
as long as there are any.
Detail newDetail = newFault.getDetail();
if (newDetail != null) {
Iterator entries = newDetail.getDetailEntries();
while ( entries.hasNext() ) {
DetailEntry newEntry = (DetailEntry)entries.next();
String value = newEntry.getValue();
System.out.println(" Detail entry = " + value);
}
}
In summary, you have seen how to add a SOAPFault object and its contents to a message as well
as how to retrieve the contents. A SOAPFault object, which is optional, is added to the SOAPBody
object to convey status or error information. It must always have a fault code and a String
explanation of the fault. A SOAPFault object must indicate the actor that is the source of the
fault only when there are multiple actors; otherwise, it is optional. Similarly, the SOAPFault
object must contain a Detail object with one or more DetailEntry objects only when the
contents of the SOAPBody object could not be processed successfully.
See “SOAP Fault Example” on page 622 for an example that uses code like that shown in this
section.
The first part of this tutorial uses code fragments to walk you through the fundamentals of using
the SAAJ API. In this section, you will use some of those code fragments to create applications.
First, you will see the program Request.java. Then you will see how to run the programs
HeaderExample.java, DOMExample.java, DOMSrcExample.java, Attachments.java, and
SOAPFaultTest.java.
Note – Before you run any of the examples, follow the preliminary setup instructions in
“Building the Examples” on page 69.
Request Example
Code Examples
The class Request puts together the code fragments used in the section “SAAJ Tutorial” on
page 588 and adds what is needed to make it a complete example of a client sending a
request-response message. In addition to putting all the code together, it adds import
statements, a main method, and a try/catch block with exception handling.
Chapter 19 • SOAP with Attachments API for Java 611