You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by di...@apache.org on 2007/07/14 06:37:36 UTC
svn commit: r556222 [18/22] - in /webservices/axis2/trunk/java/xdocs: ./
@axis2_version_dir@/ @axis2_version_dir@/adb/ @axis2_version_dir@/jibx/
@axis2_version_dir@/src/ download/0_9/ download/0_91/ download/0_92/
download/0_93/ download/0_94/ download...
Copied: webservices/axis2/trunk/java/xdocs/faq.xml (from r556217, webservices/axis2/trunk/java/xdocs/faq.html)
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/faq.xml?view=diff&rev=556222&p1=webservices/axis2/trunk/java/xdocs/faq.html&r1=556217&p2=webservices/axis2/trunk/java/xdocs/faq.xml&r2=556222
==============================================================================
--- webservices/axis2/trunk/java/xdocs/faq.html (original)
+++ webservices/axis2/trunk/java/xdocs/faq.xml Fri Jul 13 21:37:26 2007
@@ -1,490 +1,483 @@
-<!--
- ~ Licensed to the Apache Software Foundation (ASF) under one
- ~ or more contributor license agreements. See the NOTICE file
- ~ distributed with this work for additional information
- ~ regarding copyright ownership. The ASF licenses this file
- ~ to you under the Apache License, Version 2.0 (the
- ~ "License"); you may not use this file except in compliance
- ~ with the License. You may obtain a copy of the License at
- ~
- ~ http://www.apache.org/licenses/LICENSE-2.0
- ~
- ~ Unless required by applicable law or agreed to in writing,
- ~ software distributed under the License is distributed on an
- ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- ~ KIND, either express or implied. See the License for the
- ~ specific language governing permissions and limitations
- ~ under the License.
- -->
-<html>
-<head>
- <meta http-equiv="content-type" content="">
- <title>Axis2 FAQ</title>
- <link href="css/axis-docs.css" rel="stylesheet" type="text/css" media="all">
-</head>
-
-<body lang="en">
-<h1>Frequently Asked Questions on Apache Axis2</h1>
-
-<p>Got a question to be answered on Axis2? Then this document is just what
-the doctor ordered.</p>
-
-<h2>Ask your Questions Here</h2>
-
-<p>If you have any other doubts/issues, e-mail your questions to:</p>
-<ul>
- <li>Developers - :<a
- href="mailto:axis-dev@ws.apache.org">axis-dev@ws.apache.org</a></li>
- <li>Users - :<a
- href="mailto:axis-user@ws.apache.org">axis-user@ws.apache.org</a></li>
-</ul>
-
-<p>Prefix subject with [Axis2]. <a
-href="http://ws.apache.org/axis2/mail-lists.html">Subscribe</a> to our
-mailing lists.<a href="http://ws.apache.org/axis2/mail-lists.html"></a></p>
-
-<h2>Content of Questions and Answers</h2>
-<ul>
- <li>General
- <ul>
- <li><a href="#a1">I'm having a problem using Axis2. What should I
- do?</a></li>
- <!--li><a href="#a2">What is OMElement, What does it represent?</a></li-->
- <li><a href="#a3">Integration security tests fail with JDK 1.5</a></li>
- <li><a href="#a4">Axis2 is not working with Java 6</a></li>
- </ul>
- </li>
- <li>Class Loading Issues
- <ul>
- <li><a href="#b1">How do I access resources in my service /module
- archive file?</a></li>
- </ul>
- </li>
- <li>Client API
- <ul>
- <li><a href="#c1">I want to do Request Response Messaging, Where should
- I look?<br>
- </a></li>
- <li><a href="#c2">I want to do One Way Messaging, Where should I
- look?</a></li>
- <li><a href="#c3">Error: 'to do two Transport Channels the Addressing
- Modules must be engaged'</a></li>
- <li><a href="#c4">I have engaged addressing, and when I try to invoke a
- service I get an exception</a></li>
- <li><a href="#c5">What is Axis Repository?</a></li>
- </ul>
- </li>
- <li>Maven
- <ul>
- <li><a href="#d1">Error when trying to run maven on Axis2</a></li>
- <li><a href="#d2">I have problems building with maven 1.1</a></li>
- <li><a href="#d3">What versions of maven are supported?</a></li>
- <li><a href="#d4">What are the frequently used maven commands?</a></li>
- </ul>
- </li>
- <li>Services
- <ul>
- <li><a href="#e1">How do I have multiple services in one service
- archive?</a></li>
- </ul>
- </li>
- <li>Web Archive/ Server Side
- <ul>
- <li><a href="#f1">I see an internal server error page when I try to
- view the WSDL file.<br>
- </a></li>
- </ul>
- </li>
- <li>WSDL and Code Generation
- <ul>
- <li><a href="#g1">Given a WSDL 2.0 document with HTTP Binding to
- WSDL2Java, should it not be able to generate a client stub</a></li>
- </ul>
- </li>
-</ul>
-
-<h2>General</h2>
-<ol>
- <li><a name="a1"></a><strong>I'm having a problem using Axis2. What should
- I do?</strong><br>
-
- <p>First make sure you go through the user guide and this FAQ. If you are
- using a released version of Axis2, then there is a possibility that your
- problem has already being fixed in the latest code. <a
- href="http://ws.zones.apache.org/dist/axis2/nightly/">Download Axis2
- nightly builds</a> and test again.</p>
- <p>If the problem still persists, then try to search for your question in
- our <a
- href="http://marc.theaimsgroup.com/?l=axis-dev&r=1&w=2">developer</a>
- or <a
- href="http://marc.theaimsgroup.com/?l=axis-user&r=1&w=2">user</a>
- mailing archives as it might have already being answered.</p>
- <p>If your problem is not answered in the mailing list, now is the best
- time to post your question to the axis-user mailing list. If you think it
- is a bug, please fill a bug report in <a
- href="http://issues.apache.org/jira/browse/AXIS2">JIRA</a>. Please attach
- all the supportive information, like your wsdl, schema, clients,
- services, stacktraces, etc., to the JIRA issue you created, as it will
- help one of our contributors to re-create the problem. <b>PLEASE DO NOT
- ASK QUESTIONS USING JIRA; USE IT ONLY AS AN ISSUE TRACKER.</b></p>
- <p>If you are asking for an explanation of a feature in Axis2, there is a
- possibility that there is an article or FAQ written on it. Please search
- the web as there are lots of articles written and hosted by various
- sources on the web.</p>
- <p><b>Note</b> : When you ask questions in the mailing list, please
- remember that everyone working in our project are volunteers. No-one can
- be forced to fix your bugs (See <a
- href="http://www.apache.org/foundation/faq.html#what-is-apache-NOT-about">What
- is Apache not about?</a> ).</p>
- <p>Make sure you add enough information about your problem with
- stacktraces and any other supportive information. It will improve the
- chances of your question being answered. Prefixing your mail subject with
- prefixes like "URGENT" will not help you in any means. Yes we also accept
- all the blames about Axis2 in these mailing lists, as those will
- definitely help us to improve Axis2 :) .</p>
- </li>
- <li><a name="a3"></a><strong>Integration security tests fail with JDK
- 1.5</strong><br>
-
- <p>You have to add Bouncy Castle as a JCE provider. Add the following
- entry to java.security file of the appropriate JRE on your machine. This
- file is available in the lib\security\ directory within the JRE
- directory.</p>
- <p>security.provider.7=org.bouncycastle.jce.provider.BouncyCastleProvider</p>
- <p>security.provider.# will have to be decided depending on the existing
- entries in the java.security file</p>
- <p>NOTE: For Windows XP, the correct version can be found using 'java
- -version'. The correct file is JRE (typically c:\Program
- Files\Java\jre<version>\lib\security\java.security.</p>
- </li>
- <li><a name="a4"></a><strong>Axis2 is not working with Java 6</strong><br>
-
- <p>You have to copy the stax-api jar in the Axis2 distribution into your
- JRE's endorsed directory (see info on endorsed directory here -<a
- href="http://java.sun.com/j2se/1.4.2/docs/guide/standards/">
- http://java.sun.com/j2se/1.4.2/docs/guide/standards/</a>).</p>
- <p>This issue can also be resolved by copying the stax-api jar to
- Tomcat's common/endorsed folder, when deploying Axis2 in Tomcat.</p>
- </li>
-</ol>
-
-<h2>Class Loading Issues</h2>
-<ol>
- <li><a name="b1"></a><strong>How do I access resources that I put into my
- service /module archive file?</strong></li>
-
- <p>Axis2 has the notion of service isolation where each service or module
- gets its own class loader. Using this class loader you can access any
- resource that you put into your service archive file. You may want to
- access your resources from different locations. For example,</p>
-
- <p>1. A third party module wants to access your resources. Then the
- scenario is as follows:</p>
- <pre> AxisService myService =
- messageContext.getAxisConfiguration().getAxisService("serviceName"); </pre>
-
- <p>or</p>
- <pre> AxisService myService = msgCtx.getAxisService();</pre>
-
- <p>Then you can use the service class loader through which you can access
- its resources</p>
- <pre> ClassLoader clsLoader = myService.getServiceClassLoader();
- clsLoader.getResourceAsStream("myResource");</pre>
-
- <p>2. To initialize the service implementation class at the MessageReceiver
- level, the following steps need to be taken</p>
- <pre> AxisService service = msgCtx.getAxisService();
- ClassLoader clsLoader = service.getServiceClassLoader();
- Class.forName("serviceName",clsLoader,true);</pre>
-
- <p>NOTE : Axis2 default MessageReciver uses the same technique to
- initialize service implementations</p>
-
- <p>3. If you want to load your resources at the service implementation
- class, then the scenario is as follows</p>
- <pre> getClass().getClassLoader().getResourceAsStream("myResource");</pre>
-</ol>
-
-<h2>Client API</h2>
-<ol>
- <li><a name="c1"></a><strong>I want to do Request-Response Messaging, Where
- should I look?</strong><br>
-
- <p>Look at the <a
- href="https://svn.apache.org/repos/asf/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/ServiceClient.java"
- target="_blank">ServiceClient</a> class, for more information please read
- the <a href="@axis2_version_dir@/adv-userguide.html" target="_blank">User's Guide</a></p>
- </li>
- <li><a name="c2"></a><strong>I want to do One Way Messaging, Where should I
- look?</strong><br>
-
- <p>From Axis2 0.94 onwards, both request-response and one way messaging
- will be handled by <a
- href="https://svn.apache.org/repos/asf/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/ServiceClient.java"
- target="_blank">ServiceClient</a>.</p>
- </li>
- <li><a></a><strong>When I try to do a non blocking call with
- </strong>useSeparateListener=true
- <p>I get the error <i>to do two Transport Channels the Addressing Modules
- must be engaged</i>, Why is this?<br>
- </p>
- <p>To do the two transport channel invocation, you need to engage the
- addressing module. You can enable it by un-commenting the entry in the
- axis2.xml file or Call.engageModule(QName). However, addressing is
- enabled by default.</p>
- </li>
- <li><a name="c4"></a><strong>I have engaged addressing, and when I try to
- invoke a service I get an exception </strong><br>
-
- <p>If you have engaged addressing, then you must have wsa:action, the
- required WS-Addressing header. You have to call <br>
- <code>option.setAction("urn:myaction");</code>. Note that the action
- should be a URI.</p>
- </li>
- <li><a name="c5"></a><strong>What is Axis2 Repository?</strong><br>
-
- <p>The Repository stores the configuration of Axis2. The users should
- specify the repository folder of the Axis Server (HTTP or TCP). In the
- case of Tomcat, it is the webapps/axis2/WEB-INF folder. The following
- picture shows a sample repository.</p>
- <img src="images/faq/1.jpg">
- <p>Modules and services have an archive format defined and they are
- automatically picked up by Axis2 when they are copied to corresponding
- folders.</p>
- </li>
-</ol>
-
-<h2>Maven</h2>
-<ol>
- <li><a name="d1"></a><strong>I just installed Maven and it gives an error
- when I try to run Maven on Axis2.</strong>
- <p>Axis2 requires itest plugin to run some of the tests. Better get it
- using the following command.</p>
- <ul>
- <li>maven plugin:download -DgroupId=maven-itest-plugin
- -DartifactId=maven-itest-plugin -Dversion=1.0
- -Dmaven.repo.remote=http://ws.zones.apache.org/~dims/maven</li>
- </ul>
- </li>
- <li><p><a name="d2"></a><strong>I have problems building with Maven
- 1.1</strong></p>
- <p>It seems that Maven 1.1 doesn't come bundled with the required
- artifact plugin. Run the following command to get it updated<br>
- </p>
- <ul>
- <li>maven plugin:download -DgroupId=maven
- -DartifactId=maven-artifact-plugin -Dversion=1.6</li>
- <p>You may also need to update the itest plugin, using the above
- command in 1.</p>
- </ul>
- </li>
- <li><p><a name="d3"></a><strong>What versions of Maven are
- supported?</strong></p>
- <p>Versions 1.0.2 and 1.1 are supported. Maven2 is not supported as
- yet.</p>
- </li>
- <li><a name="d4"></a><strong>What are the frequently used Maven
- commands?</strong></li>
-
- <p></p>
-
- <table border="1" align="center">
- <tbody>
- <tr>
- <th scope="col">
- <div align="left">
- Command</div>
- </th>
- <th scope="col">
- <div align="left">
- Description</div>
- </th>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven</div>
- </td>
- <td>
- <div align="left">
- Downloads relevant jars if not available, and compiles and runs the
- tests in the system.</div>
- </td>
- </tr>
- <tr>
- <td>maven clean</td>
- <td>Cleans all the content built so far in the target folder. This
- will not clean the jar repository.</td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven test</div>
- </td>
- <td>
- <div align="left">
- Runs only the tests. Performs automatic compilation of changed
- sources as well. This will not run SOAP interop tests</div>
- </td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven clean all-tests</div>
- </td>
- <td>
- <div align="left">
- Cleans up and runs all offline and online tests.</div>
- </td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven itest</div>
- </td>
- <td>
- <div align="left">
- To run the online-mode tests for say the modules/integration, run
- "maven itest" from modules/integration</div>
- </td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven test itest</div>
- </td>
- <td>
- <div align="left">
- To run all the tests for say the modules/integration, run "maven
- test itest" from modules/integration</div>
- </td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven -g</div>
- </td>
- <td>
- <div align="left">
- Lists all the commands available in Maven</div>
- </td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven multiproject</div>
- </td>
- <td>
- <div align="left">
- Generates the site.</div>
- </td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven idea:multiproject</div>
- </td>
- <td>
- <div align="left">
- Generates IDEA .ipr, .iml and .iws project files.</div>
- </td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven -Dmaven.test.skip=true</div>
- </td>
- <td>Builds Axis2 and skips all the tests.</td>
- </tr>
- <tr>
- <td>maven dist-min-bin</td>
- <td>Generates the binary version of Axis2 minimal distribution</td>
- </tr>
- <tr>
- <td>maven dist-min-src</td>
- <td>Generates the source version of Axis2 minimal distribution</td>
- </tr>
- <tr>
- <td>maven dist-std-bin</td>
- <td>Generates the binary version of Axis2 standard distribution</td>
- </tr>
- <tr>
- <td>maven dist-std-src</td>
- <td>Generates the source version of Axis2 standard distribution</td>
- </tr>
- <tr>
- <td>maven release</td>
- <td>Generates all the distributables for Axis2.</td>
- </tr>
- <tr>
- <td>maven clean jar -Dmaven.test.skip=true -o</td>
- <td>Cleans the content in the target folder and compiles your source,
- without running the tests or downloading snapshots of the
- dependancies. This is the quickest way of compiling Axis2 sources.
- However it is highly recommended to run the tests all the time.</td>
- </tr>
- </tbody>
- </table>
- <br>
-</ol>
-
-<h2>Services</h2>
-<ol>
- <li><a name="e1"></a><strong>How do I have multiple services in one service
- archive?</strong></li>
-
- <p>It's just a matter of writing a services.xml file to configure the
- service or services in an archive file. The corresponding services.xml
- <strong>must</strong> look as follows,</p>
- <pre> <serviceGroup>
- <service <strong>name="myService1"</strong>>
- ...........................
- </service>
-
- <service <strong>name="myService2"</strong>>
- ...........................
- </service>
- <serviceGroup></pre>
-
- <p>NOTE : The name attribute is a compulsory attribute that will become the
- name of the services. If you want to have one service in the archive file,
- then there are two options. You can either have one service inside the
- serviceGroup tag or have only one service tag, as shown below, in your
- services.xml, in which case, the name of the service will be the name of
- the archive file, which you cannot override.</p>
- <pre> <service>
- ...............
- <service></pre>
-</ol>
-
-<h2>Web Archive / Server side</h2>
-<ol>
- <li><a name="f1"></a><strong>I see an internal server error page when I try
- to view the WSDL file.</strong><br>
-
- <p>This happens specifically with Tomcat 4.x and 5.0 in a JDK 1.5
- environment. The reason is that the system picks up a wrong transformer
- factory class. This can be solved simply by putting the <a
- href="http://www.apache.org/dist/java-repository/xalan/jars/">xalan-2.7.0.jar</a>
- into the axis2/WEB-INF/lib directory</p>
- </li>
-</ol>
-
-<h2>WSDL and Code Generation</h2>
-<ol>
- <li><a name="g1"></a><strong>Given a WSDL 2.0 document with HTTP Binding to
- WSDL2Java, should it not be able to generate a client stub similar to
- what happens given a WSDL 1.1 document with SOAP Binding?</strong></li>
-
- <p>WSDL 2.0 is not supported yet. We do not have a working WSDL 2.0
- reader.</p>
-
- <p>However the codegen engine works off WOM (not WSDL4J). Hence if the WSDL
- 2.0 reader is done, we are all set to generate code for it.</p>
-
- <p>And yes, it is perfectly possible for the codegen to generate code for
- the HTTP binding. We already have the client API support for making the
- REST calls and it should be a matter of putting in a correct template.</p>
-</ol>
-</body>
-</html>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one
+ ~ or more contributor license agreements. See the NOTICE file
+ ~ distributed with this work for additional information
+ ~ regarding copyright ownership. The ASF licenses this file
+ ~ to you under the Apache License, Version 2.0 (the
+ ~ "License"); you may not use this file except in compliance
+ ~ with the License. You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing,
+ ~ software distributed under the License is distributed on an
+ ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ ~ KIND, either express or implied. See the License for the
+ ~ specific language governing permissions and limitations
+ ~ under the License.
+ -->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<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 http-equiv="content-type" content="" />
+<title>Axis2 FAQ</title>
+<link href="css/axis-docs.css" rel="stylesheet" type="text/css"
+media="all" />
+</head>
+<body lang="en" xml:lang="en">
+<h1>Frequently Asked Questions on Apache Axis2</h1>
+<p>Got a question to be answered on Axis2? Then this document is
+just what the doctor ordered.</p>
+<h2>Ask your Questions Here</h2>
+<p>If you have any other doubts/issues, e-mail your questions
+to:</p>
+<ul>
+<li>Developers - :<a href=
+"mailto:axis-dev@ws.apache.org">axis-dev@ws.apache.org</a></li>
+<li>Users - :<a href=
+"mailto:axis-user@ws.apache.org">axis-user@ws.apache.org</a></li>
+</ul>
+<p>Prefix subject with [Axis2]. <a href=
+"http://ws.apache.org/axis2/mail-lists.html">Subscribe</a> to our
+mailing lists.<a href=
+"http://ws.apache.org/axis2/mail-lists.html"></a></p>
+<h2>Content of Questions and Answers</h2>
+<ul>
+<li>General
+<ul>
+<li><a href="#a1">I'm having a problem using Axis2. What should I
+do?</a></li>
+<!--li><a href="#a2">What is OMElement, What does it represent?</a></li-->
+<li><a href="#a3">Integration security tests fail with JDK
+1.5</a></li>
+<li><a href="#a4">Axis2 is not working with Java 6</a></li>
+</ul>
+</li>
+<li>Class Loading Issues
+<ul>
+<li><a href="#b1">How do I access resources in my service /module
+archive file?</a></li>
+</ul>
+</li>
+<li>Client API
+<ul>
+<li><a href="#c1">I want to do Request Response Messaging, Where
+should I look?<br /></a></li>
+<li><a href="#c2">I want to do One Way Messaging, Where should I
+look?</a></li>
+<li><a href="#c3">Error: 'to do two Transport Channels the
+Addressing Modules must be engaged'</a></li>
+<li><a href="#c4">I have engaged addressing, and when I try to
+invoke a service I get an exception</a></li>
+<li><a href="#c5">What is Axis Repository?</a></li>
+</ul>
+</li>
+<li>Maven
+<ul>
+<li><a href="#d1">Error when trying to run maven on Axis2</a></li>
+<li><a href="#d2">I have problems building with maven 1.1</a></li>
+<li><a href="#d3">What versions of maven are supported?</a></li>
+<li><a href="#d4">What are the frequently used maven
+commands?</a></li>
+</ul>
+</li>
+<li>Services
+<ul>
+<li><a href="#e1">How do I have multiple services in one service
+archive?</a></li>
+</ul>
+</li>
+<li>Web Archive/ Server Side
+<ul>
+<li><a href="#f1">I see an internal server error page when I try to
+view the WSDL file.<br /></a></li>
+</ul>
+</li>
+<li>WSDL and Code Generation
+<ul>
+<li><a href="#g1">Given a WSDL 2.0 document with HTTP Binding to
+WSDL2Java, should it not be able to generate a client stub</a></li>
+</ul>
+</li>
+</ul>
+<h2>General</h2>
+<ol>
+<li><a name="a1" id="a1"></a><strong>I'm having a problem using
+Axis2. What should I do?</strong><br />
+<p>First make sure you go through the user guide and this FAQ. If
+you are using a released version of Axis2, then there is a
+possibility that your problem has already being fixed in the latest
+code. <a href=
+"http://ws.zones.apache.org/dist/axis2/nightly/">Download Axis2
+nightly builds</a> and test again.</p>
+<p>If the problem still persists, then try to search for your
+question in our <a href=
+"http://marc.theaimsgroup.com/?l=axis-dev&r=1&w=2">developer</a>
+or <a href=
+"http://marc.theaimsgroup.com/?l=axis-user&r=1&w=2">user</a>
+mailing archives as it might have already being answered.</p>
+<p>If your problem is not answered in the mailing list, now is the
+best time to post your question to the axis-user mailing list. If
+you think it is a bug, please fill a bug report in <a href=
+"http://issues.apache.org/jira/browse/AXIS2">JIRA</a>. Please
+attach all the supportive information, like your wsdl, schema,
+clients, services, stacktraces, etc., to the JIRA issue you
+created, as it will help one of our contributors to re-create the
+problem. <b>PLEASE DO NOT ASK QUESTIONS USING JIRA; USE IT ONLY AS
+AN ISSUE TRACKER.</b></p>
+<p>If you are asking for an explanation of a feature in Axis2,
+there is a possibility that there is an article or FAQ written on
+it. Please search the web as there are lots of articles written and
+hosted by various sources on the web.</p>
+<p><b>Note</b> : When you ask questions in the mailing list, please
+remember that everyone working in our project are volunteers.
+No-one can be forced to fix your bugs (See <a href=
+"http://www.apache.org/foundation/faq.html#what-is-apache-NOT-about">
+What is Apache not about?</a> ).</p>
+<p>Make sure you add enough information about your problem with
+stacktraces and any other supportive information. It will improve
+the chances of your question being answered. Prefixing your mail
+subject with prefixes like "URGENT" will not help you in any means.
+Yes we also accept all the blames about Axis2 in these mailing
+lists, as those will definitely help us to improve Axis2 :) .</p>
+</li>
+<li><a name="a3" id="a3"></a><strong>Integration security tests
+fail with JDK 1.5</strong><br />
+<p>You have to add Bouncy Castle as a JCE provider. Add the
+following entry to java.security file of the appropriate JRE on
+your machine. This file is available in the lib\security\ directory
+within the JRE directory.</p>
+<p>
+security.provider.7=org.bouncycastle.jce.provider.BouncyCastleProvider</p>
+<p>security.provider.# will have to be decided depending on the
+existing entries in the java.security file</p>
+<p>NOTE: For Windows XP, the correct version can be found using
+'java -version'. The correct file is JRE (typically c:\Program
+Files\Java\jre<version>\lib\security\java.security.</p>
+</li>
+<li><a name="a4" id="a4"></a><strong>Axis2 is not working with Java
+6</strong><br />
+<p>You have to copy the stax-api jar in the Axis2 distribution into
+your JRE's endorsed directory (see info on endorsed directory here
+- <a href=
+"http://java.sun.com/j2se/1.4.2/docs/guide/standards/">http://java.sun.com/j2se/1.4.2/docs/guide/standards/</a>).</p>
+<p>This issue can also be resolved by copying the stax-api jar to
+Tomcat's common/endorsed folder, when deploying Axis2 in
+Tomcat.</p>
+</li>
+</ol>
+<h2>Class Loading Issues</h2>
+<ol>
+<li><a name="b1" id="b1"></a><strong>How do I access resources that
+I put into my service /module archive file?</strong></li>
+<li style="list-style: none; display: inline">
+<p>Axis2 has the notion of service isolation where each service or
+module gets its own class loader. Using this class loader you can
+access any resource that you put into your service archive file.
+You may want to access your resources from different locations. For
+example,</p>
+<p>1. A third party module wants to access your resources. Then the
+scenario is as follows:</p>
+<pre>
+ AxisService myService =
+ messageContext.getAxisConfiguration().getAxisService("serviceName");
+</pre>
+<p>or</p>
+<pre>
+ AxisService myService = msgCtx.getAxisService();
+</pre>
+<p>Then you can use the service class loader through which you can
+access its resources</p>
+<pre>
+ ClassLoader clsLoader = myService.getServiceClassLoader();
+ clsLoader.getResourceAsStream("myResource");
+</pre>
+<p>2. To initialize the service implementation class at the
+MessageReceiver level, the following steps need to be taken</p>
+<pre>
+ AxisService service = msgCtx.getAxisService();
+ ClassLoader clsLoader = service.getServiceClassLoader();
+ Class.forName("serviceName",clsLoader,true);
+</pre>
+<p>NOTE : Axis2 default MessageReciver uses the same technique to
+initialize service implementations</p>
+<p>3. If you want to load your resources at the service
+implementation class, then the scenario is as follows</p>
+<pre>
+ getClass().getClassLoader().getResourceAsStream("myResource");
+</pre></li>
+</ol>
+<h2>Client API</h2>
+<ol>
+<li><a name="c1" id="c1"></a><strong>I want to do Request-Response
+Messaging, Where should I look?</strong><br />
+<p>Look at the <a href=
+"https://svn.apache.org/repos/asf/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/ServiceClient.java"
+target="_blank">ServiceClient</a> class, for more information
+please read the <a href="@axis2_version_dir@/adv-userguide.html"
+target="_blank">User's Guide</a></p>
+</li>
+<li><a name="c2" id="c2"></a><strong>I want to do One Way
+Messaging, Where should I look?</strong><br />
+<p>From Axis2 0.94 onwards, both request-response and one way
+messaging will be handled by <a href=
+"https://svn.apache.org/repos/asf/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/ServiceClient.java"
+target="_blank">ServiceClient</a>.</p>
+</li>
+<li><strong>When I try to do a non blocking call with</strong>
+useSeparateListener=true
+<p>I get the error <i>to do two Transport Channels the Addressing
+Modules must be engaged</i>, Why is this?<br /></p>
+<p>To do the two transport channel invocation, you need to engage
+the addressing module. You can enable it by un-commenting the entry
+in the axis2.xml file or Call.engageModule(QName). However,
+addressing is enabled by default.</p>
+</li>
+<li><a name="c4" id="c4"></a><strong>I have engaged addressing, and
+when I try to invoke a service I get an exception</strong><br />
+<p>If you have engaged addressing, then you must have wsa:action,
+the required WS-Addressing header. You have to call<br />
+<code>option.setAction("urn:myaction");</code>. Note that the
+action should be a URI.</p>
+</li>
+<li><a name="c5" id="c5"></a><strong>What is Axis2
+Repository?</strong><br />
+<p>The Repository stores the configuration of Axis2. The users
+should specify the repository folder of the Axis Server (HTTP or
+TCP). In the case of Tomcat, it is the webapps/axis2/WEB-INF
+folder. The following picture shows a sample repository.</p>
+<img src="images/faq/1.jpg" />
+<p>Modules and services have an archive format defined and they are
+automatically picked up by Axis2 when they are copied to
+corresponding folders.</p>
+</li>
+</ol>
+<h2>Maven</h2>
+<ol>
+<li><a name="d1" id="d1"></a><strong>I just installed Maven and it
+gives an error when I try to run Maven on Axis2.</strong>
+<p>Axis2 requires itest plugin to run some of the tests. Better get
+it using the following command.</p>
+<ul>
+<li>maven plugin:download -DgroupId=maven-itest-plugin
+-DartifactId=maven-itest-plugin -Dversion=1.0
+-Dmaven.repo.remote=http://ws.zones.apache.org/~dims/maven</li>
+</ul>
+</li>
+<li>
+<p><a name="d2" id="d2"></a><strong>I have problems building with
+Maven 1.1</strong></p>
+<p>It seems that Maven 1.1 doesn't come bundled with the required
+artifact plugin. Run the following command to get it
+updated<br /></p>
+<ul>
+<li>maven plugin:download -DgroupId=maven
+-DartifactId=maven-artifact-plugin -Dversion=1.6</li>
+<li style="list-style: none; display: inline">
+<p>You may also need to update the itest plugin, using the above
+command in 1.</p>
+</li>
+</ul>
+</li>
+<li>
+<p><a name="d3" id="d3"></a><strong>What versions of Maven are
+supported?</strong></p>
+<p>Versions 1.0.2 and 1.1 are supported. Maven2 is not supported as
+yet.</p>
+<table border="1" align="center">
+<tbody>
+<tr>
+<th scope="col">
+<div align="left">Command</div>
+</th>
+<th scope="col">
+<div align="left">Description</div>
+</th>
+</tr>
+<tr>
+<td>
+<div align="left">maven</div>
+</td>
+<td>
+<div align="left">Downloads relevant jars if not available, and
+compiles and runs the tests in the system.</div>
+</td>
+</tr>
+<tr>
+<td>maven clean</td>
+<td>Cleans all the content built so far in the target folder. This
+will not clean the jar repository.</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven test</div>
+</td>
+<td>
+<div align="left">Runs only the tests. Performs automatic
+compilation of changed sources as well. This will not run SOAP
+interop tests</div>
+</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven clean all-tests</div>
+</td>
+<td>
+<div align="left">Cleans up and runs all offline and online
+tests.</div>
+</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven itest</div>
+</td>
+<td>
+<div align="left">To run the online-mode tests for say the
+modules/integration, run "maven itest" from
+modules/integration</div>
+</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven test itest</div>
+</td>
+<td>
+<div align="left">To run all the tests for say the
+modules/integration, run "maven test itest" from
+modules/integration</div>
+</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven -g</div>
+</td>
+<td>
+<div align="left">Lists all the commands available in Maven</div>
+</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven multiproject</div>
+</td>
+<td>
+<div align="left">Generates the site.</div>
+</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven idea:multiproject</div>
+</td>
+<td>
+<div align="left">Generates IDEA .ipr, .iml and .iws project
+files.</div>
+</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven -Dmaven.test.skip=true</div>
+</td>
+<td>Builds Axis2 and skips all the tests.</td>
+</tr>
+<tr>
+<td>maven dist-min-bin</td>
+<td>Generates the binary version of Axis2 minimal distribution</td>
+</tr>
+<tr>
+<td>maven dist-min-src</td>
+<td>Generates the source version of Axis2 minimal distribution</td>
+</tr>
+<tr>
+<td>maven dist-std-bin</td>
+<td>Generates the binary version of Axis2 standard
+distribution</td>
+</tr>
+<tr>
+<td>maven dist-std-src</td>
+<td>Generates the source version of Axis2 standard
+distribution</td>
+</tr>
+<tr>
+<td>maven release</td>
+<td>Generates all the distributables for Axis2.</td>
+</tr>
+<tr>
+<td>maven clean jar -Dmaven.test.skip=true -o</td>
+<td>Cleans the content in the target folder and compiles your
+source, without running the tests or downloading snapshots of the
+dependancies. This is the quickest way of compiling Axis2 sources.
+However it is highly recommended to run the tests all the
+time.</td>
+</tr>
+</tbody>
+</table>
+<br /></li>
+<li><a name="d4" id="d4"></a><strong>What are the frequently used
+Maven commands?</strong></li>
+</ol>
+<h2>Services</h2>
+<ol>
+<li><a name="e1" id="e1"></a><strong>How do I have multiple
+services in one service archive?</strong></li>
+<li style="list-style: none; display: inline">
+<p>It's just a matter of writing a services.xml file to configure
+the service or services in an archive file. The corresponding
+services.xml <strong>must</strong> look as follows,</p>
+<pre>
+ <serviceGroup>
+ <service <strong>name="myService1"</strong>>
+ ...........................
+ </service>
+
+ <service <strong>name="myService2"</strong>>
+ ...........................
+ </service>
+ <serviceGroup>
+</pre>
+<p>NOTE : The name attribute is a compulsory attribute that will
+become the name of the services. If you want to have one service in
+the archive file, then there are two options. You can either have
+one service inside the serviceGroup tag or have only one service
+tag, as shown below, in your services.xml, in which case, the name
+of the service will be the name of the archive file, which you
+cannot override.</p>
+<pre>
+ <service>
+ ...............
+ <service>
+</pre></li>
+</ol>
+<h2>Web Archive / Server side</h2>
+<ol>
+<li><a name="f1" id="f1"></a><strong>I see an internal server error
+page when I try to view the WSDL file.</strong><br />
+<p>This happens specifically with Tomcat 4.x and 5.0 in a JDK 1.5
+environment. The reason is that the system picks up a wrong
+transformer factory class. This can be solved simply by putting the
+<a href=
+"http://www.apache.org/dist/java-repository/xalan/jars/">xalan-2.7.0.jar</a>
+into the axis2/WEB-INF/lib directory</p>
+</li>
+</ol>
+<h2>WSDL and Code Generation</h2>
+<ol>
+<li><a name="g1" id="g1"></a><strong>Given a WSDL 2.0 document with
+HTTP Binding to WSDL2Java, should it not be able to generate a
+client stub similar to what happens given a WSDL 1.1 document with
+SOAP Binding?</strong></li>
+<li style="list-style: none; display: inline">
+<p>WSDL 2.0 is not supported yet. We do not have a working WSDL 2.0
+reader.</p>
+<p>However the codegen engine works off WOM (not WSDL4J). Hence if
+the WSDL 2.0 reader is done, we are all set to generate code for
+it.</p>
+<p>And yes, it is perfectly possible for the codegen to generate
+code for the HTTP binding. We already have the client API support
+for making the REST calls and it should be a matter of putting in a
+correct template.</p>
+</li>
+</ol>
+</body>
+</html>
Copied: webservices/axis2/trunk/java/xdocs/guidelines.xml (from r556217, webservices/axis2/trunk/java/xdocs/guidelines.html)
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/guidelines.xml?view=diff&rev=556222&p1=webservices/axis2/trunk/java/xdocs/guidelines.html&r1=556217&p2=webservices/axis2/trunk/java/xdocs/guidelines.xml&r2=556222
==============================================================================
--- webservices/axis2/trunk/java/xdocs/guidelines.html (original)
+++ webservices/axis2/trunk/java/xdocs/guidelines.xml Fri Jul 13 21:37:26 2007
@@ -1,93 +1,95 @@
-<!--
- ~ Licensed to the Apache Software Foundation (ASF) under one
- ~ or more contributor license agreements. See the NOTICE file
- ~ distributed with this work for additional information
- ~ regarding copyright ownership. The ASF licenses this file
- ~ to you under the Apache License, Version 2.0 (the
- ~ "License"); you may not use this file except in compliance
- ~ with the License. You may obtain a copy of the License at
- ~
- ~ http://www.apache.org/licenses/LICENSE-2.0
- ~
- ~ Unless required by applicable law or agreed to in writing,
- ~ software distributed under the License is distributed on an
- ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- ~ KIND, either express or implied. See the License for the
- ~ specific language governing permissions and limitations
- ~ under the License.
- -->
-<html>
-<head>
- <meta http-equiv="content-type" content="">
- <title>Guidelines</title>
- <link href="css/axis-docs.css" rel="stylesheet" type="text/css" media="all">
-</head>
-
-<body>
-<h2>Release Process</h2>
-
-<p>Click to read our <a href="release-process.html">Release Process Guidelines</a>.</p>
-
-<h2>Mail Guidelines</h2>
-
-<p>Every volunteer project obtains its strength from the people involved in
-it. Mailing lists provide a simple and effective communication mechanism.</p>
-
-<p>You are welcome to join any of our mailing lists (or all of them if you
-wish). You can choose to lurk, or actively participate. It's up to you.</p>
-
-<p><b>Before you join these lists, you should make sure that you read and
-follow the information below.</b></p>
-
-<p>We ask that you do your best to respect the charter of the appropriate
-mailing list. There are generally two types of lists that you can join.</p>
-<ul>
- <li>The "User" list is where you should send questions and comments about
- configuration, setup, usage and other "user" type of questions.</li>
- <li>The "Developer" list is where you should send questions and comments
- about the actual software source code and general "development" type of
- questions.</li>
-</ul>
-
-<p><b>Summary : Prefix each message subject with "[Axis2]"</b> <br>
-You may already know that Axis 1.x is still going parallel with Axis 2.0. So
-for everyone's convenience, prefix the subject of <b>every mail </b>about
-Axis 2.0 with [Axis2].</p>
-
-<p><b>Summary: Join the lists that are appropriate for your discussion.</b>
-<br>
-Please make sure that you are joining the list that is appropriate for the
-topic or product that you would like to discuss.</p>
-
-<p><b>Summary: Do not abuse resources in order to get help.</b> <br>
-Asking your configuration or user type of question on the developers list
-because you think that you will get help more quickly by going directly to
-the developers instead of to the user base is not very nice. Chances are that
-doing this will actually prevent people from answering your question because
-it is clear that you are trying to abuse resources.</p>
-
-<p><b>Summary: Do your best to ensure that you are not sending HTML or
-"Stylelized" email to the list.</b> <br>
-If you are using Outlook or Outlook Express or Eudora, chances are that you
-are sending HTML email by default. There is usually a setting that will allow
-you to send "Plain Text" email. If you are using Microsoft products to send
-email, there are several bugs in the software that prevent you from turning
-off the sending of HTML email. Please read this page as well.</p>
-
-<p><b>Summary: Watch where you are sending email.</b> <br>
-The majority of our mailing lists have set the Reply-To to go back to the
-list. That means that when you Reply to a message, it will go to the list and
-not to the original author directly. The reason is because it helps
-facilitate discussion on the list for everyone to benefit from. Be careful of
-this as sometimes you may intend to reply to a message directly to someone
-instead of the entire list.</p>
-
-<p><b>Summary: Do not crosspost messages.</b> <br>
-In other words, pick a mailing list and send your messages to that mailing
-list only. Do not send your messages to multiple mailing lists. The reason is
-that people may be subscribed to one list and not to the other. Therefore,
-some people may only see half of the conversation.</p>
-
-<p> </p>
-</body>
-</html>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one
+ ~ or more contributor license agreements. See the NOTICE file
+ ~ distributed with this work for additional information
+ ~ regarding copyright ownership. The ASF licenses this file
+ ~ to you under the Apache License, Version 2.0 (the
+ ~ "License"); you may not use this file except in compliance
+ ~ with the License. You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing,
+ ~ software distributed under the License is distributed on an
+ ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ ~ KIND, either express or implied. See the License for the
+ ~ specific language governing permissions and limitations
+ ~ under the License.
+ -->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<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 http-equiv="content-type" content="" />
+<title>Guidelines</title>
+<link href="css/axis-docs.css" rel="stylesheet" type="text/css"
+media="all" />
+</head>
+<body>
+<h2>Release Process</h2>
+<p>Click to read our <a href="release-process.html">Release Process
+Guidelines</a>.</p>
+<h2>Mail Guidelines</h2>
+<p>Every volunteer project obtains its strength from the people
+involved in it. Mailing lists provide a simple and effective
+communication mechanism.</p>
+<p>You are welcome to join any of our mailing lists (or all of them
+if you wish). You can choose to lurk, or actively participate. It's
+up to you.</p>
+<p><b>Before you join these lists, you should make sure that you
+read and follow the information below.</b></p>
+<p>We ask that you do your best to respect the charter of the
+appropriate mailing list. There are generally two types of lists
+that you can join.</p>
+<ul>
+<li>The "User" list is where you should send questions and comments
+about configuration, setup, usage and other "user" type of
+questions.</li>
+<li>The "Developer" list is where you should send questions and
+comments about the actual software source code and general
+"development" type of questions.</li>
+</ul>
+<p><b>Summary : Prefix each message subject with
+"[Axis2]"</b><br />
+You may already know that Axis 1.x is still going parallel with
+Axis 2.0. So for everyone's convenience, prefix the subject of
+<b>every mail</b> about Axis 2.0 with [Axis2].</p>
+<p><b>Summary: Join the lists that are appropriate for your
+discussion.</b><br />
+Please make sure that you are joining the list that is appropriate
+for the topic or product that you would like to discuss.</p>
+<p><b>Summary: Do not abuse resources in order to get
+help.</b><br />
+Asking your configuration or user type of question on the
+developers list because you think that you will get help more
+quickly by going directly to the developers instead of to the user
+base is not very nice. Chances are that doing this will actually
+prevent people from answering your question because it is clear
+that you are trying to abuse resources.</p>
+<p><b>Summary: Do your best to ensure that you are not sending HTML
+or "Stylelized" email to the list.</b><br />
+If you are using Outlook or Outlook Express or Eudora, chances are
+that you are sending HTML email by default. There is usually a
+setting that will allow you to send "Plain Text" email. If you are
+using Microsoft products to send email, there are several bugs in
+the software that prevent you from turning off the sending of HTML
+email. Please read this page as well.</p>
+<p><b>Summary: Watch where you are sending email.</b><br />
+The majority of our mailing lists have set the Reply-To to go back
+to the list. That means that when you Reply to a message, it will
+go to the list and not to the original author directly. The reason
+is because it helps facilitate discussion on the list for everyone
+to benefit from. Be careful of this as sometimes you may intend to
+reply to a message directly to someone instead of the entire
+list.</p>
+<p><b>Summary: Do not crosspost messages.</b><br />
+In other words, pick a mailing list and send your messages to that
+mailing list only. Do not send your messages to multiple mailing
+lists. The reason is that people may be subscribed to one list and
+not to the other. Therefore, some people may only see half of the
+conversation.</p>
+<p></p>
+</body>
+</html>
Copied: webservices/axis2/trunk/java/xdocs/index.xml (from r556217, webservices/axis2/trunk/java/xdocs/index.html)
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/index.xml?view=diff&rev=556222&p1=webservices/axis2/trunk/java/xdocs/index.html&r1=556217&p2=webservices/axis2/trunk/java/xdocs/index.xml&r2=556222
==============================================================================
--- webservices/axis2/trunk/java/xdocs/index.html (original)
+++ webservices/axis2/trunk/java/xdocs/index.xml Fri Jul 13 21:37:26 2007
@@ -1,320 +1,328 @@
-<!--
- ~ Licensed to the Apache Software Foundation (ASF) under one
- ~ or more contributor license agreements. See the NOTICE file
- ~ distributed with this work for additional information
- ~ regarding copyright ownership. The ASF licenses this file
- ~ to you under the Apache License, Version 2.0 (the
- ~ "License"); you may not use this file except in compliance
- ~ with the License. You may obtain a copy of the License at
- ~
- ~ http://www.apache.org/licenses/LICENSE-2.0
- ~
- ~ Unless required by applicable law or agreed to in writing,
- ~ software distributed under the License is distributed on an
- ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- ~ KIND, either express or implied. See the License for the
- ~ specific language governing permissions and limitations
- ~ under the License.
- -->
-<html>
-<head>
- <meta http-equiv="content-type" content="">
- <title>Apache Axis2/Java - Next Generation Web Services</title>
- <link href="css/axis-docs.css" rel="stylesheet" type="text/css" media="all">
-</head>
-
-<body lang="en">
-<h1>Welcome to Apache Axis2/Java</h1>
-
-<p>Based on the Axis2 architecture, there are two implementations of the
-Apache Axis2 Web services engine - Apache Axis2/Java and Apache Axis2/C</p>
-
-<p>While you will find all the information on Apache Axis2/Java here, you can
-visit the <a href="http://ws.apache.org/axis2/c/"><strong>Apache
-Axis2/C</strong></a> Web site for Axis2/C implementation information.</p>
-
-<h2>27th April 2007 - Apache Axis2/Java Version 1.2 Released!</h2>
-
-<p>[ <a
-href="http://ws.apache.org/axis2/download.cgi"><strong>Download</strong></a>
-] | [ <a href="1_2/index.html"><strong>Documents Home</strong></a> ]</p>
-
-<p>Apache Axis2 is the core engine for Web services. It is a complete
-re-design and re-write of the widely used <a
-href="http://ws.apache.org/axis/">Apache Axis</a> SOAP stack, built on the
-lessons learnt from Apache Axis.</p>
-
-<h3><em>Apache Axis Project in a Nutshell:</em></h3>
-
-<p>Apache Axis is an implementation of the SOAP ("Simple Object Access
-Protocol") <a href="http://www.w3.org/TR/SOAP">submission</a> to W3C.</p>
-
-<p>Extract from the draft W3C specification:</p>
-
-<blockquote>
- "SOAP is a lightweight protocol for exchanging structured information in a
- decentralized, distributed environment. It is an XML based protocol that
- consists of three parts: an envelope that defines a framework for
- describing what is in a message and how to process it, a set of encoding
- rules for expressing instances of application-defined datatypes, and a
- convention for representing remote procedure calls and
-responses."</blockquote>
-
-<p>This project is a follow-on to the <a
-href="http://ws.apache.org/soap">Apache SOAP project</a>.</p>
-
-<p>Please see the <a href="http://ws.apache.org/axis/ref.html">Axis Reference
-Library</a> for a list of technical resources that should prove useful on
-this project.</p>
-
-<h3><em>Why Apache Axis2:</em></h3>
-
-<p>A new architecture for Axis was introduced during the August 2004 Summit
-in Colombo, Sri Lanka. The new architecture on which Axis2 is based on is
-more flexible, efficient and configurable in comparison to <a
-href="http://ws.apache.org/axis/java/architecture-guide.html">Axis1.x
-architecture</a>. Some well established concepts from Axis 1.x, like handlers
-etc., have been preserved in the new architecture.</p>
-
-<p>Apache Axis2 not only supports SOAP 1.1 and SOAP 1.2, but it also has
-integrated support for the widely popular <a
-href="http://www.xfront.com/REST-Web-Services.html">REST style of Web
-services</a>. The same business logic implementation can offer both a WS-*
-style interface as well as a REST style interface simultaneously.</p>
-
-<p>Apache Axis2 is more efficient, more modular and more XML-oriented than
-the older version. It is carefully designed to support the easy addition of
-plug-in "modules" that extend their functionality for features such as
-security and reliability. The <a
-href="http://ws.apache.org/axis2/modules/index.html">Modules</a> currently
-available or under development include:</p>
-<ul>
- <li><a
- href="http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wsrm"
- target="_blank">WS-ReliableMessaging</a> - Supported by <a
- href="http://ws.apache.org/sandesha/sandesha2/">Apache Sandesha2</a></li>
- <li><a
- href="http://www-128.ibm.com/developerworks/library/specification/ws-tx/#coor"
- target="_blank">WS-Coordination</a> and <a
- href="http://www-128.ibm.com/developerworks/library/specification/ws-tx/#atom"
- target="_blank">WS-AtomicTransaction</a> - Supported by <a
- href="http://ws.apache.org/kandula/">Apache Kandula2</a></li>
- <li><a
- href="http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wss"
- target="_blank">WS-Security</a> - Supported by <a
- href="http://ws.apache.org/axis2/modules/rampart/1_2/security-module.html">Apache
- Rampart</a></li>
- <li><a href="http://www.w3.org/Submission/ws-addressing/"
- target="_blank">WS-Addressing</a> -Module included as part of Axis2
- core</li>
-</ul>
-
-<p>Apache Axis2 is built on <a
-href="http://ws.apache.org/commons/axiom/index.html">Apache AXIOM</a>, a new
-high performant, pull-based XML object model.</p>
-
-<p>Axis2 comes with many new features, enhancements and industry
-specification implementations. The key features offered are as follows:</p>
-<ul>
- <li><p style="margin-bottom: 0in"><strong>Speed</strong> - Axis2 uses its
- own object model and StAX (Streaming API for XML) parsing to achieve
- significantly greater speed than earlier versions of Apache Axis.</p>
- </li>
- <li><p style="margin-bottom: 0in"><strong>Low memory foot print</strong>-
- Axis2 was designed ground-up keeping low memory foot print in mind.</p>
- </li>
- <li><p style="margin-bottom: 0in"><strong>AXIOM</strong> - Axis2 comes with
- its own light-weight object model, AXIOM, for message processing which is
- extensible, highly performant and is developer convenient.</p>
- </li>
- <li><p style="margin-bottom: 0in"><strong><a name="Hot_Deployment"
- id="Hot_Deployment"></a>Hot Deployment</strong> - Axis2 is equipped with
- the capability of deploying Web services and handlers while the system is
- up and running. In other words, new services can be added to the system
- without having to shut down the server. Simply drop the required Web
- service archive into the services directory in the repository, and the
- deployment model will automatically deploy the service and make it
- available for use.</p>
- </li>
- <li><p style="margin-bottom: 0in"><strong>Asynchronous Web
- services</strong> - Axis2 now supports asynchronous Web services and
- asynchronous Web services invocation using non-blocking clients and
- transports.</p>
- </li>
- <li><p style="margin-bottom: 0in"><strong>MEP Support</strong> - Axis2 now
- comes handy with the flexibility to support Message Exchange Patterns
- (MEPs) with in-built support for basic MEPs defined in WSDL 2.0.</p>
- </li>
- <li><p style="margin-bottom: 0in"><strong>Flexibility</strong> - The Axis2
- architecture gives the developer complete freedom to insert extensions
- into the engine for custom header processing, system management, and
- <em>anything else you can imagine</em>.</p>
- </li>
- <li><p style="margin-bottom: 0in"><strong>Stability</strong> - Axis2
- defines a set of published interfaces which change relatively slowly
- compared to the rest of Axis.</p>
- </li>
- <li><p style="margin-bottom: 0in"><strong>Component-oriented
- Deployment</strong> - You can easily define reusable networks of Handlers
- to implement common patterns of processing for your applications, or to
- distribute to partners.</p>
- </li>
- <li><p style="margin-bottom: 0in"><strong>Transport Framework</strong> - We
- have a clean and simple abstraction for integrating and using Transports
- (i.e., senders and listeners for SOAP over various protocols such as
- SMTP, FTP, message-oriented middleware, etc), and the core of the engine
- is completely transport-independent.</p>
- </li>
- <li><p style="margin-bottom: 0in"><strong>WSDL support</strong> - Axis2
- supports the Web Service Description Language, version <a
- href="http://www.w3.org/TR/wsdl">1.1</a> and <a
- href="http://www.w3.org/TR/wsdl20/">2.0</a>, which allows you to easily
- build stubs to access remote services, and also to automatically export
- machine-readable descriptions of your deployed services from Axis2.</p>
- </li>
- <li><p style="margin-bottom: 0in"><strong>Add-ons</strong> - Several Web
- services specifications have been incorporated including <a
- href="http://ws.apache.org/wss4j/" target="_blank">WSS4J</a> for security
- (Apache Rampart), <a href="http://ws.apache.org/sandesha/"
- target="_blank">Sandesha</a> for reliable messaging, <a
- href="http://ws.apache.org/kandula/" target="_blank">Kandula</a> which is
- an encapsulation of WS-Coordination, WS-AtomicTransaction and
- WS-BusinessActivity.</p>
- </li>
- <li><p style="margin-bottom: 0in"><strong>Composition and
- Extensibility</strong> - Modules and phases improve support for
- composability and extensibility. Modules support composability and can
- also support new WS-* specifications in a simple and clean manner. They
- are however not <a href="#Hot_Deployment">hot deployable</a> as they
- change the overall behavior of the system.</p>
- </li>
-</ul>
-
-<p>We hope you enjoy using Axis2. Please note that this is an open-source
-effort. If you feel the code could use new features or fixes, or the
-documentation can be improved, please get involved and lend us a hand! The
-Axis developer community welcomes your participation.</p>
-
-<p>Let us know what you think! Send your feedback on Axis2 to "<a
-href="mailto:axis-user@ws.apache.org">axis-user@ws.apache.org</a>". Make sure
-to prefix the subject of the mail with [Axis2].</p>
-
-<h2>Features of Axis2 Latest Version</h2>
-
-<p>Apache Axis2 Version 1.2 comes with performance improvements and bug fixes
-over the 1.1.1 release. Check out the complete list of features below.</p>
-
-<h3>Programming Model</h3>
-<ul>
- <li>Improved, XML-centric client API including full WSDL and policy
- support</li>
- <li>Support for POJO and Spring services and clients</li>
- <li>Support for any message exchange pattern</li>
- <li>Synchronous and asynchronous calls</li>
- <li>Archived service deployment model supporting full service encapsulation
- with versioning support</li>
- <li>Archived module deployment model supporting controlled extensibility
- with versioning support</li>
- <li><a href="#Hot_Deployment">Hot deployment</a></li>
- <li>WS-Policy driven code generation extensions</li>
- <li>Flexible service life cycle model</li>
- <li>Automatic support for POX (REST) style invocation of services</li>
- <li>Support for querying a service's WSDL (using ?wsdl), schema (using
- ?xsd) and policies (using ?policy)</li>
- <li>WSDL 2.0</li>
- <li>POJO annotation (<a href="http://jcp.org/en/jsr/detail?id=181">JSR
- 181</a>)</li>
- <li>JAX-WS intregration</li>
- <li>Custom Deployers</li>
- <li>Binary serialization (Fast Infoset)</li>
- <li>JSON support</li>
- <li>EJB Provider support</li>
-</ul>
-
-<h3>Supported Specifications</h3>
-<ul>
- <li>SOAP 1.1 and 1.2</li>
- <li>Message Transmission Optimization Mechanism (MTOM), XML Optimized
- Packaging (XOP) and SOAP with Attachments</li>
- <li>WSDL 1.1, including both SOAP and HTTP bindings</li>
- <li>WS-Addressing (submission and final)</li>
- <li>WS-Policy</li>
- <li>SAAJ 1.1</li>
-</ul>
-
-<h3>Transports</h3>
-<ul>
- <li>HTTP</li>
- <li>SMTP</li>
- <li>JMS</li>
- <li>TCP</li>
-</ul>
-
-<h3>Supported Data Bindings</h3>
-<ul>
- <li>Axis Data Binding (ADB)</li>
- <li>XMLBeans</li>
- <li>JibX</li>
- <li>JaxMe (Experimental)</li>
- <li>JaxBRI (Experimental)</li>
-</ul>
-
-<h2><a name="Tools_included_in this_Release">Tools Included in This
-Release</a></h2>
-
-<p>[<a href="http://ws.apache.org/axis2/tools/index.html"
-target="_blank">Download Tool Plug-ins</a>]</p>
-<ol type="1">
- <li>Axis2 Web Application (Web App)</li>
- <li>WSDL2WS- <a href="tools/1_2/eclipse/wsdl2java-plugin.html"
- target="_blank">eclipse plug-in</a><a>/</a> <a
- href="tools/1_2/CodegenToolReference.html" target="_blank">Command line
- version</a><a>/</a><a
- href="tools/1_2/idea/Idea_plug-in_userguide.html#WSDL2Java_Code_Generation"
- target="_blank">IntelliJ IDEA plug-in</a><a>/</a><a
- href="tools/1_2/maven-plugins/maven-wsdl2code-plugin.html"
- target="_blank">Maven2 WSDL2Code Plug-in</a></li>
- <li>Service Archive Wizard- <a
- href="tools/1_2/eclipse/servicearchiver-plugin.html"
- target="_blank">eclipse plug-in</a>/ <a
- href="tools/1_2/idea/Idea_plug-in_userguide.html#Create_Service_Archive"
- target="_blank">IntelliJ IDEA plug-in</a>/ <a
- href="tools/1_2/maven-plugins/maven-aar-plugin.html"
- target="_blank">Maven2 AAR Plug-in</a></li>
- <li>Java2WSDL- <a
- href="tools/1_2/maven-plugins/maven-java2wsdl-plugin.html"
- target="_blank">Maven2 Java2WSDL Plug-in</a></li>
-</ol>
-
-<h2>Extension Modules</h2>
-<ul>
- <li>Apache Rampart: Supporting WS-Security (and soon WS-Policy)</li>
- <li>Apache Sandesha2: Supporting WS-Reliable Messaging</li>
-</ul>
-(Apache Axis2 comes built in with a module that supports WS-Addressing.)
-
-<h2>Known Issues and Limitations</h2>
-<ul>
- <li>Xml-beans databinding does not support response unwrapping</li>
- <li>ADB databinding does not support minOccurs and maxOccurs attributes in
- sequence and choice elements (i.e., <code><sequence minOccurs="0"
- maxOccurs="unbounded"></sequence></code>)</li>
- <li>Unable to produce original WSDL in the case of WSDL 2.0, therefore the
- AxisService is serialized to produce ?wsdl2.</li>
-</ul>
-
-<h2>Archived News</h2>
-
-<p>For information on previous Axis2 releases running up to the current
-release see the <a href="archived_news.html" target="_blank">'Axis2 Archived
-News'</a> page.</p>
-For other news items from Apache Software Foundation see:
-<ul>
- <li><a
- href="http://www.apachenews.org/archives/cat_apache_webservices_index.html">Web
- services related news on the Apache News Blog Online</a></li>
- <li><a href="http://www.apachenews.org/">The Apache News Blog
- Online</a></li>
-</ul>
-</body>
-</html>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one
+ ~ or more contributor license agreements. See the NOTICE file
+ ~ distributed with this work for additional information
+ ~ regarding copyright ownership. The ASF licenses this file
+ ~ to you under the Apache License, Version 2.0 (the
+ ~ "License"); you may not use this file except in compliance
+ ~ with the License. You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing,
+ ~ software distributed under the License is distributed on an
+ ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ ~ KIND, either express or implied. See the License for the
+ ~ specific language governing permissions and limitations
+ ~ under the License.
+ -->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<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 http-equiv="content-type" content="" />
+<title>Apache Axis2/Java - Next Generation Web Services</title>
+<link href="css/axis-docs.css" rel="stylesheet" type="text/css"
+media="all" />
+</head>
+<body lang="en" xml:lang="en">
+<h1>Welcome to Apache Axis2/Java</h1>
+<p>Based on the Axis2 architecture, there are two implementations
+of the Apache Axis2 Web services engine - Apache Axis2/Java and
+Apache Axis2/C</p>
+<p>While you will find all the information on Apache Axis2/Java
+here, you can visit the <a href=
+"http://ws.apache.org/axis2/c/"><strong>Apache Axis2/C</strong></a>
+Web site for Axis2/C implementation information.</p>
+<h2>27th April 2007 - Apache Axis2/Java Version 1.2 Released!</h2>
+<p>[ <a href=
+"http://ws.apache.org/axis2/download.cgi"><strong>Download</strong></a>
+] | [ <a href="1_2/index.html"><strong>Documents Home</strong></a>
+]</p>
+<p>Apache Axis2 is the core engine for Web services. It is a
+complete re-design and re-write of the widely used <a href=
+"http://ws.apache.org/axis/">Apache Axis</a> SOAP stack, built on
+the lessons learnt from Apache Axis.</p>
+<h3><em>Apache Axis Project in a Nutshell:</em></h3>
+<p>Apache Axis is an implementation of the SOAP ("Simple Object
+Access Protocol") <a href=
+"http://www.w3.org/TR/SOAP">submission</a> to W3C.</p>
+<p>Extract from the draft W3C specification:</p>
+<blockquote>"SOAP is a lightweight protocol for exchanging
+structured information in a decentralized, distributed environment.
+It is an XML based protocol that consists of three parts: an
+envelope that defines a framework for describing what is in a
+message and how to process it, a set of encoding rules for
+expressing instances of application-defined datatypes, and a
+convention for representing remote procedure calls and
+responses."</blockquote>
+<p>This project is a follow-on to the <a href=
+"http://ws.apache.org/soap">Apache SOAP project</a>.</p>
+<p>Please see the <a href="http://ws.apache.org/axis/ref.html">Axis
+Reference Library</a> for a list of technical resources that should
+prove useful on this project.</p>
+<h3><em>Why Apache Axis2:</em></h3>
+<p>A new architecture for Axis was introduced during the August
+2004 Summit in Colombo, Sri Lanka. The new architecture on which
+Axis2 is based on is more flexible, efficient and configurable in
+comparison to <a href=
+"http://ws.apache.org/axis/java/architecture-guide.html">Axis1.x
+architecture</a>. Some well established concepts from Axis 1.x,
+like handlers etc., have been preserved in the new
+architecture.</p>
+<p>Apache Axis2 not only supports SOAP 1.1 and SOAP 1.2, but it
+also has integrated support for the widely popular <a href=
+"http://www.xfront.com/REST-Web-Services.html">REST style of Web
+services</a>. The same business logic implementation can offer both
+a WS-* style interface as well as a REST style interface
+simultaneously.</p>
+<p>Apache Axis2 is more efficient, more modular and more
+XML-oriented than the older version. It is carefully designed to
+support the easy addition of plug-in "modules" that extend their
+functionality for features such as security and reliability. The
+<a href="http://ws.apache.org/axis2/modules/index.html">Modules</a>
+currently available or under development include:</p>
+<ul>
+<li><a href=
+"http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wsrm"
+target="_blank">WS-ReliableMessaging</a> - Supported by <a href=
+"http://ws.apache.org/sandesha/sandesha2/">Apache
+Sandesha2</a></li>
+<li><a href=
+"http://www-128.ibm.com/developerworks/library/specification/ws-tx/#coor"
+target="_blank">WS-Coordination</a> and <a href=
+"http://www-128.ibm.com/developerworks/library/specification/ws-tx/#atom"
+target="_blank">WS-AtomicTransaction</a> - Supported by <a href=
+"http://ws.apache.org/kandula/">Apache Kandula2</a></li>
+<li><a href=
+"http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wss"
+target="_blank">WS-Security</a> - Supported by <a href=
+"http://ws.apache.org/axis2/modules/rampart/1_2/security-module.html">
+Apache Rampart</a></li>
+<li><a href="http://www.w3.org/Submission/ws-addressing/" target=
+"_blank">WS-Addressing</a> -Module included as part of Axis2
+core</li>
+</ul>
+<p>Apache Axis2 is built on <a href=
+"http://ws.apache.org/commons/axiom/index.html">Apache AXIOM</a>, a
+new high performant, pull-based XML object model.</p>
+<p>Axis2 comes with many new features, enhancements and industry
+specification implementations. The key features offered are as
+follows:</p>
+<ul>
+<li>
+<p style="margin-bottom: 0in"><strong>Speed</strong> - Axis2 uses
+its own object model and StAX (Streaming API for XML) parsing to
+achieve significantly greater speed than earlier versions of Apache
+Axis.</p>
+</li>
+<li>
+<p style="margin-bottom: 0in"><strong>Low memory foot
+print</strong>- Axis2 was designed ground-up keeping low memory
+foot print in mind.</p>
+</li>
+<li>
+<p style="margin-bottom: 0in"><strong>AXIOM</strong> - Axis2 comes
+with its own light-weight object model, AXIOM, for message
+processing which is extensible, highly performant and is developer
+convenient.</p>
+</li>
+<li>
+<p style="margin-bottom: 0in"><strong><a name="Hot_Deployment" id=
+"Hot_Deployment"></a>Hot Deployment</strong> - Axis2 is equipped
+with the capability of deploying Web services and handlers while
+the system is up and running. In other words, new services can be
+added to the system without having to shut down the server. Simply
+drop the required Web service archive into the services directory
+in the repository, and the deployment model will automatically
+deploy the service and make it available for use.</p>
+</li>
+<li>
+<p style="margin-bottom: 0in"><strong>Asynchronous Web
+services</strong> - Axis2 now supports asynchronous Web services
+and asynchronous Web services invocation using non-blocking clients
+and transports.</p>
+</li>
+<li>
+<p style="margin-bottom: 0in"><strong>MEP Support</strong> - Axis2
+now comes handy with the flexibility to support Message Exchange
+Patterns (MEPs) with in-built support for basic MEPs defined in
+WSDL 2.0.</p>
+</li>
+<li>
+<p style="margin-bottom: 0in"><strong>Flexibility</strong> - The
+Axis2 architecture gives the developer complete freedom to insert
+extensions into the engine for custom header processing, system
+management, and <em>anything else you can imagine</em>.</p>
+</li>
+<li>
+<p style="margin-bottom: 0in"><strong>Stability</strong> - Axis2
+defines a set of published interfaces which change relatively
+slowly compared to the rest of Axis.</p>
+</li>
+<li>
+<p style="margin-bottom: 0in"><strong>Component-oriented
+Deployment</strong> - You can easily define reusable networks of
+Handlers to implement common patterns of processing for your
+applications, or to distribute to partners.</p>
+</li>
+<li>
+<p style="margin-bottom: 0in"><strong>Transport Framework</strong>
+- We have a clean and simple abstraction for integrating and using
+Transports (i.e., senders and listeners for SOAP over various
+protocols such as SMTP, FTP, message-oriented middleware, etc), and
+the core of the engine is completely transport-independent.</p>
+</li>
+<li>
+<p style="margin-bottom: 0in"><strong>WSDL support</strong> - Axis2
+supports the Web Service Description Language, version <a href=
+"http://www.w3.org/TR/wsdl">1.1</a> and <a href=
+"http://www.w3.org/TR/wsdl20/">2.0</a>, which allows you to easily
+build stubs to access remote services, and also to automatically
+export machine-readable descriptions of your deployed services from
+Axis2.</p>
+</li>
+<li>
+<p style="margin-bottom: 0in"><strong>Add-ons</strong> - Several
+Web services specifications have been incorporated including
+<a href="http://ws.apache.org/wss4j/" target="_blank">WSS4J</a> for
+security (Apache Rampart), <a href="http://ws.apache.org/sandesha/"
+target="_blank">Sandesha</a> for reliable messaging, <a href=
+"http://ws.apache.org/kandula/" target="_blank">Kandula</a> which
+is an encapsulation of WS-Coordination, WS-AtomicTransaction and
+WS-BusinessActivity.</p>
+</li>
+<li>
+<p style="margin-bottom: 0in"><strong>Composition and
+Extensibility</strong> - Modules and phases improve support for
+composability and extensibility. Modules support composability and
+can also support new WS-* specifications in a simple and clean
+manner. They are however not <a href="#Hot_Deployment">hot
+deployable</a> as they change the overall behavior of the
+system.</p>
+</li>
+</ul>
+<p>We hope you enjoy using Axis2. Please note that this is an
+open-source effort. If you feel the code could use new features or
+fixes, or the documentation can be improved, please get involved
+and lend us a hand! The Axis developer community welcomes your
+participation.</p>
+<p>Let us know what you think! Send your feedback on Axis2 to
+"<a href=
+"mailto:axis-user@ws.apache.org">axis-user@ws.apache.org</a>". Make
+sure to prefix the subject of the mail with [Axis2].</p>
+<h2>Features of Axis2 Latest Version</h2>
+<p>Apache Axis2 Version 1.2 comes with performance improvements and
+bug fixes over the 1.1.1 release. Check out the complete list of
+features below.</p>
+<h3>Programming Model</h3>
+<ul>
+<li>Improved, XML-centric client API including full WSDL and policy
+support</li>
+<li>Support for POJO and Spring services and clients</li>
+<li>Support for any message exchange pattern</li>
+<li>Synchronous and asynchronous calls</li>
+<li>Archived service deployment model supporting full service
+encapsulation with versioning support</li>
+<li>Archived module deployment model supporting controlled
+extensibility with versioning support</li>
+<li><a href="#Hot_Deployment">Hot deployment</a></li>
+<li>WS-Policy driven code generation extensions</li>
+<li>Flexible service life cycle model</li>
+<li>Automatic support for POX (REST) style invocation of
+services</li>
+<li>Support for querying a service's WSDL (using ?wsdl), schema
+(using ?xsd) and policies (using ?policy)</li>
+<li>WSDL 2.0</li>
+<li>POJO annotation (<a href=
+"http://jcp.org/en/jsr/detail?id=181">JSR 181</a>)</li>
+<li>JAX-WS intregration</li>
+<li>Custom Deployers</li>
+<li>Binary serialization (Fast Infoset)</li>
+<li>JSON support</li>
+<li>EJB Provider support</li>
+</ul>
+<h3>Supported Specifications</h3>
+<ul>
+<li>SOAP 1.1 and 1.2</li>
+<li>Message Transmission Optimization Mechanism (MTOM), XML
+Optimized Packaging (XOP) and SOAP with Attachments</li>
+<li>WSDL 1.1, including both SOAP and HTTP bindings</li>
+<li>WS-Addressing (submission and final)</li>
+<li>WS-Policy</li>
+<li>SAAJ 1.1</li>
+</ul>
+<h3>Transports</h3>
+<ul>
+<li>HTTP</li>
+<li>SMTP</li>
+<li>JMS</li>
+<li>TCP</li>
+</ul>
+<h3>Supported Data Bindings</h3>
+<ul>
+<li>Axis Data Binding (ADB)</li>
+<li>XMLBeans</li>
+<li>JibX</li>
+<li>JaxMe (Experimental)</li>
+<li>JaxBRI (Experimental)</li>
+</ul>
+<h2><a name="Tools_included_in this_Release">Tools Included in This
+Release</a></h2>
+<p>[<a href="http://ws.apache.org/axis2/tools/index.html" target=
+"_blank">Download Tool Plug-ins</a>]</p>
+<ol type="1">
+<li>Axis2 Web Application (Web App)</li>
+<li>WSDL2WS- <a href="tools/1_2/eclipse/wsdl2java-plugin.html"
+target="_blank">eclipse plug-in</a><a>/</a> <a href=
+"tools/1_2/CodegenToolReference.html" target="_blank">Command line
+version</a><a>/</a><a href=
+"tools/1_2/idea/Idea_plug-in_userguide.html#WSDL2Java_Code_Generation"
+target="_blank">IntelliJ IDEA plug-in</a><a>/</a><a href=
+"tools/1_2/maven-plugins/maven-wsdl2code-plugin.html" target=
+"_blank">Maven2 WSDL2Code Plug-in</a></li>
+<li>Service Archive Wizard- <a href=
+"tools/1_2/eclipse/servicearchiver-plugin.html" target=
+"_blank">eclipse plug-in</a>/ <a href=
+"tools/1_2/idea/Idea_plug-in_userguide.html#Create_Service_Archive"
+target="_blank">IntelliJ IDEA plug-in</a>/ <a href=
+"tools/1_2/maven-plugins/maven-aar-plugin.html" target=
+"_blank">Maven2 AAR Plug-in</a></li>
+<li>Java2WSDL- <a href=
+"tools/1_2/maven-plugins/maven-java2wsdl-plugin.html" target=
+"_blank">Maven2 Java2WSDL Plug-in</a></li>
+</ol>
+<h2>Extension Modules</h2>
+<ul>
+<li>Apache Rampart: Supporting WS-Security (and soon
+WS-Policy)</li>
+<li>Apache Sandesha2: Supporting WS-Reliable Messaging</li>
+</ul>
+(Apache Axis2 comes built in with a module that supports
+WS-Addressing.)
+<h2>Known Issues and Limitations</h2>
+<ul>
+<li>Xml-beans databinding does not support response unwrapping</li>
+<li>ADB databinding does not support minOccurs and maxOccurs
+attributes in sequence and choice elements (i.e.,
+<code><sequence minOccurs="0"
+maxOccurs="unbounded"></sequence></code>)</li>
+<li>Unable to produce original WSDL in the case of WSDL 2.0,
+therefore the AxisService is serialized to produce ?wsdl2.</li>
+</ul>
+<h2>Archived News</h2>
+<p>For information on previous Axis2 releases running up to the
+current release see the <a href="archived_news.html" target=
+"_blank">'Axis2 Archived News'</a> page.</p>
+For other news items from Apache Software Foundation see:
+<ul>
+<li><a href=
+"http://www.apachenews.org/archives/cat_apache_webservices_index.html">
+Web services related news on the Apache News Blog Online</a></li>
+<li><a href="http://www.apachenews.org/">The Apache News Blog
+Online</a></li>
+</ul>
+</body>
+</html>
Copied: webservices/axis2/trunk/java/xdocs/maven-help.xml (from r556217, webservices/axis2/trunk/java/xdocs/maven-help.html)
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/maven-help.xml?view=diff&rev=556222&p1=webservices/axis2/trunk/java/xdocs/maven-help.html&r1=556217&p2=webservices/axis2/trunk/java/xdocs/maven-help.xml&r2=556222
==============================================================================
--- webservices/axis2/trunk/java/xdocs/maven-help.html (original)
+++ webservices/axis2/trunk/java/xdocs/maven-help.xml Fri Jul 13 21:37:26 2007
@@ -1,175 +1,153 @@
-<!--
- ~ Licensed to the Apache Software Foundation (ASF) under one
- ~ or more contributor license agreements. See the NOTICE file
- ~ distributed with this work for additional information
- ~ regarding copyright ownership. The ASF licenses this file
- ~ to you under the Apache License, Version 2.0 (the
- ~ "License"); you may not use this file except in compliance
- ~ with the License. You may obtain a copy of the License at
- ~
- ~ http://www.apache.org/licenses/LICENSE-2.0
- ~
- ~ Unless required by applicable law or agreed to in writing,
- ~ software distributed under the License is distributed on an
- ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- ~ KIND, either express or implied. See the License for the
- ~ specific language governing permissions and limitations
- ~ under the License.
- -->
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
-"http://www.w3.org/TR/html4/loose.dtd">
-<html>
-<head>
- <title>Quick Guide to Maven for Axis 2.0</title>
- <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
- <link href="css/axis-docs.css" rel="stylesheet" type="text/css" media="all">
-</head>
-
-<body lang="en">
-<h1 align="center">Quick Guide to Maven for Axis 2.0</h1>
-
-<h2 align="left">Introduction</h2>
-
-<p align="left"><a href="http://maven.apache.org">Maven</a> is used as the
-build tool of Axis 2.0. This document will provide a quick guide on how to
-use Maven with your developments.</p>
-
-<h2 align="left">Commands</h2>
-
-<table border="1" align="center">
- <tbody>
- <tr>
- <th scope="col">
- <div align="left">
- Command</div>
- </th>
- <th scope="col">
- <div align="left">
- Description</div>
- </th>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven</div>
- </td>
- <td>
- <div align="left">
- Downloads relevant jars if not available, and compiles and runs the
- tests in the system.</div>
- </td>
- </tr>
- <tr>
- <td>maven clean</td>
- <td>Cleans all the content built so far in the target folder. This will
- not clean the jar repository.</td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven test</div>
- </td>
- <td>
- <div align="left">
- Runs only the tests. Performs automatic compilation of the changed
- sources as well. This will not run SOAP interop tests</div>
- </td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven clean all-tests</div>
- </td>
- <td>
- <div align="left">
- Cleans up and runs all offline and online tests</div>
- </td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven itest</div>
- </td>
- <td>
- <div align="left">
- To run the online-mode tests for say the modules/integration, run
- "maven itest" from modules/integration</div>
- </td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven test itest</div>
- </td>
- <td>
- <div align="left">
- To run all the tests for say the modules/integration, run "maven test
- itest" from modules/integration</div>
- </td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven -g</div>
- </td>
- <td>
- <div align="left">
- Lists down all the commands available with Maven.</div>
- </td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven multiproject</div>
- </td>
- <td>
- <div align="left">
- Generates the site.</div>
- </td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven idea:multiproject</div>
- </td>
- <td>
- <div align="left">
- Generates IDEA .ipr, .iml and .iws project files.</div>
- </td>
- </tr>
- <tr>
- <td>
- <div align="left">
- maven -Dmaven.test.skip=true</div>
- </td>
- <td>
- <div align="left">
- </div>
- Builds Axis2 and skips all the tests.</td>
- </tr>
- </tbody>
-</table>
-<br>
-
-
-<h2 align="left">Maven FAQ</h2>
-
-<p><i>1. I have problems with Maven 1.1</i></p>
-
-<p style="text-indent: 10pt">It seems that Maven 1.1 doesn't come bundled
-with the required itest plug-in and artifact plug-in. Run the following to
-get it updated.<br>
-</p>
-<ol>
- <li>maven plugin:download -DgroupId=maven-itest-plugin
- -DartifactId=maven-itest-plugin -Dversion=1.0
- -Dmaven.repo.remote=http://www.openejb.org/maven,http://www.ibiblio.org/maven</li>
- <li>maven plugin:Download -DgroupId=maven
- -DartifactId=maven-artifact-plugin -Dversion=1.6</li>
-</ol>
-
-<p align="left"> </p>
-
-<p align="left"> </p>
-</body>
-</html>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one
+ ~ or more contributor license agreements. See the NOTICE file
+ ~ distributed with this work for additional information
+ ~ regarding copyright ownership. The ASF licenses this file
+ ~ to you under the Apache License, Version 2.0 (the
+ ~ "License"); you may not use this file except in compliance
+ ~ with the License. You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing,
+ ~ software distributed under the License is distributed on an
+ ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ ~ KIND, either express or implied. See the License for the
+ ~ specific language governing permissions and limitations
+ ~ under the License.
+ -->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<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" />
+<title>Quick Guide to Maven for Axis 2.0</title>
+<meta http-equiv="content-type" content=
+"text/html; charset=us-ascii" />
+<link href="css/axis-docs.css" rel="stylesheet" type="text/css"
+media="all" />
+</head>
+<body lang="en" xml:lang="en">
+<h1 align="center">Quick Guide to Maven for Axis 2.0</h1>
+<h2 align="left">Introduction</h2>
+<p align="left"><a href="http://maven.apache.org">Maven</a> is used
+as the build tool of Axis 2.0. This document will provide a quick
+guide on how to use Maven with your developments.</p>
+<h2 align="left">Commands</h2>
+<table border="1" align="center">
+<tbody>
+<tr>
+<th scope="col">
+<div align="left">Command</div>
+</th>
+<th scope="col">
+<div align="left">Description</div>
+</th>
+</tr>
+<tr>
+<td>
+<div align="left">maven</div>
+</td>
+<td>
+<div align="left">Downloads relevant jars if not available, and
+compiles and runs the tests in the system.</div>
+</td>
+</tr>
+<tr>
+<td>maven clean</td>
+<td>Cleans all the content built so far in the target folder. This
+will not clean the jar repository.</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven test</div>
+</td>
+<td>
+<div align="left">Runs only the tests. Performs automatic
+compilation of the changed sources as well. This will not run SOAP
+interop tests</div>
+</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven clean all-tests</div>
+</td>
+<td>
+<div align="left">Cleans up and runs all offline and online
+tests</div>
+</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven itest</div>
+</td>
+<td>
+<div align="left">To run the online-mode tests for say the
+modules/integration, run "maven itest" from
+modules/integration</div>
+</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven test itest</div>
+</td>
+<td>
+<div align="left">To run all the tests for say the
+modules/integration, run "maven test itest" from
+modules/integration</div>
+</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven -g</div>
+</td>
+<td>
+<div align="left">Lists down all the commands available with
+Maven.</div>
+</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven multiproject</div>
+</td>
+<td>
+<div align="left">Generates the site.</div>
+</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven idea:multiproject</div>
+</td>
+<td>
+<div align="left">Generates IDEA .ipr, .iml and .iws project
+files.</div>
+</td>
+</tr>
+<tr>
+<td>
+<div align="left">maven -Dmaven.test.skip=true</div>
+</td>
+<td>
+<div align="left"></div>
+Builds Axis2 and skips all the tests.</td>
+</tr>
+</tbody>
+</table>
+<br />
+<h2 align="left">Maven FAQ</h2>
+<p><i>1. I have problems with Maven 1.1</i></p>
+<p style="text-indent: 10pt">It seems that Maven 1.1 doesn't come
+bundled with the required itest plug-in and artifact plug-in. Run
+the following to get it updated.<br /></p>
+<ol>
+<li>maven plugin:download -DgroupId=maven-itest-plugin
+-DartifactId=maven-itest-plugin -Dversion=1.0
+-Dmaven.repo.remote=http://www.openejb.org/maven,http://www.ibiblio.org/maven</li>
+<li>maven plugin:Download -DgroupId=maven
+-DartifactId=maven-artifact-plugin -Dversion=1.6</li>
+</ol>
+<p align="left"></p>
+<p align="left"></p>
+</body>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org