axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dee...@apache.org
Subject svn commit: r565295 [5/14] - in /webservices/axis2/site/1_3: ./ adb/ jibx/ src/
Date Mon, 13 Aug 2007 10:13:23 GMT
Added: webservices/axis2/site/1_3/http-transport.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_3/http-transport.html?view=auto&rev=565295
==============================================================================
--- webservices/axis2/site/1_3/http-transport.html (added)
+++ webservices/axis2/site/1_3/http-transport.html Mon Aug 13 03:13:18 2007
@@ -0,0 +1,575 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+<html>
+  <head>
+    <title>Apache Axis2 - </title>
+    <style type="text/css" media="all">
+      @import url("../css/maven-base.css");
+      @import url("../css/maven-theme.css");
+      @import url("../css/site.css");
+    </style>
+    <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+      </head>
+  <body class="composite">
+    <div id="banner">
+                  <a href="../" id="bannerLeft">
+    
+                                    <img src="http://www.apache.org/images/asf_logo_wide.png" alt="" />
+    
+            </a>
+                          <span id="bannerRight">
+    
+                                    <img src="http://ws.apache.org/axis2/images/axis.jpg" alt="" />
+    
+            </span>
+            <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="breadcrumbs">
+          
+  
+
+  
+    
+  
+  
+            <div class="xleft">
+        Last Published: 08/13/2007
+                      </div>
+            <div class="xright">      <a href="../index.html">Axis2/Java</a>
+          |
+          <a href="http://ws.apache.org/axis2/c">Axis2/C</a>
+          |
+          <a href="../../../">Apache WS</a>
+          |
+          <a href="http://www.apache.org">Apache</a>
+          
+  
+
+  
+    
+  
+  
+  </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="leftColumn">
+      <div id="navcolumn">
+           
+  
+
+  
+    
+  
+  
+                   <h5>Axis2/Java</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../index.html">Home</a>
+        </li>
+          </ul>
+          <h5>Downloads</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../download.cgi">Releases</a>
+        </li>
+              
+    <li class="none">
+              <a href="../modules/index.html">Modules</a>
+        </li>
+              
+    <li class="none">
+              <a href="../tools/index.html">Tools</a>
+        </li>
+          </ul>
+          <h5>Documentation</h5>
+        <ul>
+              
+          
+              
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+              
+        <li class="expanded">
+              <a href="../1_3/contents.html">Version 1.3</a>
+                <ul>
+                  
+    <li class="none">
+              <a href="../1_3/toc.html">Table of Contents</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/installationguide.html">Installation Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/quickstartguide.html">QuickStart Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/userguide.html">User Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/pojoguide.html">POJO Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/spring.html">Spring Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/webadminguide.html">Web Administrator's Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/migration.html">Migration Guide (from Axis1)</a>
+        </li>
+              </ul>
+        </li>
+              
+    <li class="none">
+              <a href="../1_2/contents.html">Version 1.2</a>
+        </li>
+              
+    <li class="none">
+              <a href="../1_1_1/contents.html">Version 1.1.1</a>
+        </li>
+              
+    <li class="none">
+              <a href="../1_1/contents.html">Version 1.1</a>
+        </li>
+              
+    <li class="none">
+              <a href="../1_0/index.html">Version 1.0</a>
+        </li>
+              
+    <li class="none">
+              <a href="../0_95/index.html">Version 0.95</a>
+        </li>
+              
+    <li class="none">
+              <a href="../0_94/index.html">Version 0.94</a>
+        </li>
+              
+    <li class="none">
+              <a href="../0_93/index.html">Version 0.93</a>
+        </li>
+          </ul>
+          <h5>Resources</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../faq.html">FAQ</a>
+        </li>
+              
+    <li class="none">
+              <a href="../articles.html">Articles</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://wiki.apache.org/ws/FrontPage/Axis2/">Wiki</a>
+        </li>
+              
+    <li class="none">
+              <a href="../refLib.html">Reference Library</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://ws.apache.org/axis2/1_3/api/index.html">Online Java Docs</a>
+        </li>
+          </ul>
+          <h5>Get Involved</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../overview.html">Overview</a>
+        </li>
+              
+    <li class="none">
+              <a href="../svn.html">Checkout the Source</a>
+        </li>
+              
+    <li class="none">
+              <a href="../mail-lists.html">Mailing Lists</a>
+        </li>
+              
+    <li class="none">
+              <a href="../release-process.html">Release Process</a>
+        </li>
+              
+    <li class="none">
+              <a href="../guidelines.html">Developer Guidelines</a>
+        </li>
+              
+    <li class="none">
+              <a href="../siteHowTo.html">Build the Site</a>
+        </li>
+          </ul>
+          <h5>Project Information</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../team-list.html">Project Team</a>
+        </li>
+              
+    <li class="none">
+              <a href="../issue-tracking.html">Issue Tracking</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN">Source Code</a>
+        </li>
+              
+    <li class="none">
+              <a href="../thanks.html">Acknowledgements</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a>
+        </li>
+          </ul>
+                                       <a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy">
+            <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img>
+          </a>
+                       
+  
+
+  
+    
+  
+  
+        </div>
+    </div>
+    <div id="bodyColumn">
+      <div id="contentBox">
+        <html>
+<head>
+  <meta http-equiv="content-type" content=""></meta>
+  HTTP transports
+  <link href="../css/axis-docs.css" rel="stylesheet" type="text/css" media="all"></link>
+</head>
+
+
+<a name="configTransport"></a>
+
+<h1>HTTP Transport</h1>
+
+<p>This document covers the sending and receiving of SOAP messages with Axis2 using HTTP
+as the transport mechanism.</p>
+
+<h2>Contents</h2>
+<ul>
+  <li><a href="#CommonsHTTPTransportSender">CommonsHTTPTransportSender</a>
+    <ul>
+      <li><a href="#httpsupport">HTTPS support</a></li>
+    </ul>
+  </li>
+  <li><a href="#timeout_config">Timeout Configuration</a></li>
+  <li><a href="#version_config">HTTP Version Configuration</a></li>
+  <li><a href="#auth">Proxy Authentication</a></li>
+  <li><a href="#preemptive_auth">Basic, Digest and NTLM Authentication</a></li>
+  <li><a href="#reusing_httpclient_object">Reusing the httpclient object</a></li>
+  <li><a href="#setting_cached_httpclient_object">Setting the cached httpclient object</a></li>
+</ul>
+<a name="CommonsHTTPTransportSender"></a>
+
+<h2>CommonsHTTPTransportSender</h2>
+
+CommonsHTTPTransportSender is the transport sender that is used by default in both
+the Server and Client APIs. As its name implies, it is based on commons-httpclient-3.0.1. 
+For maximum flexibility, this sender supports both the HTTP GET and POST interfaces.
+(REST in Axis2 also supports both interfaces.)
+
+Commons HttpClient also provides HTTP 1.1, Chunking and KeepAlive support for Axis2.
+
+The &lt;transportSender/&gt; element defines transport senders in
+the axis2.xml configuration file as follows:
+<pre>
+&lt;transportSender name=&quot;http&quot; class=&quot;org.apache.axis2.transport.http.CommonsHTTPTransportSender&quot;&gt;
+   &lt;parameter name=&quot;PROTOCOL&quot;&gt;HTTP/1.1&lt;/parameter&gt;
+   &lt;parameter name=&quot;Transfer-Encoding&quot;&gt;chunked&lt;/parameter&gt;
+&lt;/transportSender&gt;
+</pre>
+
+The above code snippet shows the simplest configuration of a transport
+sender for common use. The &lt;parameter/&gt; element is used to specify additional
+constraints that the sender should comply with. The HTTP PROTOCOL parameter
+should be set as HTTP/1.0 or HTTP/1.1. The default version is HTTP/1.1. Note that
+chunking support is available only for HTTP/1.1. Thus, even if &quot;chunked&quot; is specified
+as a parameter, if the HTTP version is 1.0, this setting will be
+ignored by the transport framework. Also, KeepAlive is enabled by default in
+HTTP/1.1.
+If you use HTTP1.1 for its Keep-Alive ability, but you need to disable
+chunking at runtime (some servers don't allow chunked requests to
+prevent denial of service), you can do so in the Stub:
+
+    
+<pre>
+options.setProperty(HTTPConstants.CHUNKED, &quot;false&quot;);
+</pre>
+
+Some absolute properties are provided at runtime instead.  For example, character
+encoding style (UTF-8, UTF-16, etc.) is provided via MessageContext.
+<a name="httpsupport"></a>
+
+<h3>HTTPS support</h3>
+CommonsHTTPTransportSender can be also used to communicate over https.
+
+<pre>
+   &lt;transportSender name=&quot;<b>https</b>&quot; class=&quot;org.apache.axis2.transport.http.CommonsHTTPTransportSender&quot;&gt;
+      &lt;parameter name=&quot;PROTOCOL&quot;&gt;HTTP/1.1&lt;/parameter&gt;
+      &lt;parameter name=&quot;Transfer-Encoding&quot;&gt;chunked&lt;/parameter&gt;
+   &lt;/transportSender&gt;
+</pre>
+
+Please note that by default HTTPS works only when the server does not
+expect to authenticate the clients (1-way SSL only) and where the
+server has the clients' public keys in its trust store.
+
+If you want to perform SSL client authentication (2-way SSL), you may
+use the Protocol.registerProtocol feature of HttpClient. You can
+overwrite the &quot;https&quot; protocol, or use a different protocol for your
+SSL client authentication communications if you don't want to mess
+with regular https. Find more information at
+<a href="http://jakarta.apache.org/commons/httpclient/sslguide.html">http://jakarta.apache.org/commons/httpclient/sslguide.html</a>
+<a name="timeout_config"></a>
+
+<h2>Timeout Configuration</h2>
+
+Two timeout instances exist in the transport level, Socket timeout 
+and Connection timeout. These can be configured either at deployment
+or run time.  If configuring at deployment time, the user has to add the
+following lines in axis2.xml.
+
+<p>For Socket timeout:</p>
+<pre>&lt;parameter name=&quot;SO_TIMEOUT&quot;&gt;some_integer_value&lt;/parameter&gt;</pre>
+
+<p>For Connection timeout:</p>
+<pre> &lt;parameter name=&quot;CONNECTION_TIMEOUT&quot;&gt;some_integer_value&lt;/parameter&gt;</pre>
+<br></br>
+
+For runtime configuration, it can be set as follows within the client stub:<div class="source"><pre>
+<pre>
+...
+Options options = new Options();
+options.setProperty(HTTPConstants.SO_TIMEOUT, new Integer(timeOutInMilliSeconds));
+options.setProperty(HTTPConstants.CONNECTION_TIMEOUT, new Integer(timeOutInMilliSeconds));
+
+// or
+options.setTimeOutInMilliSeconds(timeOutInMilliSeconds);
+...
+</pre>
+
+</pre></div><a name="version_config"></a>
+
+<h2>HTTP Version Configuration</h2>
+
+<p>The default HTTP version is 1.1. There are two methods in which the user
+can change the HTTP version to 1.0</p>
+<ul>
+  <li>By defining the version in axis2.xml as shown below.
+  <pre> &lt;parameter name=&quot;PROTOCOL&quot;&gt;HTTP/1.0&lt;/parameter&gt;</pre></li>
+  <li>By changing the version at runtime by using code similar to the following:
+<pre>
+...
+options.setProperty(org.apache.axis2.context.MessageContextConstants.HTTP_PROTOCOL_VERSION,
+   org.apache.axis2.transport.http.HTTPConstants.HEADER_PROTOCOL_10);
+...
+</pre></li>
+</ul>
+<a name="auth"></a>
+
+<h2>Proxy Authentication</h2>
+
+The Commons-http client has built-in support for proxy
+authentication. Axis2 uses deployment time and runtime mechanisms to
+authenticate proxies. At deployment time, the user has to change the
+axis2.xml as follows. This authentication is available for both HTTP and
+HTTPS.
+<pre>
+&lt;transportSender name=&quot;<b>http</b>&quot; class=&quot;org.apache.axis2.transport.http.CommonsHTTPTransportSender&quot;&gt;
+   &lt;parameter name=&quot;PROTOCOL&quot;&gt;HTTP/1.1&lt;/parameter&gt;
+   &lt;parameter name=&quot;PROXY&quot; proxy_host=&quot;proxy_host_name&quot; proxy_port=&quot;proxy_host_port&quot;
+      &gt;userName:domain:passWord&lt;/parameter&gt;
+&lt;/transportSender&gt;</pre>
+
+For a particular proxy, if authentication is not available, enter the
+&quot;userName:domain:passWord&quot; as &quot;anonymous:anonymous:anonymous&quot;.
+
+<p>At runtime, the user can override the PROXY settings using the
+HttpTransportProperties.ProxyProperties object. Within your client stub, 
+create an instance of this object, configure proxy values for it,
+and then set it to the MessageContext's property bag via options.setProperty().
+For example:</p>
+<div class="source"><pre>
+<pre>
+...
+Options options = new Options();
+...
+
+HttpTransportProperties.ProxyProperties proxyProperties = new HttpTransportProperties.new ProxyProperties();
+proxyProperties.setProxyHostName(....);
+proxyProperties.setProxyPort(...);
+...
+options.setProperty(HttpConstants.PROXY, proxyProperties);
+...
+</pre>
+</pre></div>
+<p>The above code will override the deployment proxy configuration settings.</p>
+<a name="preemptive_auth"></a>
+
+<h2>Basic, Digest and NTLM Authentication</h2>
+
+<p>HttpClient supports three different types of HTTP authentication schemes:
+Basic, Digest and NTLM. Based on the challenge provided by the server,
+HttpClient automatically selects the authentication scheme with which the
+request should be authenticated.  The most secure method is NTLM and the Basic
+is the least secure.</p>
+
+<p>NTLM is the most complex of the authentication protocols supported by
+HttpClient. It requires an instance of NTCredentials to be available for the
+domain name of the server or the default credentials. Note that since NTLM
+does not use the notion of realms, HttpClient uses the domain name of the
+server as the name of the realm. Also note that the username provided to the
+NTCredentials should not be prefixed with the domain - ie: &quot;axis2&quot; is correct
+whereas &quot;DOMAIN\axis2&quot; is not correct.</p>
+
+<p>There are some significant differences in the way that NTLM works compared
+with basic and digest authentication. These differences are generally handled
+by HttpClient, however having an understanding of these differences can help
+avoid problems when using NTLM authentication.</p>
+<ol type="1">
+  <li>NTLM authentication works almost exactly the same way as any other form
+    of authentication in terms of the HttpClient API. The only difference is
+    that you need to supply 'NTCredentials' instead of
+    'UsernamePasswordCredentials' (NTCredentials actually extends
+    UsernamePasswordCredentials so you can use NTCredentials right throughout
+    your application if need be).</li>
+  <li>The realm for NTLM authentication is the domain name of the computer to
+    which you are being connected. This can become troublesome as servers often
+    have multiple domain names that refer to them. Only the domain name that
+    the HttpClient connects to (as specified by the HostConfiguration) is
+    used to look up the credentials. It is generally advised that while
+    initially testing NTLM authentication, you pass the realm as null, which
+    is its default value.</li>
+  <li>NTLM authenticates a connection and not a request. So you need to
+    authenticate every time a new connection is made, and keeping the
+    connection open during authentication is vital. Because of this, NTLM cannot
+    be used to authenticate with both a proxy and the server, nor can NTLM be
+    used with HTTP 1.0 connections or servers that do not support HTTP
+    keep-alives.</li>
+</ol>
+
+Axis2 also allows adding a custom Authentication Scheme to HttpClient.
+
+The static inner bean Authenticator of HttpTransportProperties will hold
+the state of the server to be authenticated with. Once filled, it has to be
+set to the Options's property bag with the key as HTTPConstants.AUTHENTICATE.
+The following code snippet shows how to configure the transport
+framework to use Basic Authentication:
+<div class="source"><pre>
+<pre>
+...
+Options options = new Options();
+ 
+HttpTransportProperties.Authenticator
+   auth = new HttpTransportProperties.Authenticator();
+auth.setUsername(&quot;username&quot;);
+auth.setPassword(&quot;password&quot;);
+// set if realm or domain is known
+
+options.setProperty(org.apache.axis2.transport.http.HTTPConstants.AUTHENTICATE, auth);
+...
+</pre>
+</pre></div>
+<a name="reusing_httpclient_object"></a>
+<h2>Reusing the httpclient object</h2>
+
+By default, a new httpclient object is created for each send. It may
+be worthwhile to reuse the same httpclient object to take advantage of
+HTTP1.1 Keep-Alive, especially in HTTPS environment, where the SSL
+handshake may not be of negligible cost. To reuse the same httpclient
+object, you can set the relevant property in the Stub:
+
+
+    <div class="source"><pre>
+        <pre>
+            options.setProperty(HTTPConstants.REUSE_HTTP_CLIENT, &quot;true&quot;);
+        </pre>
+    </pre></div>
+
+    <a name="setting_cached_httpclient_object"></a>
+<h2>Setting the cached httpclient object</h2>
+
+To control the max connections per host attempted in parallel by a
+reused httpclient (this can be worthwhile as the default value is 2
+connections per host), or any other advanced parameters, you need to
+set the cached httpclient object when your application starts up
+(before any actual axis request). You can set the relevant property in
+the Stub:
+
+    <div class="source"><pre>
+    <pre>
+MultiThreadedHttpConnectionManager conmgr = new
+MultiThreadedHttpConnectionManager();
+conmgr.getParams().setDefaultMaxConnectionsPerHost(10);
+HttpClient client = new HttpClient(conmgr);
+configurationContext.setProperty(HTTPConstants.CACHED_HTTP_CLIENT, client);
+</pre>
+    </pre></div>
+    
+
+</html>
+      </div>
+    </div>
+    <div class="clear">
+      <hr/>
+    </div>
+    <div id="footer">
+      <div class="xright">&#169;  
+          2004-2007
+    
+          Apache Software Foundation
+          
+  
+
+  
+    
+  
+  
+  </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+  </body>
+</html>

Added: webservices/axis2/site/1_3/index.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_3/index.html?view=auto&rev=565295
==============================================================================
--- webservices/axis2/site/1_3/index.html (added)
+++ webservices/axis2/site/1_3/index.html Mon Aug 13 03:13:18 2007
@@ -0,0 +1,311 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+<html>
+  <head>
+    <title>Apache Axis2 - </title>
+    <style type="text/css" media="all">
+      @import url("../css/maven-base.css");
+      @import url("../css/maven-theme.css");
+      @import url("../css/site.css");
+    </style>
+    <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+      </head>
+  <body class="composite">
+    <div id="banner">
+                  <a href="../" id="bannerLeft">
+    
+                                    <img src="http://www.apache.org/images/asf_logo_wide.png" alt="" />
+    
+            </a>
+                          <span id="bannerRight">
+    
+                                    <img src="http://ws.apache.org/axis2/images/axis.jpg" alt="" />
+    
+            </span>
+            <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="breadcrumbs">
+          
+  
+
+  
+    
+  
+  
+            <div class="xleft">
+        Last Published: 08/13/2007
+                      </div>
+            <div class="xright">      <a href="../index.html">Axis2/Java</a>
+          |
+          <a href="http://ws.apache.org/axis2/c">Axis2/C</a>
+          |
+          <a href="../../../">Apache WS</a>
+          |
+          <a href="http://www.apache.org">Apache</a>
+          
+  
+
+  
+    
+  
+  
+  </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="leftColumn">
+      <div id="navcolumn">
+           
+  
+
+  
+    
+  
+  
+                   <h5>Axis2/Java</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../index.html">Home</a>
+        </li>
+          </ul>
+          <h5>Downloads</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../download.cgi">Releases</a>
+        </li>
+              
+    <li class="none">
+              <a href="../modules/index.html">Modules</a>
+        </li>
+              
+    <li class="none">
+              <a href="../tools/index.html">Tools</a>
+        </li>
+          </ul>
+          <h5>Documentation</h5>
+        <ul>
+              
+          
+              
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+              
+        <li class="expanded">
+              <a href="../1_3/contents.html">Version 1.3</a>
+                <ul>
+                  
+    <li class="none">
+              <a href="../1_3/toc.html">Table of Contents</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/installationguide.html">Installation Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/quickstartguide.html">QuickStart Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/userguide.html">User Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/pojoguide.html">POJO Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/spring.html">Spring Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/webadminguide.html">Web Administrator's Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/migration.html">Migration Guide (from Axis1)</a>
+        </li>
+              </ul>
+        </li>
+              
+    <li class="none">
+              <a href="../1_2/contents.html">Version 1.2</a>
+        </li>
+              
+    <li class="none">
+              <a href="../1_1_1/contents.html">Version 1.1.1</a>
+        </li>
+              
+    <li class="none">
+              <a href="../1_1/contents.html">Version 1.1</a>
+        </li>
+              
+    <li class="none">
+              <a href="../1_0/index.html">Version 1.0</a>
+        </li>
+              
+    <li class="none">
+              <a href="../0_95/index.html">Version 0.95</a>
+        </li>
+              
+    <li class="none">
+              <a href="../0_94/index.html">Version 0.94</a>
+        </li>
+              
+    <li class="none">
+              <a href="../0_93/index.html">Version 0.93</a>
+        </li>
+          </ul>
+          <h5>Resources</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../faq.html">FAQ</a>
+        </li>
+              
+    <li class="none">
+              <a href="../articles.html">Articles</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://wiki.apache.org/ws/FrontPage/Axis2/">Wiki</a>
+        </li>
+              
+    <li class="none">
+              <a href="../refLib.html">Reference Library</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://ws.apache.org/axis2/1_3/api/index.html">Online Java Docs</a>
+        </li>
+          </ul>
+          <h5>Get Involved</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../overview.html">Overview</a>
+        </li>
+              
+    <li class="none">
+              <a href="../svn.html">Checkout the Source</a>
+        </li>
+              
+    <li class="none">
+              <a href="../mail-lists.html">Mailing Lists</a>
+        </li>
+              
+    <li class="none">
+              <a href="../release-process.html">Release Process</a>
+        </li>
+              
+    <li class="none">
+              <a href="../guidelines.html">Developer Guidelines</a>
+        </li>
+              
+    <li class="none">
+              <a href="../siteHowTo.html">Build the Site</a>
+        </li>
+          </ul>
+          <h5>Project Information</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../team-list.html">Project Team</a>
+        </li>
+              
+    <li class="none">
+              <a href="../issue-tracking.html">Issue Tracking</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN">Source Code</a>
+        </li>
+              
+    <li class="none">
+              <a href="../thanks.html">Acknowledgements</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a>
+        </li>
+          </ul>
+                                       <a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy">
+            <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img>
+          </a>
+                       
+  
+
+  
+    
+  
+  
+        </div>
+    </div>
+    <div id="bodyColumn">
+      <div id="contentBox">
+        <html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta name="generator" content="HTML Tidy for Windows (vers 14 June 2007), see www.w3.org"></meta>
+
+</head>
+<frameset cols="260,*" border="1" frameborder="yes" framespacing="0" margin="0">
+<frame name="leftFrame" src="toc.html" noresize="noresize" scrolling="yes"></frame>
+<frame name="mainFrame" src="contents.html"></frame>
+<noframes>
+
+
+</noframes>
+</frameset>
+</html>
+      </div>
+    </div>
+    <div class="clear">
+      <hr/>
+    </div>
+    <div id="footer">
+      <div class="xright">&#169;  
+          2004-2007
+    
+          Apache Software Foundation
+          
+  
+
+  
+    
+  
+  
+  </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+  </body>
+</html>

Added: webservices/axis2/site/1_3/installationguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_3/installationguide.html?view=auto&rev=565295
==============================================================================
--- webservices/axis2/site/1_3/installationguide.html (added)
+++ webservices/axis2/site/1_3/installationguide.html Mon Aug 13 03:13:18 2007
@@ -0,0 +1,677 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+<html>
+  <head>
+    <title>Apache Axis2 - </title>
+    <style type="text/css" media="all">
+      @import url("../css/maven-base.css");
+      @import url("../css/maven-theme.css");
+      @import url("../css/site.css");
+    </style>
+    <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+      </head>
+  <body class="composite">
+    <div id="banner">
+                  <a href="../" id="bannerLeft">
+    
+                                    <img src="http://www.apache.org/images/asf_logo_wide.png" alt="" />
+    
+            </a>
+                          <span id="bannerRight">
+    
+                                    <img src="http://ws.apache.org/axis2/images/axis.jpg" alt="" />
+    
+            </span>
+            <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="breadcrumbs">
+          
+  
+
+  
+    
+  
+  
+            <div class="xleft">
+        Last Published: 08/13/2007
+                      </div>
+            <div class="xright">      <a href="../index.html">Axis2/Java</a>
+          |
+          <a href="http://ws.apache.org/axis2/c">Axis2/C</a>
+          |
+          <a href="../../../">Apache WS</a>
+          |
+          <a href="http://www.apache.org">Apache</a>
+          
+  
+
+  
+    
+  
+  
+  </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="leftColumn">
+      <div id="navcolumn">
+           
+  
+
+  
+    
+  
+  
+                   <h5>Axis2/Java</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../index.html">Home</a>
+        </li>
+          </ul>
+          <h5>Downloads</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../download.cgi">Releases</a>
+        </li>
+              
+    <li class="none">
+              <a href="../modules/index.html">Modules</a>
+        </li>
+              
+    <li class="none">
+              <a href="../tools/index.html">Tools</a>
+        </li>
+          </ul>
+          <h5>Documentation</h5>
+        <ul>
+              
+          
+              
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+              
+        <li class="expanded">
+              <a href="../1_3/contents.html">Version 1.3</a>
+                <ul>
+                  
+    <li class="none">
+              <a href="../1_3/toc.html">Table of Contents</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/installationguide.html">Installation Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/quickstartguide.html">QuickStart Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/userguide.html">User Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/pojoguide.html">POJO Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/spring.html">Spring Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/webadminguide.html">Web Administrator's Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../1_3/migration.html">Migration Guide (from Axis1)</a>
+        </li>
+              </ul>
+        </li>
+              
+    <li class="none">
+              <a href="../1_2/contents.html">Version 1.2</a>
+        </li>
+              
+    <li class="none">
+              <a href="../1_1_1/contents.html">Version 1.1.1</a>
+        </li>
+              
+    <li class="none">
+              <a href="../1_1/contents.html">Version 1.1</a>
+        </li>
+              
+    <li class="none">
+              <a href="../1_0/index.html">Version 1.0</a>
+        </li>
+              
+    <li class="none">
+              <a href="../0_95/index.html">Version 0.95</a>
+        </li>
+              
+    <li class="none">
+              <a href="../0_94/index.html">Version 0.94</a>
+        </li>
+              
+    <li class="none">
+              <a href="../0_93/index.html">Version 0.93</a>
+        </li>
+          </ul>
+          <h5>Resources</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../faq.html">FAQ</a>
+        </li>
+              
+    <li class="none">
+              <a href="../articles.html">Articles</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://wiki.apache.org/ws/FrontPage/Axis2/">Wiki</a>
+        </li>
+              
+    <li class="none">
+              <a href="../refLib.html">Reference Library</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://ws.apache.org/axis2/1_3/api/index.html">Online Java Docs</a>
+        </li>
+          </ul>
+          <h5>Get Involved</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../overview.html">Overview</a>
+        </li>
+              
+    <li class="none">
+              <a href="../svn.html">Checkout the Source</a>
+        </li>
+              
+    <li class="none">
+              <a href="../mail-lists.html">Mailing Lists</a>
+        </li>
+              
+    <li class="none">
+              <a href="../release-process.html">Release Process</a>
+        </li>
+              
+    <li class="none">
+              <a href="../guidelines.html">Developer Guidelines</a>
+        </li>
+              
+    <li class="none">
+              <a href="../siteHowTo.html">Build the Site</a>
+        </li>
+          </ul>
+          <h5>Project Information</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../team-list.html">Project Team</a>
+        </li>
+              
+    <li class="none">
+              <a href="../issue-tracking.html">Issue Tracking</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN">Source Code</a>
+        </li>
+              
+    <li class="none">
+              <a href="../thanks.html">Acknowledgements</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a>
+        </li>
+          </ul>
+                                       <a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy">
+            <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img>
+          </a>
+                       
+  
+
+  
+    
+  
+  
+        </div>
+    </div>
+    <div id="bodyColumn">
+      <div id="contentBox">
+        <html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta name="generator" content="HTML Tidy for Windows (vers 14 June 2007), see www.w3.org"></meta>
+<meta http-equiv="content-type" content=""></meta>
+Axis2 Installation Guide
+<link href="../css/axis-docs.css" rel="stylesheet" type="text/css" media="all"></link>
+</head>
+
+<h1 align="center">Apache Axis2 Installation Guide</h1>
+<p>This document provides information on Axis2 distribution
+packages, system prerequisites and setting up environment variables
+and tools followed by detailed instructions on installation
+methods.</p>
+<p><i>Send your feedback to: <a href="mailto:axis-dev@ws.apache.org?subject=[Axis2]">axis-dev@ws.apache.org</a></i>
+mailing list. (Subscription details are available on <a href="http://ws.apache.org/axis2/mail-lists.html">Axis2 site</a>.)
+Kindly prefix every email subject with [Axis2].</p>
+<h2>Contents</h2>
+<ul>
+<li><a href="#Download_Axis2">Axis2 Distributions</a></li>
+<li><a href="#requirements">System Requirements</a></li>
+<li><a href="#standalone">Installing Axis2 as a Standalone Server
+using the Standard Binary Distribution</a>
+<ul>
+<li><a href="#standalone1">Installing the Apache Axis2 Binary
+Distribution</a></li>
+<li><a href="#standalone2">Starting up Axis2 Standalone
+Server</a></li>
+<li><a href="#standalone3">Building the Axis2 WAR File Using the
+Standard Binary Distribution</a></li>
+<li><a href="#standalone4">Getting Familiar with Convenient Axis2
+Scripts</a></li>
+</ul>
+</li>
+<li><a href="#servlet_container">Installing Axis2 in a Servlet
+Container</a></li>
+<li><a href="#upload">Uploading Services</a></li>
+<li><a href="#advanced">Advanced</a>
+<ul>
+<li><a href="#source">Axis2 Source Distribution</a>
+<ul>
+<li><a href="#_Toc96698083">Setting up the Environment and
+Tools</a></li>
+<li><a href="#_Toc96698085">Building Axis2 Binaries and the WAR
+file Using the Source Distribution</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+<a name="Download_Axis2"></a>
+<h2>Axis2 Distributions</h2>
+Axis2 is distributed in several convenient distribution packages
+and can be installed either as a standalone server or as part of a
+J2EE compliant servlet container. Axis2 is distributed under the
+Apache License, version 2.0. This Installation Guide will mainly
+focus on running Apache Axis2 using the Standard Binary
+Distribution.
+<a href="http://ws.apache.org/axis2/download/1_3/download.cgi">
+Download</a> distribution packages of the Apache Axis2
+1.3 version (latest).
+<a href="http://ws.apache.org/axis2/download.cgi">Download</a>
+distribution packages of all versions of Apache Axis2.
+The distribution packages provided are as follows:
+<a name="std-bin"></a>
+<h3>1. Standard Binary Distribution</h3>
+This is the complete version of Axis2 and includes samples and
+convenient scripts as well.
+<a href="http://ws.apache.org/axis2/download/1_3/download.cgi">
+Download</a> Standard Binary Distribution
+<a name="war1"></a>
+<h3>2. WAR (Web Archive) Distribution</h3>
+This is the Web application of Axis2, which can be deployed in
+most of the servlet containers.
+<a href="http://ws.apache.org/axis2/download/1_3/download.cgi">
+Download</a> WAR (Web Archive) Distribution
+<h3>3. Documents Distribution</h3>
+This contains all the documentation in one package. The package
+includes the xdocs and the Java API docs of this project.
+<a href="http://ws.apache.org/axis2/download/1_3/download.cgi">
+Download</a> Documents Distribution
+<h3>4. Source Distribution</h3>
+This contains the sources of Axis2 standard distribution, and is
+mainly for the benefit of advanced users. One can generate a binary
+distribution using the source by typing <span class="style1">$mvn
+-Drelease install.</span> You need to set up the Axis2 environment before
+running this command. Step by step details on how to create the
+binary distribution is available in the <a href="#advanced">Advanced</a> section.
+<a href="http://ws.apache.org/axis2/download/1_3/download.cgi">
+Download</a> Source Distribution
+<a name="requirements"></a>
+<h2>System Requirements</h2>
+<table class="bodyTable">
+<tbody>
+<tr class="a">
+<td>Java Development Kit (JDK)</td>
+<td>1.4 or later (For instructions on setting up the JDK in
+different operating systems, visit <a href="http://java.sun.com/">http://java.sun.com</a>)</td>
+</tr>
+<tr class="b">
+<td>Disk</td>
+<td>Approximately 11 MB separately for standard binary
+distribution</td>
+</tr>
+<tr class="a">
+<td>Operating system</td>
+<td>Tested on Windows XP, Linux, Mac OS X, Fedora core, Ubuntu,
+Gentoo</td>
+</tr>
+<tr class="b">
+<td><strong>Build Tool</strong>-<a href="http://ant.apache.org/">Apache Ant</a>
+To run samples and to build WAR files from Axis2 binary
+distribution.
+</td>
+<td>Version 1.6.5 or higher (<a href="http://ant.apache.org/bindownload.cgi">download</a>).</td>
+</tr>
+<tr class="a">
+<td><strong>Build Tool</strong>- <a href="http://maven.apache.org/">Apache Maven 2.x</a>
+<p>Required <em>only</em> for building Axis2 from Source
+Distribution</p>
+</td>
+<td>2.0.7 or higher in Maven 2.x series (<a href="http://maven.apache.org/download.html">download</a>).
+<strong>Please download Maven 2.x version. Axis2 does not support
+Maven 1.x anymore.</strong></td>
+</tr>
+</tbody>
+</table>
+<p>Make sure that the above prerequisites are available for the
+Axis2 installation.</p>
+<a name="standalone"></a>
+<h2>Installing Axis2 as a Standalone Server using the Standard
+Binary Distribution</h2>
+<a name="standalone1"></a>
+<p>This section provides you with the following information</p>
+<ol type="1">
+<li>Install Axis2 as a standalone server using the Standard Binary
+Distribution</li>
+<li>Start up the Axis2 standalone server</li>
+<li>Building the axis2.war file (using the Standard Binary
+Distribution) which is required to run Axis2 as part of a J2EE
+compliant servlet container</li>
+<li>Running Axis2 convenient scripts</li>
+</ol>
+<h3>1. Download and Install the Apache Axis2 Binary
+Distribution</h3>
+<a href="http://java.sun.com/j2se/">Download</a> and install a
+Java Development Kit (JDK) release (version 1.4 or later). Install
+the JDK according to the instructions included with the release.
+Set an environment variable JAVA_HOME to the pathname of the
+directory into which you installed the JDK release.
+Download and unpack the <a href="http://ws.apache.org/axis2/download/1_3/download.cgi">
+Axis2 Standard Binary Distribution</a> into a convenient location
+so that the distribution resides in its own directory. Set an
+environment variable AXIS2_HOME to the pathname of the extracted
+directory of Axis2 (Eg: /opt/axis2-1.3). Linux users
+can alternatively run the setenv.sh file available in the
+AXIS2_HOME/bin directory to set the AXIS2_HOME environment variable
+to the Axis2 classpath.
+<h3>2. Starting up Axis2 Standalone Server</h3>
+The standalone Axis2 server can be started by executing the
+following commands:<br></br>
+$AXIS2_HOME\bin\axis2server.bat (Windows)<br></br>
+$AXIS2_HOME/bin/axis2server.sh (Unix)
+After startup, the default web services included with Axis2 will
+be available by visiting http://localhost:8080/axis2/services/
+<a name="standalone3"></a>
+<h3>3. Building the Axis2 Web Application (axis2.war) Using
+Standard Binary Distribution</h3>
+<p><a href="http://ant.apache.org/bindownload.cgi">Download</a> and
+install Apache Ant (version 1.6.5 or later). Install Apache Ant
+according to the instructions included with the Ant release.</p>
+<p>Locate the Ant build file (build.xml) inside the webapp
+directory, which resides in your Axis2 home directory (i.e:-
+$AXIS_HOME/webapp)&quot;. Run the Ant build by executing &quot;ant
+create.war&quot; inside the $AXIS2_HOME/webapps folder. You can find the
+generated axis2.war inside the $AXIS2_HOME/dist directory. All the
+services and modules that are present in the AXIS2_HOME/repository
+will be packed into the created axis2.war together with the Axis2
+configuration found at $AXIS2_HOME/conf/axis2.xml.</p>
+<p>Read <a href="#servlet_container">Installing Axis2 in a Servlet
+Container</a> to find out how to deploy the Axis2 Web application
+in a servlet container.</p>
+<a name="standalone4"></a>
+<h3>4. Getting Familiar with the Convenient Axis2 Scripts</h3>
+<p>It is advised to add the $AXIS2_HOME/bin to the PATH, so that
+you'll be able to run the following scripts from anywhere.</p>
+<table class="bodyTable">
+<tbody>
+<tr class="b">
+<td><b>Script Name</b></td>
+<td><b>Description</b></td>
+</tr>
+<tr class="a">
+<td>axis2.{bat|sh}</td>
+<td>You can use this script to run web service clients written
+using Axis2. This script calls the &quot;java&quot; command after adding the
+classpath for Axis2 dependent libraries (*.jar files present in
+your AXIS2_HOME/lib), setting the Axis2 repository location
+(AXIS2_HOME/repository) and setting the Axis2 configuration file
+location(AXIS2_HOME/conf/axis2.xml) for you. With this you can be
+relieved from setting all the above Axis2 specific
+parameters.<br></br>
+<p><em>Usage : axis2.{sh.bat} [-options] class [args...]</em></p>
+</td>
+</tr>
+<tr class="b">
+<td>axis2server.{sh|bat}</td>
+<td>This script will start a standalone Axis2 server using the
+AXIS2_HOME/repository as the Axis2 repository and the
+AXIS2_HOME/conf/axis2.xml as the Axis2 configuration file. This
+will start all the transport listeners listed in the
+AXIS2_HOME/conf/axis2.xml.
+<p>For example, if you want to deploy a service using a standalone
+Axis2 server,then copy your service archive to the
+AXIS2_HOME/repository/services directory. Next, go to the
+&quot;Transport Ins&quot; section of the AXIS2_HOME/conf/axis2.xml and
+configure the transport receivers (simpleHttpServer in port 8080 is
+listed by default). Then invoke this script.</p>
+</td>
+</tr>
+<tr class="a">
+<td>wsdl2java.{bat|sh}</td>
+<td>This script generates Java code according to a given WSDL file
+to handle Web service invocations (client-side stubs). This script
+also has the ability to generate web service skeletons according to
+the given WSDL.<br></br>
+<p><em>Usage: wsdl2java.{sh|bat} [OPTION]... -uri &lt;Location of
+WSDL&gt;</em></p>
+<p>e.g., wsdl2java.sh -uri ../wsdl/Axis2Sample.wsdl</p>
+<p>A more detailed reference about this script can be found
+<a href="reference.html">here</a></p>
+</td>
+</tr>
+<tr class="b">
+<td>java2wsdl.{bat|sh}</td>
+<td>This script generates the appropriate WSDL file for a given
+Java class.<br></br>
+<p><em>Usage: Java2WSDL.{sh|bat} [OPTION]... -cn &lt;fully
+qualified class name&gt;</em></p>
+<p>e.g., Java2WSDL.sh -cn ../samples/test/searchTool.Search</p>
+<p>A more detailed reference about this script can be found
+<a href="reference.html">here</a></p>
+</td>
+</tr>
+</tbody>
+</table>
+<a name="servlet_container"></a>
+<h2>Installing Axis2 in a Servlet Container</h2>
+<p>Whichever the distribution, installing Axis2 in a J2EE compliant
+servlet container is as follows:</p>
+<ol type="1">
+<li>Build the Axis2 WAR file using the Axis2 <a href="#standalone3">Standard Binary Distribution</a>. (Alternatively you
+can <a href="http://ws.apache.org/axis2/download/1_3/download.cgi">
+download</a> the axis2.war file or you can build axis2.war using
+the <a href="#war">Source Distribution</a>.</li>
+<li>Drop the WAR file in the webapps folder of the servlet
+container. Most servlet containers will automatically install the
+WAR file. (Some servlet containers may require a restart in order
+to capture the new web application. Refer to your servlet container
+documentation for more information.)
+<strong><img src="images/clip_image006.jpg" alt=""></img></strong>
+</li>
+<li>Once the WAR is successfully installed, test it by pointing the
+web browser to the <strong>http://&lt;host
+:port&gt;/axis2.</strong> It should produce the following page
+which is the <strong>Axis2 Web Application Home Page</strong>.</li>
+<li>Use the link &quot;Validate&quot; to ensure that everything is running
+correctly. If the validation fails then the WAR has failed to
+install properly or some essential jars are missing. In such a
+situation, refer to the documentation of the particular servlet
+container to find the problem. The following page shows a
+successful validation. Note the statement that indicates the core
+Axis2 libraries are present.</li>
+</ol>
+<img src="images/happyaxis.jpg"></img>
+<a name="upload"></a>
+<strong>Note:</strong> For any Application server specific
+installation information please refer to the <a href="app_server.html">Application Server Specific Configuration
+Guide</a>.
+<h2>Uploading Services</h2>
+<div style="margin-left: 2em">
+The Axis2 Web application also provides an interface to upload
+services. Once a service archive file is created according to the
+service specification as described in the <a name="adv-userguide.html">Advanced User's Guide</a>, that .aar file can
+be uploaded using the upload page.
+<p><strong><img src="images/clip_image010.jpg" alt=""></img></strong></p>
+<p>The uploaded .aar files will be stored in the default service
+directory. For Axis2, this will be the
+&lt;webapps&gt;/axis2/WEB-INF/services directory. Once a service is
+uploaded, it will be installed instantly.</p>
+<a name="hot_deployment"></a>
+<p>Since Axis2 supports <strong>hot deployment</strong>, you can
+drop the service archive directly through the file system to the
+above mentioned services directory. It will also cause the service
+to be automatically installed without the container being
+restarted.</p>
+<p>Use the 'Services' link on the Web Application home page to
+check the successful installation of a service. The services and
+the operations of successfully installed services will be displayed
+on the available services page.</p>
+<p><img src="images/clip_image012.jpg" alt=""></img></p>
+<p>If the service has deployment time errors it will list those
+services as faulty services. If you click on the link, you will see
+the deployment fault error messages.</p>
+<p><img src="images/faultservice.jpg" alt=""></img></p>
+<p>Deployment time error message</p>
+<p><strong><img src="images/faultmsg.jpg" alt=""></img></strong></p>
+<p>Axis2 Administration is all about configuring Axis2 at the run
+time and the configuration will be transient. More descriptions are
+available in the <a href="webadminguide.html">Axis2
+Web Administration Guide</a></p>
+</div>
+<a name="advanced"></a>
+<h2>Advanced</h2>
+<a name="source"></a>
+<h2>Axis2 Source Distribution</h2>
+<a name="_Toc96698083"></a> By using the Source Distribution, both
+binary files (which can be downloaded as the <a href="#std-bin">Standard Binary Distribution</a>) and the axis2.war file
+(which can be downloaded as the <a href="#war1">WAR
+distribution</a>) can be built using Maven commands.
+<p>Required jar files do not come with the distribution and they
+will also have to be built by running the maven command. Before we
+go any further, it is necessary to install <a href="http://maven.apache.org/">Maven2</a> and
+set up its environment, as explained below.</p>
+<a name="env-src"></a>
+<h3>Setting Up the Environment and Tools</h3>
+<a name="maven"></a>
+<h4>Maven</h4>
+<p>The Axis2 build is based on <a href="http://maven.apache.org/">Maven2</a> .
+Hence the only prerequisite to build Axis2 from the source
+distribution is to have Maven installed. Extensive instruction
+guides are available at the Maven site. This guide however contains
+the easiest path for quick environment setting. Advanced users who
+wish to know more about Maven can visit <a href="http://maven.apache.org/users/index.html">this site.</a></p>
+<ul>
+<li>MS Windows</li>
+</ul>
+<ol type="1">
+<li>Download and run the Windows installer package for Maven.</li>
+<li>Set the 'Environment Variables' ( create system variable
+MAVEN_HOME and edit path. eg: &quot;C:\Program Files\Apache Software
+Foundation\maven-2.0.7&quot;; path %MAVEN_HOME%\bin)</li>
+<li>Make sure that the system variable JAVA_HOME is set to the
+location of your JDK, eg. C:\Program Files\Java\jdk1.5.0_11</li>
+<li>Run mvn -v or mvn -version to verify that it is correctly
+ installed.</li>
+</ol>
+<img alt="clip_image002 (15K)" src="images/clip_image002.jpg"></img>
+<ul>
+<li>Unix based OS (Linux etc)</li>
+</ul>
+The tar ball or the zip archive is the best option. Once the
+archive is downloaded expand it to a directory of choice and set
+the environment variable MAVEN_HOME and add MAVEN_HOME/bin to the
+path as well. <a href="http://maven.apache.org/download.html">More
+instructions</a> for installing Maven in Unix based operating
+systems.
+Once Maven is properly installed, you can start building
+Axis2.
+<a href="../faq.html#d4">Maven commands that are frequently
+used</a> in Axis2 are listed on the <a href="../faq.html">FAQs</a>
+page.
+<a name="_Toc96698085"></a>
+<h3>Building Binaries and the WAR File Using the Source
+Distribution</h3>
+The Source Distribution is available as a zipped archive. All
+the necessary build scripts are included with the source
+distribution. Once the source archive is expanded into a directory
+of choice, moving to the particular directory and running
+<code>mvn install</code> command will build the Axis2 jar file.
+Once the command completes, the binaries (jar files in this
+case) can be found at a newly created &quot;target&quot; directory.
+<p><strong>Note: For the first Maven build (if the maven repository
+is not built first) it will take a while since the required jars
+need to be downloaded. However, this is a once only process and
+will not affect any successive builds.</strong></p>
+<a name="war"></a>
+<p>The default maven build will generate the war under modules/webapp/target directory</p>
+<a name="_Toc96698086"></a>
+
+</html>
+      </div>
+    </div>
+    <div class="clear">
+      <hr/>
+    </div>
+    <div id="footer">
+      <div class="xright">&#169;  
+          2004-2007
+    
+          Apache Software Foundation
+          
+  
+
+  
+    
+  
+  
+  </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+  </body>
+</html>

Added: webservices/axis2/site/1_3/jibx/jibx-codegen-integration.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_3/jibx/jibx-codegen-integration.html?view=auto&rev=565295
==============================================================================
--- webservices/axis2/site/1_3/jibx/jibx-codegen-integration.html (added)
+++ webservices/axis2/site/1_3/jibx/jibx-codegen-integration.html Mon Aug 13 03:13:18 2007
@@ -0,0 +1,485 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+<html>
+  <head>
+    <title>Apache Axis2 - </title>
+    <style type="text/css" media="all">
+      @import url("../../css/maven-base.css");
+      @import url("../../css/maven-theme.css");
+      @import url("../../css/site.css");
+    </style>
+    <link rel="stylesheet" href="../../css/print.css" type="text/css" media="print" />
+        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+      </head>
+  <body class="composite">
+    <div id="banner">
+                  <a href="../" id="bannerLeft">
+    
+                                    <img src="http://www.apache.org/images/asf_logo_wide.png" alt="" />
+    
+            </a>
+                          <span id="bannerRight">
+    
+                                    <img src="http://ws.apache.org/axis2/images/axis.jpg" alt="" />
+    
+            </span>
+            <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="breadcrumbs">
+          
+  
+
+  
+    
+  
+  
+            <div class="xleft">
+        Last Published: 08/13/2007
+                      </div>
+            <div class="xright">      <a href="../../index.html">Axis2/Java</a>
+          |
+          <a href="http://ws.apache.org/axis2/c">Axis2/C</a>
+          |
+          <a href="../../../../">Apache WS</a>
+          |
+          <a href="http://www.apache.org">Apache</a>
+          
+  
+
+  
+    
+  
+  
+  </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="leftColumn">
+      <div id="navcolumn">
+           
+  
+
+  
+    
+  
+  
+                   <h5>Axis2/Java</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../index.html">Home</a>
+        </li>
+          </ul>
+          <h5>Downloads</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../download.cgi">Releases</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../modules/index.html">Modules</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../tools/index.html">Tools</a>
+        </li>
+          </ul>
+          <h5>Documentation</h5>
+        <ul>
+              
+          
+              
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+            
+      
+              
+        <li class="expanded">
+              <a href="../../1_3/contents.html">Version 1.3</a>
+                <ul>
+                  
+    <li class="none">
+              <a href="../../1_3/toc.html">Table of Contents</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../../1_3/installationguide.html">Installation Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../../1_3/quickstartguide.html">QuickStart Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../../1_3/userguide.html">User Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../../1_3/pojoguide.html">POJO Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../../1_3/spring.html">Spring Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../../1_3/webadminguide.html">Web Administrator's Guide</a>
+        </li>
+                  
+    <li class="none">
+              <a href="../../1_3/migration.html">Migration Guide (from Axis1)</a>
+        </li>
+              </ul>
+        </li>
+              
+    <li class="none">
+              <a href="../../1_2/contents.html">Version 1.2</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../1_1_1/contents.html">Version 1.1.1</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../1_1/contents.html">Version 1.1</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../1_0/index.html">Version 1.0</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../0_95/index.html">Version 0.95</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../0_94/index.html">Version 0.94</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../0_93/index.html">Version 0.93</a>
+        </li>
+          </ul>
+          <h5>Resources</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../faq.html">FAQ</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../articles.html">Articles</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://wiki.apache.org/ws/FrontPage/Axis2/">Wiki</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../refLib.html">Reference Library</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://ws.apache.org/axis2/1_3/api/index.html">Online Java Docs</a>
+        </li>
+          </ul>
+          <h5>Get Involved</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../overview.html">Overview</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../svn.html">Checkout the Source</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../mail-lists.html">Mailing Lists</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../release-process.html">Release Process</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../guidelines.html">Developer Guidelines</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../siteHowTo.html">Build the Site</a>
+        </li>
+          </ul>
+          <h5>Project Information</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../team-list.html">Project Team</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../issue-tracking.html">Issue Tracking</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN">Source Code</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../thanks.html">Acknowledgements</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a>
+        </li>
+          </ul>
+                                       <a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy">
+            <img alt="Built by Maven" src="../../images/logos/maven-feather.png"></img>
+          </a>
+                       
+  
+
+  
+    
+  
+  
+        </div>
+    </div>
+    <div id="bodyColumn">
+      <div id="contentBox">
+        <html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta name="generator" content="HTML Tidy for Windows (vers 14 June 2007), see www.w3.org"></meta>
+<meta http-equiv="content-type" content=""></meta>
+JiBX Integration with Axis2
+<link href="../../css/axis-docs.css" rel="stylesheet" type="text/css" media="all"></link>
+</head>
+
+<h1>JiBX Integration With Axis2</h1>
+<p>This document describes using JiBX data binding with Axis2. JiBX
+differs from the other data binding techniques supported by Axis2
+in that it allows you to use your own Java data objects (as opposed
+to Java data objects generated from a schema definition). JiBX also
+provides a nicer form of unwrapped Web services interface than is
+supported by the other data binding techniques. On the downside,
+JiBX requires more setup than the other data binding techniques -
+in particular, you need to come up with a set of data classes and a
+binding definition in order to work with JiBX in Axis2.</p>
+<p>JiBX support for Axis2 and Web services in general is continuing
+to evolve. This page covers the basics of using JiBX with Axis2 as
+of the current release. Check the <a href="http://www.sosnoski.com/jibx-wiki/space/axis2-jibx">JiBX Axis2
+Wiki page</a> for updated information about using JiBX with
+Axis2.</p>
+<h2>Content</h2>
+<ul>
+<li><a href="#intro">Introduction</a></li>
+<li><a href="#wrapped">Wrapped vs. unwrapped</a></li>
+<li><a href="#java">Starting from Java</a></li>
+<li><a href="#wsdl">Starting from WSDL</a></li>
+<li><a href="#codegen">Axis2 JiBX Code Generation</a></li>
+<li><a href="#coming">Coming Attractions</a></li>
+</ul>
+<a name="intro"></a>
+<h2>Introduction</h2>
+<a href="http://www.jibx.org">JiBX data binding</a> supports
+fast and flexible conversions between plain old Java objects
+(POJOs) and XML. JiBX uses a mapped binding approach that's based
+on binding definition documents you provide. This approach let's
+you customize the way your Java objects are converted to and from
+XML. You can even define multiple bindings to use the same Java
+objects with different XML representations. These features make
+JiBX especially useful if you're developing a Web service based on
+existing Java code, or when you need to support multiple XML
+representations for a Web service (as when you're using versioned
+schema definitions).
+Axis2 supports using JiBX with your Web services, including
+generating the necessary linkage code for both client and server
+sides. However, the Axis2 support for JiBX does not currently
+include code generation from the schema for a Web service - you
+need to provide your own data classes and JiBX binding definition,
+and you also need to make sure that the binding definition matches
+the XML structures defined for your Web service. The JiBX project
+provides some basic tools to help with code generation from schema,
+binding generation from Java classes, and schema generation from
+the combination of Java classes and a binding definition. In the
+future, improved versions of these tools will be integrated
+directly into the Axis2 framework support, but for now you're on
+your own with this part of the setup.
+You can use JiBX data binding both to expose existing Java code
+as a service, and to build a client for an existing service. This
+document runs through the sequence of steps involved for each of
+these cases, just to help users understand the basic approach to
+working with JiBX in Axis2. You can find full instructions on the
+standard JiBX parts of this sequence on the <a href="http://www.jibx.org">JiBX Web site</a>.
+<a name="wrapped"></a>
+<h2>Wrapped vs. unwrapped</h2>
+Axis2 support for JiBX currently only works with the
+document-literal (doc/lit) form of Web services definitions.
+Doc/lit Web services generally use particular schema elements as
+input and output from each operation, and the Axis2 support for
+JiBX assumes this structure (which is also the structure required
+for compatibility with the <a href="http://www.ws-i.org/Profiles/BasicProfile-1.1.html">WS-I Basic
+Profile</a>).
+A popular subset of doc/lit Web services use a form called
+&quot;wrapped&quot;. Wrapped doc/lit Web services define service operations
+that correspond to method calls, using input and output element
+names based on the method name and embedding the actual parameter
+values for the method call within the input element.
+When used with Axis2, JiBX supports both general doc/lit and
+wrapped service definitions. Wrapped service definitions can be
+&quot;unwrapped&quot; during code generation to provide a greatly simplified
+interface. JiBX unwrapping of service definitions is not compatible
+with the unwrapping support for other data binding frameworks used
+with Axis2, but most users will find the JiBX approach easy and
+convenient. See the <a href="./jibx-unwrapped-example.html">JiBX
+Unwrapped Example</a> and the <a href="./jibx-doclit-example.html">JiBX Document/Literal Example</a>
+pages for a detailed comparison of the two forms of service
+interface.
+<a name="java"></a>
+<h2>Starting from Java</h2>
+<p>Here's the sequence of steps for using JiBX with Axis2 to expose
+existing Java code as a Web service:</p>
+<ol type="1">
+<li>Create a JiBX binding definition for the data being transferred
+by the Web service (you may be able to use the JiBX binding
+generator to help with this step).</li>
+<li>Create a schema that matches the XML defined by your binding
+(you may be able to use the JiBX schema generator to help with
+this). If you're using a wrapped form of interface to your service
+you'll also need to create schema definitions for the wrapper input
+and output elements used by each operation.</li>
+<li>Create a WSDL document for your service, with the schema
+embedded or imported.</li>
+<li>Generate Axis2 server-side linkage code using WSDL2Java with
+the WSDL and your binding definition.</li>
+<li>Run the JiBX binding compiler on your Java classes to add the
+actual binding code.</li>
+<li>Include the <i>axis2-jibx.jar</i> in your runtime classpath,
+along with the <i>jibx-runtime.jar</i>.</li>
+</ol>
+If you use a wrapped interface for your Web service you can
+expose method calls in your existing code directly as operations in
+the service. In this case you normally just use your existing data
+objects with JiBX data binding, and add schema definitions for the
+wrapper elements. See the <a href="./jibx-unwrapped-example.html">JiBX Unwrapped Example</a> page for
+more details on how this works.
+If you use a non-wrapped interface for your Web service you need
+to define classes to hold the data input and output from each
+operation. In this case these holder classes need to be included in
+the JiBX binding definition. See the <a href="./jibx-doclit-example.html">JiBX Document/Literal Example</a> page
+for more details on this case.
+<a name="wsdl"></a>
+<h2>Starting from WSDL</h2>
+Here's the sequence of steps for using JiBX with Axis2 to
+implement a client for an existing Web service (or the actual
+service, when you've been supplied with the WSDL your service is to
+implement):
+<ol type="1">
+<li>Create Java classes for the data being transferred by the Web
+service, and a JiBX binding definition that maps these classes to
+the schema defined by the Web service (you may be able to use the
+JiBX xsd2jibx tool to help with this).</li>
+<li>Generate Axis2 client linkage code using WSDL2Java with the
+WSDL and your binding definition.</li>
+<li>Run the JiBX binding compiler on your Java classes to add the
+actual binding code.</li>
+<li>Include the <i>axis2-jibx.jar</i> in your runtime classpath,
+along with the <i>jibx-runtime.jar</i></li>
+</ol>
+As with the starting from Java case, there are some differences
+in the handling depending on whether your service definition fits
+the wrapped form. See the <a href="./jibx-unwrapped-example.html">JiBX Unwrapped Example</a> and
+<a href="./jibx-doclit-example.html">JiBX Document/Literal
+Example</a> pages for more details.
+<a name="codegen"></a>
+<h2>WSDL2Java usage</h2>
+To run the WSDL2Java tool for JiBX data binding you need:
+<ol type="1">
+<li>To specify <i>-d jibx</i> to select JiBX binding.</li>
+<li>You also generally need an additional parameter,
+<i>-Ebindingfile {file}</i> (where <i>{file}</i> is the file path
+to your JiBX binding definition).</li>
+<li>Finally, you need to have the <i>axis2-jibx-XXXX.jar</i>, the
+<i>jibx-bind-XXXX.jar</i>, and the <i>jibx-run-XXXX.jar</i> files
+from your Axis2 distribution included in the WSDL2Java
+classpath.</li>
+</ol>
+If you want to use the unwrapped form of interface you also need
+to specify the <i>-uw</i> option to WSDL2Java. In this case your
+JiBX binding definition must include abstact mappings for all the
+complex objects which correspond to method parameters, and each
+abstract mapping must specify a <i>type-name</i> attribute that
+matches the schema <i>complexType</i> used in the WSDL. You can
+also use formats in the binding definition to define the handling
+of schema <i>simpleType</i>s. Schema types corresponding to Java
+primitives and simple objects with built-in JiBX conversions are
+handled automatically, and if all the parameter and return values
+in your wrapped WSDL are of these types you don't even need a JiBX
+binding definition. This is the one case where the <i>-Ebindingfile
+{file}</i> parameter is not needed.
+If you're not unwrapping the interface, you must use a JiBX
+binding definition and it must include a concrete mapping for each
+element used as input or output by any operation.
+<a name="coming"></a>
+<h2>Coming Attractions</h2>
+Work is in-progress on better tools to support generating Java
+classes and corresponding JiBX binding definitions from an input
+schema, and also for generating binding+schema generation from
+existing code. These features will be integrated into the Axis2
+JiBX support when they are available. Check the <a href="http://www.jibx.org">JiBX project site</a> for updates on JiBX,
+and the <a href="http://www.sosnoski.com/jibx-wiki/space/axis2-jibx">JiBX Axis2
+Wiki page</a> for updated information about using JiBX with
+Axis2.
+<h2>References</h2>
+<a href="http://jibx.sourceforge.net/tutorial/binding-tutorial.html">JiBX:
+Bindings Tutorial</a>
+
+</html>
+      </div>
+    </div>
+    <div class="clear">
+      <hr/>
+    </div>
+    <div id="footer">
+      <div class="xright">&#169;  
+          2004-2007
+    
+          Apache Software Foundation
+          
+  
+
+  
+    
+  
+  
+  </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+  </body>
+</html>



---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org


Mime
View raw message