SAAJ API Reference Implementation 1.3.4

SOAP Web Service Tutorials - Herong's Tutorial Examples - Version 5.02, by Dr. Herong Yang

SOAP Web Service Tutorials - Herong's Tutorial Examples

∟SAAJ - SOAP with Attachments API for Java

∟SAAJ API Reference Implementation 1.3.4

This section provides a tutorial example on how to download SAAJ API and Reference Implementation 1.3.4 from SAAJ home page and use them instead of using the default implementation from JDK 1.6.0.

Since I am not sure what is the version and release number of the default implementation of SAAJ included in JDK 1.6, I want to download and use the Reference Implementation release, SAAJ 1.3.4, provided at the SAAJ home page.

1. Go to https://saaj.dev.java.net/

2. Click the "Releases" link, then the "releases" folder icon.

3. Click to open the "1.3.4 (2)" sub folder.

4. Click to download "saaj1.3.4.zip" file, and save it to the current folder on your local computer. The file size should be 312,559 bytes.

5. Unzip all files from "saaj1.3.4.zip" to a sub folder ".\saaj1.3.4".

6. Copy two JAR files, saaj-api.jar and saaj-impl.jar, from ".\saaj1.3.4\saaj\lib" to your local library folder, like "\herong\lib".

Now I am ready to test SAAJ Reference Implementation 1.3.4 with my test program, SAAJImplementationTest.java, described in the previous toturial:

>javac -classpath \herong\lib\saaj-api.jar;\herong\lib\saaj-impl.jar 
   SAAJImplementationTest.java

>java -classpath .;\herong\lib\saaj-api.jar;\herong\lib\saaj-impl.jar 
   SAAJImplementationTest

 SOAPConnectionFactory class: class com.sun.xml.messaging.saaj.client
   .p2p.HttpSOAPConnectionFactory

 SOAPConnection class: class com.sun.xml.messaging.saaj.client
   .p2p.HttpSOAPConnection

Note that:

I used -classpath to specify JAR files both compilation and execution commands.
Without any source code changes, JVM is able to pick up the SAAJ implementation provided in those JAR files instead of the JRE 1.6.0 jar file.
Comparing outputs of the test with the previous tutorial, I see that the SAAJ implementation class name is different between the Reference Implementation and the JDK internal default implementation, which has an extra segment, "internal".

Last update: 2009.

Table of Contents

About This Book

Introduction to Web Service

Introduction to SOAP (Simple Object Access Protocol)

SOAP Message Structure

SOAP Message Transmission and Processing

SOAP Data Model

SOAP Encoding

SOAP RPC Presentation

SOAP Properties Model

SOAP Message Exchange Patterns