deepal 2005/08/16 01:44:47
Modified: targets/axis2 index.html installationguide.html
Added: targets/axis2 migration.html
Removed: targets/axis2 migration.htm
Log:
Revision Changes Path
1.19 +1 -1 ws-site/targets/axis2/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis2/index.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- index.html 16 Aug 2005 08:01:08 -0000 1.18
+++ index.html 16 Aug 2005 08:44:46 -0000 1.19
@@ -3,7 +3,7 @@
@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="Welcome_to_Apache_Axis2"></a><h2>Welcome to Apache Axis2</h2><p>
+ | 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="Welcome_to_Apache_Axis2"></a><h2>Welcome to Apache Axis2</h2><p>
Apache Axis2 is an implementation of the
<a href="http://www.w3.org/TR/soap/"; class="externalLink" title="External
Link">Simple Object Access Protocol (SOAP)
Recommendation</a> from the <a href="http://www.w3.org"; class="externalLink"
title="External Link">W3C</a>. Axis2 can be used
1.11 +1 -1 ws-site/targets/axis2/installationguide.html
Index: installationguide.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis2/installationguide.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- installationguide.html 16 Aug 2005 08:01:08 -0000 1.10
+++ installationguide.html 16 Aug 2005 08:44:46 -0000 1.11
@@ -4,7 +4,7 @@
@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="Introduction"></a><h2>Introduction</h2><p>Axis 2.0 can be downloaded as a
<a href="releases.html">zipped binary </a>
-or the <a
href="href=http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN";>source
</a>.
+or the <a
href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/?root=Apache-SVN";>source
</a>.
This section describes how Axis2 can be installed either as a
standalone server or as part of a J2EE compliant servlet container.
</p></div><div class="section"><a
name="Prerequisites"></a><h2>Prerequisites</h2><p>Axis2 requires the Java
Runtime Environment to be properly
installed. Axis2 is developed to be run on JRE 1.4 and upwards but it
1.1 ws-site/targets/axis2/migration.html
Index: migration.html
===================================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";><html><head><title>Axis
2.0 - Migrating from Axis 1.x</title><style type="text/css" media="all">
@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>
<div class="source"><pre>
import ..
public class TestClient {
public static void main(String [] args) {
try {
String endpoint = ...
Service service = new Service();
Call call = (Call) service.createCall();
call.setTargetEndpointAddress( new
java.net.URL(endpoint) );
call.setOperationName(new
QName("http://soapinterop.org/";, echoString"));
String ret = (String) call.invoke( new Object[] {
"Hello!" } );
System.out.println("Sent 'Hello!', got '" + ret + "'");
} catch (Exception e) {
System.err.println(e.toString());
}
}
}
</pre></div>
<p><b>Axis 2</b></p>
<div class="source"><pre>
import ....
public class EchoBlockingClient {
private static EndpointReference targetEPR = new EndpointReference(
AddressingConstants.WSA_TO,
"http://127.0.0.1:8080/axis2/services/MyService/echo";);
public static void main(String[] args) {
try {
OMElement payload = ClientUtil.getEchoOMElement();
Call call = new Call();
call.setTo(targetEPR);
call.setTransportInfo(Constants.TRANSPORT_HTTP,Constants.TRANSPORT_HTTP,false);
//Blocking invocation
OMElement result = (OMElement)
call.invokeBlocking("echo",payload);
...
} catch (AxisFault axisFault) {
axisFault.printStackTrace();
} catch (XMLStreamException e) {
e.printStackTrace();
}
}
}
</pre></div>
<p>It has clearly depicted that the invocation in Axis2 is dealt with SOAP
body element itself. Here the invocation is synchronous, and Axis2 can handle
Asynchronous invocation as well. Above "payload" is the SOAP body element which
should go in the Envelop.</p><p>Once the service is called through Stub in
Axis2, "payload" is according to the data binding framework that will be using.
So the extra work of "payload" will be vanished.</p><p>Apart from Synchronous
invocation, Axis2 support Asynchronous invocation through invokeNonBlocking().
Synchronous/Asynchronous invocations can handle both single/double HTTP
connection.</p><p>With the advance architecture Axis2 is capable of handling
Megabytes of Requests and Responses, which is far form Axis1.x. </p></div><div
class="subsection"><a
name="Custom_Deployment_of_Services__Handlers_and_Modules"></a><h3>Custom
Deployment of Services, Handlers and Modules</h3><p>In Axis 1.x deployment of
services is via WSDD, which is for my opinion highly cumbersome. Service
deployment in Axis2 is straight forward and dynamic. Dynamic behavior is from
the Administrator facility given by development in server side. It's just a
matter of creating a .aar file, and deploying it ,which more detail is given in
the Axis2 user guide.</p><p>Axis2 is far way from Handler concept and more into
the Module concept, which is abstractly speaking, a collection of handlers with
Rules of governing. Modules created as a .mar file. It has module.xml, which is
the brain behind manipulating handlers.</p><p>When a service is called through
a handler, it is just a matter of giving reference to the module that includes
the handler in the service.xml. Apart from that a handler can be directly
called to a particular service, via service.xml, no module is needed, and
several handlers can be invoked when the handlers are registered with the
proper phases.</p><p>Services are hot deployable in Axis2 and dynamic, but
Modules. This is one feature, which is unique to Axis2.</p></div><div
class="subsection"><a name="Transports_for_HTTP_Connection"></a><h3>Transports
for HTTP Connection</h3><p>Axis2 comes with two CommonsHTTPTransportSender
which is based on commons-httpclient. The configuration of the transport is as
follows,</p>
<div class="source"><pre>
call.setTransportInfo(Constants.TRANSPORT_HTTP, Constants.TRANSPORT_HTTP,
false);
</pre></div>
<p>It should be noted that axis2.xml should be configured to call the
commos transports, with the statement,</p>
<div class="source"><pre> <parameter name="PROTOCOL"
locked="xsd:false">HTTP/1.1</parameter>
</pre></div>
<p>In above snippet it should be noted that transport is configured to
handle the chunked stream as well. Some web services, such as .NET web service
invocations are done through this transport, as it handle all possible HTTP
request and responses.</p><p>Data Binding Support</p><p>Xml-beans is ued to
provide data binding support. In Axis2, xml is manipulated via AXIOM, which is
based on StAX API. XML give full schema support. Thus, serialization and
deserialization of Xml is handle in Axis2 via xml-data binding
framework.</p></div><div class="subsection"><a name="Best_Usage"></a><h3>Best
Usage</h3><p>Axis1.x and Axis2 have different ways of seen the SOAP stack. So
the best way to migrate can be done through following the User guide and
Architecture guide properly in Axis2. Axis2 is straight forward and
friendly.</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>
![http://www.apache.org/images/asf-logo.gif"](http://www.apache.org/images/asf-logo.gif"){kind=link}
![http://ws.apache.org/axis/images/axis.jpg"](http://ws.apache.org/axis/images/axis.jpg"){kind=link}