SOAP Headers in Lotus Domino web service consumers and providers

Wed, 08 Feb 2012 14:41:06 GMT

In a current project we're using the web service consumer and web server provider capability of Lotus Domino quite heavily. During the development the need to process the SOAP request headers which are provided in a section above the SOAP body. Problem is that these are not exposed through the proxy classes generated for you when you import the WSDL. Searching Google I came across the blog of Elena Neroslavskaya and more importantly the post that helped me out. Using the MessageContext class described in that blog post helped me crack the nut and now I can both iterate through the SOAP headers sent to me in the request and send SOAP headers back in the response. Sweet!

Below are two code snippets - one for iterating through request headers and one for sending headers back. Home it may help someone out there.

Iterate received headers

private void recurseHeaders(Iterator ite) { 
  while (ite.hasNext()) { 
    MessageElement elem = (MessageElement)ite.next(); 
    String nsUri = elem.getNamespaceURI(); 
    String name = elem.getName(); 
    String value = elem.getValue();
    System.out.println("SOAP Header - ns <" + 
      nsUri + ">, name <" + name + ">, value <" + 
      value + ">"); 
    this.recurseHeaders(elem.getChildElements()); 
  } 
} 

public com.example.FooResponseType foo(
  com.example.FooRequestType req) throws Exception { 
  
  MessageContext mc = MessageContext.getCurrentContext(); 
  SOAPEnvelope envelope = mc.getRequestMessage()
    .getSOAPEnvelope(); 
  this.recurseHeaders(
    envelope.getHeader().getChildElements()); 
}

Send back headers

import lotus.domino.axis.message.SOAPHeaderElement;
import lotus.domino.axis.message.MessageElement;

MessageElement elemGuid = 
  new MessageElement("http://lekkimworld.com", "Guid"); 
elemGuid.addTextNode("GuidXYZ"); 

MessageElement elemUser = 
  new MessageElement("http://lekkimworld.com", "User"); 
elemUser.addTextNode("UserXYZ"); 

SOAPHeaderElement elemHeader = 
  new SOAPHeaderElement("http://lekkimworld.com", "TopElem"); 
elemHeader.addChild(elemGuid); 
elemHeader.addChild(elemUser); 

mc.getResponseMessage()
  .getSOAPEnvelope().addHeader(elemHeader);

Practical Web Services in IBM Lotus Domino 7: What are Web services and why are they important?

Tue, 07 Nov 2006 21:34:19 GMT

New web services article by Julian on developerWorks: Practical Web Services in IBM Lotus Domino 7: What are Web services and why are they important? via Mr. Elgort...

lekkimworld.comwebservices

SOAP Headers in Lotus Domino web service consumers and providers

Iterate received headers

Send back headers

Practical Web Services in IBM Lotus Domino 7: What are Web services and why are they important?