You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ws.apache.org by rd...@apache.org on 2005/08/28 16:47:07 UTC
svn commit: r263882 [3/5] - in /webservices/site/trunk/targets/axis2: ./
images/tools/ style/
Modified: webservices/site/trunk/targets/axis2/mail-configuration.html
URL: http://svn.apache.org/viewcvs/webservices/site/trunk/targets/axis2/mail-configuration.html?rev=263882&r1=263881&r2=263882&view=diff
==============================================================================
--- webservices/site/trunk/targets/axis2/mail-configuration.html (original)
+++ webservices/site/trunk/targets/axis2/mail-configuration.html Sun Aug 28 07:46:26 2005
@@ -2,8 +2,8 @@
@import url("./style/maven-base.css");
@import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis 2.0" src="http://ws.apache.org/axis/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
- Last published: 16 August 2005
- | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="releases.html">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="">Axis 2 Modules</a><ul><li class="none"><a href="multiproject/axis2-core/index.html">Core</a></li><li class="none"><a href="multiproject/axis2-xml/index.html">XML</a></li><li class="none"><a href="multiproject/axis2-wsdl/index.html">WSDL</a></li><li class="none"><a href="multiproject/axis2-tools/index.html">Tools</a></li><li class="none"><a href="multiproject/axis2-samples/index.html">Samples</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2" class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.htm">Migrating from Axis 1.x</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Mail_transport"></a><h2>Mail transport</h2><p>The inner workings of the mail transport has two parts, the transport Sender and the transport Listener. Here the transport Listener is a basic email client which will be on a loop checking for new messages for a particular email address. When an email comes in it will be tunneled into the Axis engine.</p><p>Mail transport can be used against a generic mail server or it can be used like a mailet. The simple mailet provided with Axis2 will direct any message that is coming to a particular address into the Axis engine. The engine will process the message and will use the Transport sender to send the reply.</p><p></p><p>To get started on the mail transport you need the following additional jar dependencies on the classpath.</p><ol>
+ Last published: 28 August 2005
+ | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="releases.html">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="">Axis 2 Modules</a><ul><li class="none"><a href="multiproject/axis2-core/index.html">Core</a></li><li class="none"><a href="multiproject/axis2-xml/index.html">XML</a></li><li class="none"><a href="multiproject/axis2-wsdl/index.html">WSDL</a></li><li class="none"><a href="multiproject/axis2-tools/index.html">Tools</a></li><li class="none"><a href="multiproject/axis2-samples/index.html">Samples</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2" class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.html">Migrating from Axis 1.x</a></li><li class="none"><a href="otherTutorials.html">Other Tutorials</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Mail_transport"></a><h2>Mail transport</h2><p>The inner workings of the mail transport has two parts, the transport Sender and the transport Listener. Here the transport Listener is a basic email client which will be on a loop checking for new messages for a particular email address. When an email comes in it will be tunneled into the Axis engine.</p><p>Mail transport can be used against a generic mail server or it can be used like a mailet. The simple mailet provided with Axis2 will direct any message that is coming to a particular address into the Axis engine. The engine will process the message and will use the Transport sender to send the reply.</p><p></p><p>To get started on the mail transport you need the following additional jar dependencies on the classpath.</p><ol>
<li>javamail</li>
<li>activation</li>
</ol><p>We use the Geronimo version of these jars. Specificaly we are using geronimo-spec-javamail-[version].jar and geronimo-spec-activation-[version].jar. These will be downloaded by maven when you run the maven build.</p><div class="subsection"><a name="Transport_Sender"></a><h3>Transport Sender</h3><p>You need to have a mail account to activate the mail functionality. This can either be a generic mail server or you can start up a james mail server. The Mail transport sender can be activated by adding following entry to the axis2.xml file.</p>
Modified: webservices/site/trunk/targets/axis2/mail-lists.html
URL: http://svn.apache.org/viewcvs/webservices/site/trunk/targets/axis2/mail-lists.html?rev=263882&r1=263881&r2=263882&view=diff
==============================================================================
--- webservices/site/trunk/targets/axis2/mail-lists.html (original)
+++ webservices/site/trunk/targets/axis2/mail-lists.html Sun Aug 28 07:46:26 2005
@@ -2,22 +2,22 @@
@import url("./style/maven-base.css");
@import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis 2.0" src="http://ws.apache.org/axis/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
- Last published: 16 August 2005
- | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="releases.html">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="">Axis 2 Modules</a><ul><li class="none"><a href="multiproject/axis2-core/index.html">Core</a></li><li class="none"><a href="multiproject/axis2-xml/index.html">XML</a></li><li class="none"><a href="multiproject/axis2-wsdl/index.html">WSDL</a></li><li class="none"><a href="multiproject/axis2-tools/index.html">Tools</a></li><li class="none"><a href="multiproject/axis2-samples/index.html">Samples</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2" class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.htm">Migrating from Axis 1.x</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Mailing_Lists"></a><h2>Mailing Lists</h2><p>
+ Last published: 28 August 2005
+ | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="releases.html">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="">Axis 2 Modules</a><ul><li class="none"><a href="multiproject/axis2-core/index.html">Core</a></li><li class="none"><a href="multiproject/axis2-xml/index.html">XML</a></li><li class="none"><a href="multiproject/axis2-wsdl/index.html">WSDL</a></li><li class="none"><a href="multiproject/axis2-tools/index.html">Tools</a></li><li class="none"><a href="multiproject/axis2-samples/index.html">Samples</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2" class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.html">Migrating from Axis 1.x</a></li><li class="none"><a href="otherTutorials.html">Other Tutorials</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Mailing_Lists"></a><h2>Mailing Lists</h2><p>
These are the mailing lists that have been established for this
project. For each list, there is a subscribe, unsubscribe, and an
archive link.
</p><table class="bodyTable"><thead>
- <tr class="b"><th>List Name</th><th>Subscribe</th><th>Unsubscribe</th><th>Archive</th></tr>
+ <tr class="a"><th>List Name</th><th>Subscribe</th><th>Unsubscribe</th><th>Archive</th></tr>
</thead><tbody>
- <tr class="a"><td>Axis Developer List</td><td>
+ <tr class="b"><td>Axis Developer List</td><td>
<a href="mailto:axis-dev-subscribe@ws.apache.org">Subscribe</a>
</td><td>
<a href="mailto:axis-dev-unsubscribe@ws.apache.org">Unsubscribe</a>
</td><td>
<a href="http://marc.theaimsgroup.com/?l=axis-dev&r=1&w=2" class="externalLink" title="External Link">Archive</a>
</td></tr>
- <tr class="b"><td>Axis User List</td><td>
+ <tr class="a"><td>Axis User List</td><td>
<a href="mailto:axis-user-subscribe@ws.apache.org">Subscribe</a>
</td><td>
<a href="mailto:axis-user-unsubscribe@ws.apache.org">Unsubscribe</a>
Modified: webservices/site/trunk/targets/axis2/mail-transport.html
URL: http://svn.apache.org/viewcvs/webservices/site/trunk/targets/axis2/mail-transport.html?rev=263882&r1=263881&r2=263882&view=diff
==============================================================================
--- webservices/site/trunk/targets/axis2/mail-transport.html (original)
+++ webservices/site/trunk/targets/axis2/mail-transport.html Sun Aug 28 07:46:26 2005
@@ -3,8 +3,8 @@
@import url("./style/maven-base.css");
@import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis 2.0" src="http://ws.apache.org/axis/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
- Last published: 16 August 2005
- | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="releases.html">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="">Axis 2 Modules</a><ul><li class="none"><a href="multiproject/axis2-core/index.html">Core</a></li><li class="none"><a href="multiproject/axis2-xml/index.html">XML</a></li><li class="none"><a href="multiproject/axis2-wsdl/index.html">WSDL</a></li><li class="none"><a href="multiproject/axis2-tools/index.html">Tools</a></li><li class="none"><a href="multiproject/axis2-samples/index.html">Samples</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2" class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.htm">Migrating from Axis 1.x</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Invoking_a_service_using_a_mail"></a><h2>Invoking a service using a mail</h2><div class="subsection"><a name="Prologue"></a><h3>Prologue</h3><p>Most of the web services that we
+ Last published: 28 August 2005
+ | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="releases.html">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="">Axis 2 Modules</a><ul><li class="none"><a href="multiproject/axis2-core/index.html">Core</a></li><li class="none"><a href="multiproject/axis2-xml/index.html">XML</a></li><li class="none"><a href="multiproject/axis2-wsdl/index.html">WSDL</a></li><li class="none"><a href="multiproject/axis2-tools/index.html">Tools</a></li><li class="none"><a href="multiproject/axis2-samples/index.html">Samples</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2" class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.html">Migrating from Axis 1.x</a></li><li class="none"><a href="otherTutorials.html">Other Tutorials</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Invoking_a_service_using_a_mail"></a><h2>Invoking a service using a mail</h2><div class="subsection"><a name="Prologue"></a><h3>Prologue</h3><p>Most of the web services that we
interact with are synchronous and request-response in nature. However,
we see that the synchronous request-response type of interaction is
only a part of the messaging scenarios we encounter in real life.
Modified: webservices/site/trunk/targets/axis2/maven-help.html
URL: http://svn.apache.org/viewcvs/webservices/site/trunk/targets/axis2/maven-help.html?rev=263882&r1=263881&r2=263882&view=diff
==============================================================================
--- webservices/site/trunk/targets/axis2/maven-help.html (original)
+++ webservices/site/trunk/targets/axis2/maven-help.html Sun Aug 28 07:46:26 2005
@@ -2,5 +2,5 @@
@import url("./style/maven-base.css");
@import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis 2.0" src="http://ws.apache.org/axis/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
- Last published: 16 August 2005
- | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="releases.html">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="">Axis 2 Modules</a><ul><li class="none"><a href="multiproject/axis2-core/index.html">Core</a></li><li class="none"><a href="multiproject/axis2-xml/index.html">XML</a></li><li class="none"><a href="multiproject/axis2-wsdl/index.html">WSDL</a></li><li class="none"><a href="multiproject/axis2-tools/index.html">Tools</a></li><li class="none"><a href="multiproject/axis2-samples/index.html">Samples</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2" class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.htm">Migrating from Axis 1.x</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Quick_Guide_to_Maven_for_Axis_2_0"></a><h2>Quick Guide to Maven for Axis 2.0</h2><div class="subsection"><a name="Introduction"></a><h3>Introduction</h3><p align="left"><a href="http://maven.apache.org" class="externalLink" title="External Link">Maven</a> is used as the build tool of Axis 2.0. This document will provide a quick guide to use maven with your developments.</p></div><div class="subsection"><a name="Commands"></a><h3>Commands</h3><table class="bodyTable"><tr class="a"><th scope="col"><div align="left">Command</div></th><th scope="col"><div align="left">Description</div></th></tr><tr class="b"><td><div align="left">maven</div></td><td><div align="left">download relevant jars, if not available and compile and run tests of the system</div></td></tr><tr class="a"><td>maven clean </td><td>Clean all the stuff build so far, that are in the target folder. This will not clean the jar repository</td></tr><tr class="b"><td><div align="left">maven test </div></td><td><div align="left">run only the tests. Will do automatic compilation of changed sources as well</div></td></tr><tr class="a"><td><div align="left">maven -g </div></td><td><div align="left">List down all the commands available with maven </div></td></tr><tr class="b"><td><div align="left">maven site </div></td><td><div align="left">generate this site </div></td></tr><tr class="a"><td><div align="left">maven idea </div></td><td><div align="left">generate IDEA .ipr, .iml and .iws project files</div></td></tr><tr class="b"><td><div align="left">maven eclipse</div></td><td><div align="left">generate project files for eclipse</div></td></tr><tr class="a"><td><div align="left">maven -dmaven.test.skip=true</div></td><td><div align="left"></div>Builds Axis2 and skips all the tests</td></tr></table><p align="left"> </p><p align="left"> </p></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2005, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
+ Last published: 28 August 2005
+ | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="releases.html">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="">Axis 2 Modules</a><ul><li class="none"><a href="multiproject/axis2-core/index.html">Core</a></li><li class="none"><a href="multiproject/axis2-xml/index.html">XML</a></li><li class="none"><a href="multiproject/axis2-wsdl/index.html">WSDL</a></li><li class="none"><a href="multiproject/axis2-tools/index.html">Tools</a></li><li class="none"><a href="multiproject/axis2-samples/index.html">Samples</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2" class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.html">Migrating from Axis 1.x</a></li><li class="none"><a href="otherTutorials.html">Other Tutorials</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Quick_Guide_to_Maven_for_Axis_2_0"></a><h2>Quick Guide to Maven for Axis 2.0</h2><div class="subsection"><a name="Introduction"></a><h3>Introduction</h3><p align="left"><a href="http://maven.apache.org" class="externalLink" title="External Link">Maven</a> is used as the build tool of Axis 2.0. This document will provide a quick guide to use maven with your developments.</p></div><div class="subsection"><a name="Commands"></a><h3>Commands</h3><table class="bodyTable"><tr class="b"><th scope="col"><div align="left">Command</div></th><th scope="col"><div align="left">Description</div></th></tr><tr class="a"><td><div align="left">maven</div></td><td><div align="left">download relevant jars, if not available and compile and run tests of the system</div></td></tr><tr class="b"><td>maven clean </td><td>Clean all the stuff build so far, that are in the target folder. This will not clean the jar repository</td></tr><tr class="a"><td><div align="left">maven test </div></td><td><div align="left">run only the tests. Will do automatic compilation of changed sources as well</div></td></tr><tr class="b"><td><div align="left">maven -g </div></td><td><div align="left">List down all the commands available with maven </div></td></tr><tr class="a"><td><div align="left">maven site </div></td><td><div align="left">generate this site </div></td></tr><tr class="b"><td><div align="left">maven idea </div></td><td><div align="left">generate IDEA .ipr, .iml and .iws project files</div></td></tr><tr class="a"><td><div align="left">maven eclipse</div></td><td><div align="left">generate project files for eclipse</div></td></tr><tr class="b"><td><div align="left">maven -dmaven.test.skip=true</div></td><td><div align="left"></div>Builds Axis2 and skips all the tests</td></tr></table><p align="left"> </p><p align="left"> </p></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2005, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Modified: webservices/site/trunk/targets/axis2/maven-reports.html
URL: http://svn.apache.org/viewcvs/webservices/site/trunk/targets/axis2/maven-reports.html?rev=263882&r1=263881&r2=263882&view=diff
==============================================================================
--- webservices/site/trunk/targets/axis2/maven-reports.html (original)
+++ webservices/site/trunk/targets/axis2/maven-reports.html Sun Aug 28 07:46:26 2005
@@ -2,8 +2,8 @@
@import url("./style/maven-base.css");
@import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis 2.0" src="http://ws.apache.org/axis/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
- Last published: 16 August 2005
- | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="releases.html">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="">Axis 2 Modules</a><ul><li class="none"><a href="multiproject/axis2-core/index.html">Core</a></li><li class="none"><a href="multiproject/axis2-xml/index.html">XML</a></li><li class="none"><a href="multiproject/axis2-wsdl/index.html">WSDL</a></li><li class="none"><a href="multiproject/axis2-tools/index.html">Tools</a></li><li class="none"><a href="multiproject/axis2-samples/index.html">Samples</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2" class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.htm">Migrating from Axis 1.x</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Maven_Generated_Reports"></a><h2>Maven Generated Reports</h2><p>
+ Last published: 28 August 2005
+ | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="releases.html">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="">Axis 2 Modules</a><ul><li class="none"><a href="multiproject/axis2-core/index.html">Core</a></li><li class="none"><a href="multiproject/axis2-xml/index.html">XML</a></li><li class="none"><a href="multiproject/axis2-wsdl/index.html">WSDL</a></li><li class="none"><a href="multiproject/axis2-tools/index.html">Tools</a></li><li class="none"><a href="multiproject/axis2-samples/index.html">Samples</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2" class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.html">Migrating from Axis 1.x</a></li><li class="none"><a href="otherTutorials.html">Other Tutorials</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Maven_Generated_Reports"></a><h2>Maven Generated Reports</h2><p>
This document provides an overview of the various reports that
are automatically generated by
<a href="http://maven.apache.org/" class="externalLink" title="External Link">Maven</a>.
Modified: webservices/site/trunk/targets/axis2/migration.html
URL: http://svn.apache.org/viewcvs/webservices/site/trunk/targets/axis2/migration.html?rev=263882&r1=263881&r2=263882&view=diff
==============================================================================
--- webservices/site/trunk/targets/axis2/migration.html (original)
+++ webservices/site/trunk/targets/axis2/migration.html Sun Aug 28 07:46:26 2005
@@ -2,8 +2,8 @@
@import url("./style/maven-base.css");
@import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis 2.0" src="http://ws.apache.org/axis/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
- Last published: 16 August 2005
- | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="releases.html">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="">Axis 2 Modules</a><ul><li class="none"><a href="multiproject/axis2-core/index.html">Core</a></li><li class="none"><a href="multiproject/axis2-xml/index.html">XML</a></li><li class="none"><a href="multiproject/axis2-wsdl/index.html">WSDL</a></li><li class="none"><a href="multiproject/axis2-tools/index.html">Tools</a></li><li class="none"><a href="multiproject/axis2-samples/index.html">Samples</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2" class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.html">Migrating from Axis 1.x</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Migrating_from_Axis_1_x_to_Axis_2"></a><h2>Migrating from Axis 1.x to Axis 2</h2><div class="subsection"><a name="Compatibility"></a><h3>Compatibility</h3><p>Axis1.x and Axis2 have been evolved from different architectures.</p><p>Speed - Axis2 is based on StAX API, which gives greater speed than SAX event base parsing that has been used in Axis1.x.</p><p>Stability - Axis2 has fixed phases and for extensions an area of user defined phases. This allows far more stability and flexibility than Axis1.x.</p><p>Transport framework - Simple abstraction designing of transports (i.e., senders and listeners for SOAP over various protocols such as SMTP, etc), allow far more flexibility and the core of the engine is completely transport-independent.</p><p>WSDL Support - Axis2 supports version 1.1 and 2.0, which allow creating stubs and skeletons, to manipulate web service arena.</p><p>Component - Oriented Architecture - This is merely through archives (.mar and .aar) . Easily reusable components such as Handlers, Modules allow patterns processing for your applications, or to distribute to partners. Axis2 more concern on the "Module" concept rather Handler concept. Modules contain handlers that have been ordered through phase rules. which being ordered to specific service(s). </p></div><div class="subsection"><a name="Getting_Started"></a><h3>Getting Started</h3><p>Lets look at a simple example of echoing at client API</p><p><b>Axis 1.x</b></p>
+ Last published: 28 August 2005
+ | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="releases.html">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="">Axis 2 Modules</a><ul><li class="none"><a href="multiproject/axis2-core/index.html">Core</a></li><li class="none"><a href="multiproject/axis2-xml/index.html">XML</a></li><li class="none"><a href="multiproject/axis2-wsdl/index.html">WSDL</a></li><li class="none"><a href="multiproject/axis2-tools/index.html">Tools</a></li><li class="none"><a href="multiproject/axis2-samples/index.html">Samples</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2" class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.html">Migrating from Axis 1.x</a></li><li class="none"><a href="otherTutorials.html">Other Tutorials</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Migrating_from_Axis_1_x_to_Axis_2"></a><h2>Migrating from Axis 1.x to Axis 2</h2><div class="subsection"><a name="Compatibility"></a><h3>Compatibility</h3><p>Axis1.x and Axis2 have been evolved from different architectures.</p><p>Speed - Axis2 is based on StAX API, which gives greater speed than SAX event base parsing that has been used in Axis1.x.</p><p>Stability - Axis2 has fixed phases and for extensions an area of user defined phases. This allows far more stability and flexibility than Axis1.x.</p><p>Transport framework - Simple abstraction designing of transports (i.e., senders and listeners for SOAP over various protocols such as SMTP, etc), allow far more flexibility and the core of the engine is completely transport-independent.</p><p>WSDL Support - Axis2 supports version 1.1 and 2.0, which allow creating stubs and skeletons, to manipulate web service arena.</p><p>Component - Oriented Architecture - This is merely through archives (.mar and .aar) . Easily reusable components such as Handlers, Modules allow patterns processing for your applications, or to distribute to partners. Axis2 more concern on the "Module" concept rather Handler concept. Modules contain handlers that have been ordered through phase rules. which being ordered to specific service(s). </p></div><div class="subsection"><a name="Getting_Started"></a><h3>Getting Started</h3><p>Lets look at a simple example of echoing at client API</p><p><b>Axis 1.x</b></p>
<div class="source"><pre>
import ..
public class TestClient {
Modified: webservices/site/trunk/targets/axis2/mtom-guide.html
URL: http://svn.apache.org/viewcvs/webservices/site/trunk/targets/axis2/mtom-guide.html?rev=263882&r1=263881&r2=263882&view=diff
==============================================================================
--- webservices/site/trunk/targets/axis2/mtom-guide.html (original)
+++ webservices/site/trunk/targets/axis2/mtom-guide.html Sun Aug 28 07:46:26 2005
@@ -2,8 +2,8 @@
@import url("./style/maven-base.css");
@import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis 2.0" src="http://ws.apache.org/axis/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
- Last published: 16 August 2005
- | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="releases.html">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="">Axis 2 Modules</a><ul><li class="none"><a href="multiproject/axis2-core/index.html">Core</a></li><li class="none"><a href="multiproject/axis2-xml/index.html">XML</a></li><li class="none"><a href="multiproject/axis2-wsdl/index.html">WSDL</a></li><li class="none"><a href="multiproject/axis2-tools/index.html">Tools</a></li><li class="none"><a href="multiproject/axis2-samples/index.html">Samples</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2" class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.htm">Migrating from Axis 1.x</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Sending_Binary_Data_With_SOAP"></a><h2>Sending Binary Data With SOAP</h2><ul>
+ Last published: 28 August 2005
+ | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="releases.html">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="">Axis 2 Modules</a><ul><li class="none"><a href="multiproject/axis2-core/index.html">Core</a></li><li class="none"><a href="multiproject/axis2-xml/index.html">XML</a></li><li class="none"><a href="multiproject/axis2-wsdl/index.html">WSDL</a></li><li class="none"><a href="multiproject/axis2-tools/index.html">Tools</a></li><li class="none"><a href="multiproject/axis2-samples/index.html">Samples</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2" class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.html">Migrating from Axis 1.x</a></li><li class="none"><a href="otherTutorials.html">Other Tutorials</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Sending_Binary_Data_with_SOAP"></a><h2>Sending Binary Data with SOAP</h2><ul>
<li><a href="#1">Introduction</a></li>
<li><a href="#2">MTOM with Axis2 </a>
<ul>
@@ -28,8 +28,8 @@
Traditionally, two techniques for dealing with opaque data in XML have been used;</p><ol>
<li><strong> "By value"</strong> </li>
<blockquote>
- <p>Sending binary data by value is achieved by embedding opaque data(of course after some form of encoding) as element or attribute content of the XML component of data.
- The main advantage of this technique is that it give applications the ability to process and describe data based and looking only on XML component of the data. </p>
+ <p>Sending binary data by value is achieved by embedding opaque data (of course after some form of encoding) as element or attribute content of the XML component of data.
+ The main advantage of this technique is that it gives applications the ability to process and describe data based and looking only on XML component of the data. </p>
<p>XML supports opaque data as content through the use of either base64 or hexadecimal text encoding.
Both these techniques bloat the size of the data. For UTF-8 underlying text encoding, base64 encoding increases the size of the binary data by a factor of 1.33x of the original size, while hexadecimal encoding expands data by a factor of 2x. Above factors will be doubled if UTF-16 text encoding is used. Also of concern is the overhead in processing costs (both real and perceived) for these formats, especially when decoding back into raw binary.</p>
</blockquote>
@@ -40,11 +40,16 @@
as external unparsed general entities
-outside of the XML document and then embedding reference URI's to those entities as elements or attribute values. This prevents the uneccesary bloating of data and wasting of processing power.
+outside of the XML document and then embedding reference URI's to those entities as elements or attribute values. This prevents the
+
+
+ unnecessary
+
+ bloating of data and wasting of processing power.
The primary obstacle for using these unparsed entities is their heavy reliance on DTDs, which impedes modularity as well as use of XML namespaces. </p>
- <p>There were several specifications introduced in the web services world to deal with this binary attachment problem using the "by reference" technique. <a href="http://www.w3.org/TR/SOAP-attachments" class="externalLink" title="External Link">SOAP with Attachments</a> is one such example. Since SOAP prohibits document type declarations (DTD) in messages, this leads to the problem of not representing data as part of the message infoset, creating two data models. This scenerio is like sending attachments with an e-mail message. Even though those attachments are related to the message content they are not inside the message. This causes the technologies
+ <p>There were several specifications introduced in the web services world to deal with this binary attachment problem using the "by reference" technique. <a href="http://www.w3.org/TR/SOAP-attachments" class="externalLink" title="External Link">SOAP with Attachments</a> is one such example. Since SOAP prohibits document type declarations (DTD) in messages, this leads to the problem of not representing data as part of the message infoset, creating two data models. This scenario is like sending attachments with an e-mail message. Even though those attachments are related to the message content they are not inside the message. This causes the technologies
for processing and description of data based on XML component of the data, to malfunction. One example is WS-Security. </p>
@@ -53,25 +58,25 @@
</ol><p><a href="http://www.w3.org/TR/2004/PR-soap12-mtom-20041116/" class="externalLink" title="External Link">MTOM
-(SOAP Message Transmission Optimization Mechanism)</a> is another specification which focuses on solving the "Attachments" problem. MTOM tries to leverage the advantages of above two techniques by trying to merge the above two techniques. MTOM is actually a "by reference" method. Wire format of a MTOM optimised message is same as the Soap with Attachments message , which also makes it backward compatible with SwA endpoints. The most notable feature of MTOM is the use of XOP:Include element, which is defined in <a href="http://www.w3.org/TR/2004/PR-xop10-20041116/" class="externalLink" title="External Link">XML Binary Optimized Packaging (XOP)</a> specification to reference the binary attachments (external unparsed general entities) of the message.With the use of this exclusive element the attached binary content logically become inline(by value) with the SOAP document even though actually it is attached seperately. This merges the two realms by making it possible to work only with one data model. This allows the apllications to process and describe by only looking at XML part making reliance on DTDs obsolute. On a lighter note MTOM has standarized the referencing mechanism of SwA. Following is an extract from the <a href="http://www.w3.org/TR/2004/PR-xop10-20041116/" class="externalLink" title="External Link">XOP</a> specification.</p><p><em> At the conceptual level, this binary data can be thought of as being base64-encoded in the XML Document. As this conceptual form might be needed during some processing of the XML Document (e.g., for signing the XML document), it is necessary to have a one to one correspondence between XML Infosets and XOP Packages. Therefore, the conceptual representation of such binary data is as if it were base64-encoded, using the canonical lexical form of XML Schema base64Binary datatype (see <a href="#XMLSchemaP2">[XML Schema Part 2: Datatypes Second Edition] </a><a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#base64Binary" class="externalLink" title="External Link">3.2.16 base64Binary </a>). In the reverse direction, XOP is capable of optimizing only base64-encoded Infoset data that is in the canonical lexical form. </em></p><p>Apache Axis2 supports <strong>Base64 encoding</strong>, <strong>SOAP with Attachments</strong> & <strong>MTOM (SOAP Message Transmission Optimization Mechanism).</strong></p><p><a name="2"></a></p></div></div><div class="section"><a name="MTOM_with_Axis2"></a><h2>MTOM with Axis2</h2><p><a name="21"></a></p><div class="subsection"><a name="Programming_Model"></a><h3>Programming Model</h3><p>AXIOM is an (may be the first) Object Model which has the ability to hold binary data. It has been given this ability by allowing OMText to hold raw binary content in the form of javax.activation.DataHandler. OMText has been chosen for this purpose with two reasons. One is that XOP (MTOM) is capable of optimizing only base64-encoded Infoset data that is in the canonical lexical form of XML Schema base64Binary datatype. Other one is to preserve the infoset in both sender and receiver (To store the binary content in the same kind of object regardless of whether it is optimized or not). </p><p>MTOM allows to
+(SOAP Message Transmission Optimization Mechanism)</a> is another specification which focuses on solving the "Attachments" problem. MTOM tries to leverage the advantages of above two techniques by trying to merge the above two techniques. MTOM is actually a "by reference" method. Wire format of a MTOM optimized message is same as the Soap with Attachments message, which also makes it backward compatible with SwA endpoints. The most notable feature of MTOM is the use of XOP:Include element, which is defined in <a href="http://www.w3.org/TR/2004/PR-xop10-20041116/" class="externalLink" title="External Link">XML Binary Optimized Packaging (XOP)</a> specification to reference the binary attachments (external unparsed general entities) of the message. With the use of this exclusive element the attached binary content logically become inline (by value) with the SOAP document even though actually it is attached separately. This merges the two realms by making it possible to work only with one data model. This allows the applications to process and describe by only looking at XML part making reliance on DTDs obsolete. On a lighter note MTOM has standardized the referencing mechanism of SwA. Following is an extract from the <a href="http://www.w3.org/TR/2004/PR-xop10-20041116/" class="externalLink" title="External Link">XOP</a> specification.</p><p><em> At the conceptual level, this binary data can be thought of as being base64-encoded in the XML Document. As this conceptual form might be needed during some processing of the XML Document (e.g., for signing the XML document), it is necessary to have a one to one correspondence between XML Infosets and XOP Packages. Therefore, the conceptual representation of such binary data is as if it were base64-encoded, using the canonical lexical form of XML Schema base64Binary datatype (see <a href="#XMLSchemaP2">[XML Schema Part 2: Datatypes Second Edition] </a><a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#base64Binary" class="externalLink" title="External Link">3.2.16 base64Binary</a>). In the reverse direction, XOP is capable of optimizing only base64-encoded Infoset data that is in the canonical lexical form. </em></p><p>Apache Axis2 supports <strong>Base64 encoding</strong>, <strong>SOAP with Attachments</strong> & <strong>MTOM (SOAP Message Transmission Optimization Mechanism).</strong></p><p><a name="2"></a></p></div></div><div class="section"><a name="MTOM_with_Axis2"></a><h2>MTOM with Axis2</h2><p><a name="21"></a></p><div class="subsection"><a name="Programming_Model"></a><h3>Programming Model</h3><p>AXIOM is an (may be the first) Object Model which has the ability to hold binary data. It has been given this ability by allowing OMText to hold raw binary content in the form of javax.activation.DataHandler. OMText has been chosen for this purpose with two reasons. One is that XOP (MTOM) is capable of optimizing only base64-encoded Infoset data that is in the canonical lexical form of XML Schema base64Binary datatype. Other one is to preserve the infoset in both sender and receiver (To store the binary content in the same kind of object regardless of whether it is optimized or not). </p><p>MTOM allows to
- selectively encode portions of the message, which allows us to send base64encoded data as well as externally attached raw binary data referenced by "XOP" element (Optimised content) to be send in a SOAP message.
+ selectively encode portions of the message, which allows us to send base64encoded data as well as externally attached raw binary data referenced by "XOP" element (optimized content) to be send in a SOAP message.
-User can specify whether a OMText node which contains raw binary data or base64encoded binary data is qualified to be optimized or not at the contruction time of that node or later. To take the optimum efficiency of MTOM a user is advised to send smaller binary attachments using base64encoding (Non optimised) and larger attachments as optimised content.</p>
+User can specify whether an OMText node which contains raw binary data or base64encoded binary data is qualified to be optimized or not at the construction time of that node or later. To take the optimum efficiency of MTOM a user is advised to send smaller binary attachments using base64encoding (None optimized) and larger attachments as optimized content.</p>
<div class="source"><pre>
<pre> OMElement imageElement = fac.createOMElement("image", omNs);
// Creating the Data Handler for the image.
// User has the option to use a FileDataSource or a ImageDataSource
- // in this scenerio...
+ // in this scenario...
Image image;
image = new JDK13IO()
.loadImage(new FileInputStream(inputImageFileName));
ImageDataSource dataSource = new ImageDataSource("test.jpg",image);
DataHandler dataHandler = new DataHandler(dataSource);
- //create a OMText node with the above DataHandler and set optimised to true
+ //create an OMText node with the above DataHandler and set optimized to true
OMText textData = fac.createText(dataHandler, true);
imageElement.addChild(textData);
@@ -83,9 +88,9 @@
<pre> String base64String = "xxxxxxxx";
OMText binaryNode = fac.createText(base64String,"image/jpg",true);</pre>
</pre></div>
- <p>Axis2 uses javax.activation.DataHandler to handle the binary data. All optimised binary content nodes will be serialised as Base64 Strings if "MTOM is not enabled". One can also create binary content nodes which will not be optimised at any case. They will be serialised and send as Base64 Strings. </p>
+ <p>Axis2 uses javax.activation.DataHandler to handle the binary data. All optimized binary content nodes will be serialized as Base64 Strings if "MTOM is not enabled". One can also create binary content nodes which will not be optimized at any case. They will be serialized and send as Base64 Strings. </p>
<div class="source"><pre>
-<pre> //create a OMText node with the above DataHandler and set optimised to false
+<pre> //create an OMText node with the above DataHandler and set "optimized" to false
//This data will be send as Base64 encoded string regardless of MTOM is enabled or not
OMText textData = fac.createText(dataHandler, false);
image.addChild(textData);</pre>
@@ -96,14 +101,14 @@
call.setTo(targetEPR);
call.set(Constants.Configuration.ENABLE_MTOM, Constants.VALUE_TRUE);</pre>
</pre></div>
- <p> When this property is set to true any SOAP envelope which contains optimizable content (OMText nodes containing binary content with optimizable flag "true") will be serialised as a MTOM optimized message. Messages will not be packaged as MTOM if they did not contain any optimizable content even though MTOM is enabled. </p><p>Axis2 serializes all binary content nodes as Base64 encoded strings regardless of they are qualified to be optimize or not, if, </p><ul>
+ <p> When this property is set to true any SOAP envelope which contains optimizable content (OMText nodes containing binary content with optimizable flag "true") will be serialized as a MTOM optimized message. Messages will not be packaged as MTOM if they did not contain any optimizable content even though MTOM is enabled. </p><p>Axis2 serializes all binary content nodes as Base64 encoded strings regardless of they are qualified to be optimize or not, if, </p><ul>
<li>"enableMTOM" property is set to false.</li>
<li>If envelope contains any element information items of name xop:Include (see <a href="#XOP">[XML-binary Optimized Packaging] </a><a href="http://www.w3.org/TR/2005/REC-xop10-20050125/#xop_infosets" class="externalLink" title="External Link">3. XOP Infosets Constructs </a>). </li>
-</ul><p>MTOM is *always enabled* in Axis2 when it comes to receiving messages. Axis2 will automatically identify and de-serilize any MTOM messge it receives. </p><p></p><p><a name="23"></a></p></div><div class="subsection"><a name="Enabling_MTOM_optimization_in_the_Server_side"></a><h3>Enabling MTOM optimization in the Server side</h3><p>Axis 2 server automatically identifies incoming MTOM optimized messages based on the content-type and de-serializes accordingly. One can enableMTOM in the server side for outgoing messages,</p><ul>
+</ul><p>MTOM is *always enabled* in Axis2 when it comes to receiving messages. Axis2 will automatically identify and de-serialize any MTOM message it receives. </p><p></p><p><a name="23"></a></p></div><div class="subsection"><a name="Enabling_MTOM_optimization_in_the_Server_side"></a><h3>Enabling MTOM optimization in the Server side</h3><p>Axis 2 server automatically identifies incoming MTOM optimized messages based on the content-type and de-serializes accordingly. User can enableMTOM in the server side for outgoing messages,</p><ul>
<li> Globally for all services
<blockquote>
- <p>by adding and setting the "enableMTOM" parameter to true in the Axis2.xml.
- When it is set, *outgoing* messages *which contains optimizable content* will be serialized and send as a MTOM optimized messages. If it is not set all the binary content nodes will be serialized as Base64 encoded strings. </p>
+ <p> add and set the "enableMTOM" parameter to true in the Axis2.xml.
+ When it is set, *outgoing* messages *which contains optimizable content* will be serialized and send as a MTOM optimized messages. If it is not set all the binary data in binary content nodes will be serialized as Base64 encoded strings. </p>
</blockquote>
</li>
</ul><p>
@@ -144,7 +149,8 @@
<ul>
<li><strong><a name="242"></a>Client </strong></li>
</ul>
- <div class="source"><pre><pre>
+ <div class="source"><pre>
+<pre>
call.setTo(targetEPR);
// enabling MTOM
call.set(Constants.Configuration.ENABLE_MTOM, Constants.VALUE_TRUE);
@@ -157,16 +163,18 @@
OMElement ele = (OMElement) result.getFirstChild();
OMText binaryNode = (OMText) ele.getFirstChild();
- // Retreiving the DataHandler & then do whatever the processing to the data
+ // Retrieving the DataHandler & then do whatever the processing to the data
DataHandler actualDH;
actualDH = binaryNode.getDataHandler();
Image actualObject = new JDK13IO().loadImage(actualDH.getDataSource()
.getInputStream());
-</pre></pre></div>
- <p><a name="3"></a></p></div></div><div class="section"><a name="SOAP_with_Attachments__SwA__with_Axis2"></a><h2>SOAP with Attachments (SwA) with Axis2</h2><p>Axis2 Handles SwA messages at the inflow only. When Axis2 receives a SwA message it extracts the binary attachment parts and put a reference to those parts in the Message Context. Users can access binary attachements using the content-id. Care should be taken to rip off the "cid" prefix when content-id is taken from the "Href" attributes. When accessing the message context from a service users need to use the message context injection mechanism by introducing a "init" methode to the service class.(see the folloowing service example) </p><p>Note: Axis2 supports content-id referencing only. Does not support Content Location referencing.</p><ul>
+</pre>
+</pre></div>
+ <p><a name="3"></a></p></div></div><div class="section"><a name="SOAP_with_Attachments__SwA__with_Axis2"></a><h2>SOAP with Attachments (SwA) with Axis2</h2><p>Axis2 Handles SwA messages at the inflow only. When Axis2 receives a SwA message it extracts the binary attachment parts and put a reference to those parts in the Message Context. Users can access binary attachments using the content-id. Care should be taken to rip off the "cid" prefix when content-id is taken from the "Href" attributes. When accessing the message context from a service users need to use the message context injection mechanism by introducing an "init" method to the service class.(see the following service example) </p><p>Note: Axis2 supports content-id referencing only. Axis2 does not support Content Location referencing of MIME parts. </p><ul>
<li><strong>Sample service which accepts a SwA message</strong></li>
</ul>
- <div class="source"><pre><pre>
+ <div class="source"><pre>
+<pre>
public class EchoSwA {
private MessageContext msgcts;
@@ -185,7 +193,7 @@
contentID = contentID.substring(4);
}
- // Retreiving the MIMEHelper instance (which contains reference to attachments)
+ // Retrieving the MIMEHelper instance (which contains reference to attachments)
// from the Message Context
MIMEHelper attachments = (MIMEHelper)msgcts.getProperty(MIMEHelper.ATTACHMENTS);
// Retrieving the respective DataHandler referenced by the content-id
@@ -200,8 +208,9 @@
}
}
-</pre></pre></div>
- <p>MTOM specification is designed to be backward compatible with the SOAP with Attachments specification. Even though the representation is different, both technologies have the same wire format. We can safely assume that any SOAP with Attachments endpoint can accept a MTOM optimized messages and treat them as SOAP with Attachment messages - Any MTOM optimised message is a valid SwA message. Because of that Axis2 does not define a seperate programming model or serialization for SwA. Users can use the MTOM programming model and serialization to send messages to SwA endpoints. </p><p>Note : Above is tested with Axis 1.x</p><ul>
+</pre>
+</pre></div>
+ <p>MTOM specification is designed to be backward compatible with the SOAP with Attachments specification. Even though the representation is different, both technologies have the same wire format. We can safely assume that any SOAP with Attachments endpoint can accept a MTOM optimized messages and treat them as SOAP with Attachment messages - Any MTOM optimized message is a valid SwA message. Because of that Axis2 does not define a separate programming model or serialization for SwA. Users can use the MTOM programming model and serialization to send messages to SwA endpoints. </p><p>Note : Above is tested with Axis 1.x</p><ul>
<li><strong>A sample SwA message from Axis 1.x </strong></li>
</ul>
<div class="source"><pre>
@@ -263,8 +272,8 @@
</pre></div>
<p><a name="4"></a></p></div><div class="section"><a name="Advanced_Topics"></a><h2>Advanced Topics</h2><p><a name="41"></a></p><div class="subsection"><a name="File_Caching_For_Attachments"></a><h3>File Caching For Attachments</h3><p>Axis2 comes handy with a file caching mechanism for incoming attachments, which gives Axis2 the
ability to handle very large attachments without buffering them in memory at any time. Axis2 file
-caching streams the incoming MIME parts directly in to files, after reading the MIME part headers.</p><p>Also a user can specify a size threshold for the File caching.When this threshold value is specified, only the attachments whose size is bigget than the threshold value will get
-cached in files. Smaller attachmments will remain in Memory. </p><p>NOTE : It is a must to specify a directory to temporary store the attachments. Also care should be taken to *clean that directory* time to time.</p><p>The following parameters needs to be set in Axis2.xml in order to enable file caching.</p>
+caching streams the incoming MIME parts directly in to files, after reading the MIME part headers.</p><p>Also a user can specify a size threshold for the File caching. When this threshold value is specified, only the attachments whose size is bigger than the threshold value will get
+cached in files. Smaller attachments will remain in Memory. </p><p>NOTE : It is a must to specify a directory to temporary store the attachments. Also care should be taken to *clean that directory* time to time.</p><p>The following parameters need to be set in Axis2.xml in order to enable file caching.</p>
<div class="source"><pre><pre>
<em><axisconfig name="AxisJava2.0">
<!-- ================================================= -->