1.8. JAX-RPC client-side handler

Example 1-16. SimpleHandler.java

package rcxwsclient;

import javax.xml.rpc.handler.*;

import javax.xml.namespace.QName;
import javax.xml.rpc.handler.soap.SOAPMessageContext;
import javax.xml.rpc.JAXRPCException;
import javax.xml.rpc.NamespaceConstants;
import javax.xml.soap.SOAPMessage;
import javax.xml.soap.SOAPBody;
import org.w3c.dom.*;

import javax.xml.transform.TransformerFactory;
import javax.xml.transform.Transformer;
import javax.xml.transform.Source;

import javax.xml.transform.stream.StreamResult;

public class SimpleHandler extends GenericHandler {
	
  HandlerInfo hi;
	
  public void init(HandlerInfo info) {
    hi = info;
  }

  public QName[] getHeaders() {
    return hi.getHeaders();
  }

  public boolean handleResponse(MessageContext context) {

    System.out.println( "response");

    try {

      // get the soap header
      SOAPMessageContext smc = (SOAPMessageContext) context;
      SOAPMessage message = smc.getMessage();

    
      // Create transformer
      TransformerFactory tff = TransformerFactory.newInstance();
      Transformer tf = tff.newTransformer();

      // Get reply content
      Source sc = message.getSOAPPart().getContent();

      // Set output transformation
      StreamResult result = new StreamResult(System.out);
      tf.transform(sc, result);
      System.out.println();
        
    } catch (Exception e) {
      throw new JAXRPCException(e);
    }
    return true;
  }

  public boolean handleRequest(MessageContext context) {
		
    // return true to continue message processing
    return true;
  }
}

Example 1-17. AdapterHandler.java

We are going to use the DOM to add an attribute to the return soap message (the response soap message received by our client). We also echo the modified SOAP message before to process it by our client.

package rcxwsclient;

import javax.xml.rpc.handler.*;

import javax.xml.namespace.QName;
import javax.xml.rpc.handler.soap.SOAPMessageContext;
import javax.xml.rpc.JAXRPCException;
import javax.xml.rpc.NamespaceConstants;
import javax.xml.soap.SOAPMessage;
import javax.xml.soap.SOAPBody;
import org.w3c.dom.*;

import javax.xml.transform.TransformerFactory;
import javax.xml.transform.Transformer;
import javax.xml.transform.Source;

import javax.xml.transform.stream.StreamResult;

public class AdapterHandler extends GenericHandler {
	
  HandlerInfo hi;
	
  public void init(HandlerInfo info) {
    hi = info;
  }

  public QName[] getHeaders() {
    return hi.getHeaders();
  }

  public boolean handleResponse(MessageContext context) {

  System.out.println( "response");

  try {

    // get the soap header
    SOAPMessageContext smc = (SOAPMessageContext) context;
    SOAPMessage message = smc.getMessage();

    SOAPBody sb = message.getSOAPBody();

    // We expect only one tag <Result> in our SOAP response
    // message but I will use a "for" loop just in case...
    NodeList nl = sb.getElementsByTagName("Result");
				
    for(int x=0; x < nl.getLength(); x++) {
     
      int nnml = nl.item(x).getAttributes().getLength();
      NamedNodeMap nnm = nl.item(x).getAttributes();
      Document doc = nl.item(x).getOwnerDocument();
      // the attribute name and value added
      // are just here for demo
      Attr myattr = doc.createAttribute("xmlns:myref");
      myattr.setValue("urn:www.pascalbotte.be");
      
      Node newN = myattr.cloneNode(false);
     
      nnm.setNamedItem(newN);
      					
      System.out.println("node name: " + nl.item(x).getNodeName() + "\n");
      
      for(int y=0; y < nnml; y++){
	Node n = nl.item(x).getAttributes().item(y);
	System.out.println("\tattribute name: " + n.getNodeName() + ", value: " + 
	  n.getNodeValue() + "\n");
      }
    }
	    
    // Create transformer
    TransformerFactory tff = TransformerFactory.newInstance();
    Transformer tf = tff.newTransformer();

    // Get reply content
    Source sc = message.getSOAPPart().getContent();

    // Set output transformation
    StreamResult result = new StreamResult(System.out);
    tf.transform(sc, result);
    System.out.println();            
    } catch (Exception e) {
      throw new JAXRPCException(e);
    }
    return true;
  }

  public boolean handleRequest(MessageContext context) {

    // return true to continue message processing
    return true;
  }
}

Example 1-18. How to register a handler for a JAX-RPC/AXIS SOAP client.

The code related to the handler registration is in bold.

package rcxwsclient;

import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.rpc.Service;
import javax.xml.rpc.ServiceFactory;

import javax.xml.rpc.handler.*;
import java.util.*;

// watch here at the package used to
// store the RcxReadLS class generated
// by the WSDL2Java tool
import rcxwsclient.sei.RcxReadLS;

public class ClientSEI {

  public static void main(String[] args) 

  {
		
    try {
	  
 	  QName serviceName = new QName(
		"http://phonedirlux.homeip.net/wsdl",
		"MyRcxService");
          
  	  URL wsdlLocation = new URL
		("http://www.pascalbotte.be:80/rcx-ws-rpc/rcx?WSDL");

          // Service
  	  ServiceFactory factory = ServiceFactory.newInstance();
  	  Service service = factory.createService(
		wsdlLocation,
		serviceName);

          HandlerRegistry hr = service.getHandlerRegistry();

          QName  portName = new QName("http://phonedirlux.homeip.net/wsdl", "RcxReadLSPort");

          List handlerChain = hr.getHandlerChain(portName);

          HandlerInfo hi = new HandlerInfo();
          hi.setHandlerClass(SimpleHandler.class);
          handlerChain.add(hi);
		
          // Service Endpoint Interface class generated by WSDL2Java					
  	  RcxReadLS objRcx = (RcxReadLS) service.getPort(portName, RcxReadLS.class);
					
  	  String val = objRcx.readLS("Your message here, with eventually your e-mail address");
	  System.out.println("Rcx web service message: " + val);

	}
    catch (Throwable t) {
      t.printStackTrace();
    }
  }
}