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/31 16:11:50 UTC
svn commit: r561335 - in
/webservices/axis2/trunk/java/modules/documentation/xdocs: faq.xml
index.xml siteHowTo.xml
Author: dims
Date: Tue Jul 31 07:11:44 2007
New Revision: 561335
URL: http://svn.apache.org/viewvc?view=rev&rev=561335
Log:
Documentation cleanup
Modified:
webservices/axis2/trunk/java/modules/documentation/xdocs/faq.xml
webservices/axis2/trunk/java/modules/documentation/xdocs/index.xml
webservices/axis2/trunk/java/modules/documentation/xdocs/siteHowTo.xml
Modified: webservices/axis2/trunk/java/modules/documentation/xdocs/faq.xml
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/modules/documentation/xdocs/faq.xml?view=diff&rev=561335&r1=561334&r2=561335
==============================================================================
--- webservices/axis2/trunk/java/modules/documentation/xdocs/faq.xml (original)
+++ webservices/axis2/trunk/java/modules/documentation/xdocs/faq.xml Tue Jul 31 07:11:44 2007
@@ -1,312 +1,260 @@
-<!--
- ~ 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>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>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>
+<!--
+ ~ 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>
+</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>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>
+</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>
+</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>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>
+</body>
+</html>
Modified: webservices/axis2/trunk/java/modules/documentation/xdocs/index.xml
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/modules/documentation/xdocs/index.xml?view=diff&rev=561335&r1=561334&r2=561335
==============================================================================
--- webservices/axis2/trunk/java/modules/documentation/xdocs/index.xml (original)
+++ webservices/axis2/trunk/java/modules/documentation/xdocs/index.xml Tue Jul 31 07:11:44 2007
@@ -1,328 +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.
- -->
-<!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 Axis2 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 Axis2 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/POX 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>
Modified: webservices/axis2/trunk/java/modules/documentation/xdocs/siteHowTo.xml
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/modules/documentation/xdocs/siteHowTo.xml?view=diff&rev=561335&r1=561334&r2=561335
==============================================================================
--- webservices/axis2/trunk/java/modules/documentation/xdocs/siteHowTo.xml (original)
+++ webservices/axis2/trunk/java/modules/documentation/xdocs/siteHowTo.xml Tue Jul 31 07:11:44 2007
@@ -1,66 +1,65 @@
-<!--
- ~ 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>How To Build Axis Project's Website</title>
-<link href="css/axis-docs.css" rel="stylesheet" type="text/css"
-media="all" />
-</head>
-<body>
-<h1>How to Build the Axis2 Project's Website</h1>
-<h2>Installing Maven2</h2>
-<p>The Axis 2.0 website build system solely depends on <a href=
-"http://maven.apache.org/">Maven2</a>. The build has been
-specifically tested to work with Maven version 2.0.7. To install
-Maven, download the distributions and follow the instructions in
-the documentation. Make sure you don't forget to put MAVEN_HOME/bin
-directory in the path.</p>
-<h2>Checking out Axis 2.0</h2>
-<p>Checkout the <a href=
-"http://svn.apache.org/repos/asf/webservices/axis2/trunk/java">latest
-source</a> using your favorite SVN client. If you are a committer,
-get a <a href=
-"https://svn.apache.org/repos/asf/webservices/axis2/trunk/java">commiter
-check out.</a></p>
-<h2>Building the Site</h2>
-<p>Type <i>mvn site</i> at the root of your project
-folder. It will take some time to build the whole site. The built
-site will be available under targets/site.</p>
-<h2>FAQ</h2>
-<ol>
-<li>How can I update a document in the site ?<br />
-Get a commiter check out. All the documents are in HTML format
-under the xdocs folder, and you can change only the documents found
-under this folder. Change the relevant file and run maven
-"html2xdoc:transform". New documentation will be available under
-the target folder.</li>
-<li>How can I add a new document?<br />
-Put the new document in the xdocs folder. Change the navigation.xml
-found under the xdocs folder by adding a link to the newly added
-document. Re-generate the site.<br />
-Please make sure you have not included any of the illegal
-characters and your document should be well formed.</li>
-</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 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>How To Build Axis Project's Website</title>
+<link href="css/axis-docs.css" rel="stylesheet" type="text/css"
+media="all" />
+</head>
+<body>
+<h1>How to Build the Axis2 Project's Website</h1>
+<h2>Installing Maven2</h2>
+<p>The Axis 2.0 website build system solely depends on <a href=
+"http://maven.apache.org/">Maven2</a>. The build has been
+specifically tested to work with Maven version 2.0.7. To install
+Maven, download the distributions and follow the instructions in
+the documentation. Make sure you don't forget to add MAVEN_HOME/bin
+directory in the path.</p>
+<h2>Checking out Axis 2.0</h2>
+<p>Checkout the <a href=
+"http://svn.apache.org/repos/asf/webservices/axis2/trunk/java">latest
+source</a> using your favorite SVN client. If you are a committer,
+get a <a href=
+"https://svn.apache.org/repos/asf/webservices/axis2/trunk/java">commiter
+check out.</a></p>
+<h2>Building the Site</h2>
+<p>cd to modules/documentation and type <i>mvn install</i> The built
+site will be available under target/site.</p>
+<h2>FAQ</h2>
+<ol>
+<li>How can I update a document in the site ?<br />
+Get a commiter check out. All the documents are in XHTML format
+under the modules/documentation/xdocs folder, and you can change only the documents found
+under this folder. Change the relevant file and run <i>mvn
+install</i>. New documentation will be available under
+the target folder.</li>
+<li>How can I add a new document?<br />
+Add the new document in the xdocs folder. Change the navigation.xml
+found under the xdocs folder by adding a link to the newly added
+document. Re-generate the site.<br />
+Please make sure you have not included any of the illegal
+characters and your document should be well formed.</li>
+</ol>
+</body>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org