SOAPConstants.SOAP_1_2

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

∟SOAPConstants.SOAP_1_2_PROTOCOL

This section provides a tutorial example on how to create a SOAPMessage object for SOAP 1.2 protocol - MessageFactory.newInstance(SOAPConstants.SOAP_1_2_PROTOCOL).

Are you ready to see how SAAJ support SOAP 1.2? Here is my first test program:

/**
 * SOAPMessage12Test.java
 * Copyright (c) 2009 by Dr. Herong Yang, herongyang.com
 * All rights reserved
 */
import java.io.*;
import javax.xml.soap.*;
public class SOAPMessage12Test {
   public static void main(String[] args) {
      PrintStream out = System.out;

// Checking command line arguments
      if (args.length < 1) {
         out.println("Usage:");
         out.println("java SOAPMessage12Test url");
         return;
      }
      String sURL = args[0];

      try {
// Building the request document
         SOAPMessage reqMsg = MessageFactory.newInstance(
      	    SOAPConstants.SOAP_1_2_PROTOCOL).createMessage();
         SOAPEnvelope envelope = reqMsg.getSOAPPart().getEnvelope();
         SOAPBody body = envelope.getBody();
         body.addBodyElement(envelope.createName("Hello"));

// Connecting and calling
	 SOAPConnection con 
	    = SOAPConnectionFactory.newInstance().createConnection();
         SOAPMessage resMsg = con.call(reqMsg, sURL);
         con.close();

// Showing output
         out.println("\n\nRequest:");
         reqMsg.writeTo(out);
         out.println("\n\nResponse:");
         resMsg.writeTo(out);
      } catch (Exception e) {
         e.printStackTrace();
      }
   }
}

To help my socket server test program to test SOAP 1.2 messages, I created this SOAP 1.2 HTTP response file, soap_1_2_server.res:

HTTP/1.1 200 OK
Connection: close
Content-Type: application/soap+xml; charset=utf-8
Content-Length: 303

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <HelloRes>Hello Herong!</HelloRes>
  </soap:Body>
</soap:Envelope>

In the server command window:

\herong>java SocketRequestResponseServer soap_1_2_server.res
   server.req

Listening at 8888

In the client command window:

\herong>java SOAPMessage12Test http://localhost:8888

Request:
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope">
  <env:Header/>
  <env:Body><Hello/></env:Body>
</env:Envelope>

Response:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <HelloRes>Hello Herong!</HelloRes>
  </soap:Body>
</soap:Envelope>

Back in the client command window:

Connection received from /127.0.0.1
Request length: 414
Response length: 401

\herong>type server.req
POST / HTTP/1.1
Accept: application/soap+xml, text/html, image/gif, image/jpeg, *;...
Content-Type: application/soap+xml; charset=utf-8
Content-Length: 123
Cache-Control: no-cache
Pragma: no-cache
User-Agent: Java/1.6.0_06
Host: localhost:8888
Connection: keep-alive

Result looks very good:

The Content-Type header line is set correctly with "application/soap+xml" as the media type.
The Envelope namespace is correctly set to "http://www.w3.org/2003/05/soap-envelope".

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