Integrating.xml

<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "Developers_Guide.ent">
%BOOK_ENTITIES;
]>

<chapter id="integrators">
       <title>Integrating with MantisBT</title>

       <para>
               The primary means of integrating with MantisBT is with the SOAP
               API , bundled with MantisBT. The SOAP API is accessible at
               <literal>http://server.com/mantis/api/soap/mantisconnect.php</literal>.
       </para>

       <sect1 id="integrators.java">
               <title>Java integration</title>

               <sect2 id="integrators.java.soap">
                       <title>Prebuilt SOAP stubs using Axis</title>

                       <para>
                               For ease of integration of the Java clients, SOAP stubs
                               are maintained and deployed in the Maven central repository.
                               To include them in your project, use the following coordinates:
                       </para>

                       <programlisting>
       &lt;dependency&gt;
           &lt;groupId&gt;biz.futureware.mantis&lt;/groupId&gt;
           &lt;artifactId&gt;mantis-axis-soap-client&lt;/artifactId&gt;
           &lt;version&gt;1.2.6&lt;/version&gt;
       &lt;/dependency&gt;
                       </programlisting>

                       <para>Alternatively, download the latest available version from
                       <ulink url="http://search.maven.org/#search|gav|1|g%3A%22biz.futureware.mantis%22%20AND%20a%3A%22mantis-axis-soap-client%22">
       http://search.maven.org/#search|gav|1|g%3A%22biz.futureware.mantis%22%20AND%20a%3A%22mantis-axis-soap-client%22</ulink>.
                       </para>
               </sect2>

               <sect2 id="integrators.java.osgi">
                       <title>Usage in OSGi environments</title>
                       <para>If you would like to use Axis in an OSGi environment, it is
                       recommended that you use a ready-made bundle, such as the Axis
                       bundle available from <ulink url="http://download.eclipse.org/tools/orbit/downloads/">
                       Eclipse Orbit</ulink>
                       </para>
               </sect2>
       </sect1>

       <sect1 id="integrators.compatibility">
               <title>Compatibility between releases</title>

               <para>The SOAP API signature will change between minor releases, typically to add new functionality or to extend existing features.
               </para>
               <para>Some of these changes might require a refresh of the client libraries generated, for instance Apache Axis 1 SOAP stubs must be
               regenerated if a complex type receives a new property. Such changes will be announced before the release of the new MantisBT version
               on the <ulink url="http://lists.sourceforge.net/mailman/listinfo/mantisbt-soap-dev"> mantisbt-soap-dev mailing list</ulink> .
               Typically there will be two weeks time to integrate the new SOAP stubs.</para>

       </sect1>

       <sect1 id="integrators.support">
               <title>Support</title>

               <para>The primary means of obtaining support is through the <ulink url="http://lists.sourceforge.net/mailman/listinfo/mantisbt-soap-dev">
               mantisbt-soap-dev mailing list</ulink>.</para>
       </sect1>
</chapter>