WSO2Con 2013 CFP Banner

How to Add Custom SOAP Headers to a Web Service Request in Axis2?

Archived Content
This article is provided for historical perspective only, and may not reflect current conditions. Please refer to relevant product page for more up-to-date product information and resources.


How to Add Custom SOAP Headers to a Web Service Request in Axis2?

  • By Eran Chinthaka
  • 2 Dec, 2006
  • Reads: 35974

The Apache Axis2 client API provides you a convenient mechanism to talk to a Web service. You can simply pass the payload you need to send and Axis2 will take care of the rest. But what if you are interested in more than what is being sent in the body of the SOAP message? What if you want to add custom headers to the request?

Let's see how you can add your own headers to the request using Axis2 client API. Let's use the following header as an example.

<myNs:MyHeader xmlns:mvNS="">This is some vital 

Adding Custom Headers Using Client API

Step 1: First you need to get hold of the ServiceClient API. If you are not using generated stubs, then you should use ServiceClient to call the method. But if you are using generated stubs, using Axis2 WSDL2Code mechansim, call _getServiceClient() you can get hold of the ServiceClient.

ServiceClient serviceClient = XXXStub._getServiceClient(); 

Step 2: There are couple of methods in ServiceClient API that you can use to add SOAP headers. The easiest one is to use addStringHeader(QName headerName, String headerText) method.

serviceClient.addStringHeader(new QName("", 
"MyHeader", "myNs"), "This is some vital information");

If you want more control than the above, for instance if you want to add a whole XML fragment inside the SOAP header, then you might want to consider using either addHeader(OMElement header) or addHeader(SOAPHeaderBlock header)

OMFactory omFactory = OMAbstractFactory.getOMFactory();
OMElement omElement = omFactory.createOMElement
(new QName("", "MyHeader", "myNs"), null);
omElement.setText("This is some vital information");

// add whatever you want to omElement here


Applies To:

Apache Axis2/Java v1.1

For More Information:

AXIOM - Fast and Lightweight Object Model for XML