Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<p>ActiveSOAP is a lightweight &amp; easily embeddable <a class="confluence-link" href="/display/AWS/REST" data-linked-resource-id="11208" data-linked-resource-type="page" data-linked-resource-default-alias="REST" data-base-url="http://docs.codehaus.org">REST</a> and SOAP stack based on <a class="confluence-link" href="/display/AWS/StAX" data-linked-resource-id="11209" data-linked-resource-type="page" data-linked-resource-default-alias="StAX" data-base-url="http://docs.codehaus.org">StAX</a> with support for <a class="confluence-link" href="/display/AWS/WS-Addressing" data-linked-resource-id="25822" data-linked-resource-type="page" data-linked-resource-default-alias="WS-Addressing" data-base-url="http://docs.codehaus.org">WS-Addressing</a> and <a class="confluence-link" href="/display/AWS/WSIF" data-linked-resource-id="25892" data-linked-resource-type="page" data-linked-resource-default-alias="WSIF" data-base-url="http://docs.codehaus.org">WSIF</a>. </p>

<p>ActiveSOAP uses StAX (the Standard API for pull parsing) to implement the SOAP protocols and then it delegates to plugin <a href="http://activesoap.codehaus.org/maven/apidocs/org/codehaus/activesoap/Handler.html">Handler</a> objects for the heavy duty processing of the XML payloads. This means that you only need to pay for what you need; use fast pull based event parsing or full data binding mechanisms like JAXB or XStream or DOMish APIs like XMLBeans when they make sense.</p>

<p>You can use whatever XML marshalling and/or parsing tool you like to process different messages or headers. The following APIs are currently supported</p>

<ul>
	<li><a class="confluence-link" href="/display/AWS/JAXB" data-linked-resource-id="24689" data-linked-resource-type="page" data-linked-resource-default-alias="JAXB" data-base-url="http://docs.codehaus.org">JAXB</a></li>
	<li><a class="confluence-link" href="/display/AWS/XMLBeans" data-linked-resource-id="10988" data-linked-resource-type="page" data-linked-resource-default-alias="XMLBeans" data-base-url="http://docs.codehaus.org">XMLBeans</a></li>
	<li><a class="confluence-link" href="/display/AWS/XStream" data-linked-resource-id="11507" data-linked-resource-type="page" data-linked-resource-default-alias="XStream" data-base-url="http://docs.codehaus.org">XStream</a></li>
	<li>StaX, SAX, DOM or TrAX</li>
</ul>

<p>ActiveSOAP is currently used to provide <a href="http://activemq.codehaus.org/WS+Notification">WS-Notification</a> support in <a href="http://servicemix.org/">ServiceMix</a>.</p>

<p>In addition to the core StAX processing of SOAP requests (client and server side) ActiveSOAP provides support for <a class="confluence-link" href="/display/AWS/WS-Addressing" data-linked-resource-id="25822" data-linked-resource-type="page" data-linked-resource-default-alias="WS-Addressing" data-base-url="http://docs.codehaus.org">WS-Addressing</a> and provides multiple <a class="confluence-link" href="/display/AWS/WSIF" data-linked-resource-id="25892" data-linked-resource-type="page" data-linked-resource-default-alias="WSIF" data-base-url="http://docs.codehaus.org">WSIF</a> providers.</p>

<h3>Getting started</h3>

<p>To get a feel for how you can work with document centric web services using ActiveSOAP and XMLBeans, take a look at an <a class="confluence-link" href="/display/AWS/Example" data-linked-resource-id="10999" data-linked-resource-type="page" data-linked-resource-default-alias="Example" data-base-url="http://docs.codehaus.org">Example</a>.</p>

<p>There is also a dynamic client invocation API which you can use if you don't want to generate interfaces from your WSDLs such as <a class="confluence-link" href="/display/AWS/Dynamic+Client" data-linked-resource-id="11194" data-linked-resource-type="page" data-linked-resource-default-alias="Dynamic Client" data-base-url="http://docs.codehaus.org">in this example</a></p>

<p>To get a feel for the architecture, try reading <a class="confluence-link" href="/display/AWS/How+it+works" data-linked-resource-id="10980" data-linked-resource-type="page" data-linked-resource-default-alias="How it works" data-base-url="http://docs.codehaus.org">How it works</a></p>