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 he...@apache.org on 2005/06/07 07:29:30 UTC

svn commit: r188698 - in /webservices/axis/trunk/java: maven.xml xdocs/userguide.html

Author: hemapani
Date: Mon Jun  6 22:29:28 2005
New Revision: 188698

URL: http://svn.apache.org/viewcvs?rev=188698&view=rev
Log:
change the axis2.war name back

Modified:
    webservices/axis/trunk/java/maven.xml
    webservices/axis/trunk/java/xdocs/userguide.html

Modified: webservices/axis/trunk/java/maven.xml
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/maven.xml?rev=188698&r1=188697&r2=188698&view=diff
==============================================================================
--- webservices/axis/trunk/java/maven.xml (original)
+++ webservices/axis/trunk/java/maven.xml Mon Jun  6 22:29:28 2005
@@ -61,7 +61,7 @@
         <ant:mkdir dir="${dist.dir}"/>
    	<ant:mkdir dir="target/lib"/>
 
-        <uptodate property="jars.uptodate" targetfile="target/axis2-${pom.currentVersion}.war">
+        <uptodate property="jars.uptodate" targetfile="target/axis2.war">
 	   <srcfiles dir="modules">
 	       <include name="**/*.java"/>
 	       <include name="**/*.xml"/>
@@ -135,7 +135,7 @@
                 <attainGoal name="create-lib"/>
          </j:if> 
         <!-- jar the test classes -->
-		<ant:war destfile="target/axis2-${pom.currentVersion}.war" webxml="modules/core/conf/web.xml">
+		<ant:war destfile="target/axis2.war" webxml="modules/core/conf/web.xml">
 		  	<ant:fileset dir="modules/core/html"/>
 		  	<ant:lib dir="target/lib">
 			    	<ant:include name="*.jar"/>
@@ -180,7 +180,7 @@
 				<ant:include name="*.jar"/>
 			</ant:fileset> 
 		</ant:copy> 
-		<ant:copy file="target/axis2-${pom.currentVersion}.war" tofile="${bin.dist.dir}/webapps/axis2-${pom.currentVersion}.war"/>
+		<ant:copy file="target/axis2.war" tofile="${bin.dist.dir}/webapps/axis2.war"/>
 		<ant:copy todir="${bin.dist.dir}/samples">
 			<ant:fileset dir="modules/samples/conf/">
 				<ant:include name="*.xml"/>

Modified: webservices/axis/trunk/java/xdocs/userguide.html
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/userguide.html?rev=188698&r1=188697&r2=188698&view=diff
==============================================================================
--- webservices/axis/trunk/java/xdocs/userguide.html (original)
+++ webservices/axis/trunk/java/xdocs/userguide.html Mon Jun  6 22:29:28 2005
@@ -47,7 +47,7 @@
 </ul>
 <p>We hope you enjoy using Axis. Please note that this is an open-source effort - if you feel the code could use some new features or fixes, please get involved and lend a hand! The Axis developer community welcomes your participation . </p>
 <p>Let us know what you think! </p>
-<p>Please send feedback about the package to &quot; <a href="mailto:axis-user@ws.apache.org">axis-user@ws.apache.org </a>&quot; and make sure to prefix the subject of the mail with “[Axis2]”. </p>
+<p>Please send feedback about the package to &quot; <a href="mailto:axis-user@ws.apache.org">axis-user@ws.apache.org </a>&quot; and make sure to prefix the subject of the mail with [Axis2]. </p>
 <h2><a name="_Toc96698078"></a>What's in this release? </h2>
 <p>This release includes the following features:</p>
 <ul>
@@ -634,5 +634,102 @@
 <h2>Other Samples</h2>
 <h2>Tools</h2>
 <p>&nbsp;</p>
+<h2>Configuring Transports</h2>
+<h3>Configuring HTTP transports</h3>
+<p>The HTTP is configured by default, the server can be started by following </p>
+<code>Java org.apache.axis.transport.http.SimpleHTTPServer repository port</code>
+<h3>Configuring TCP transports</h3>
+<p>The TCP transport is configured by default</p>
+
+
+<h3>Configuring Mail transport</h3>
+<p>Mail transport has two parts, transport Sender and transport Listener. </p>
+
+ <a>First you need following additional jar dependencies in the classpath, they can be found by downloading the <a href="http://java.sun.com/products/javamail/">JavaMail API</a></p>
+  <ol>
+  <LI>pop3.jar</LI>
+  <LI>smtp.jar</LI>
+  <LI>mailapi.jar</LI>
+  <LI>activation.jar</LI>
+  </ol>
+  
+  
+<h4>Transport Sender</h4>
+<p>You need a mail account in a SMTP server, and Mail transport sender can be activated by adding following entry to the server.xml file or client.xml file or in both.
+  </p>
+  
+  <code>
+  <pre>
+   &lt;transportSender name="mail" class="org.apache.axis.transport.mail.MailTransportSender"&gt;
+        &lt;parameter name="transport.mail.smtp.host" locked="xsd:false"&gt;smtp server host&lt;/parameter&gt;
+        &lt;parameter name="transport.mail.smtp.user" locked="xsd:false"&gt;user name&lt;/parameter&gt;
+        &lt;parameter name="transport.mail.smtp.password" locked="xsd:false"&gt;password&lt;/parameter&gt;
+        &lt;parameter name="transport.mail.smtp.port" locked="xsd:false"&gt;25&lt;/parameter&gt;
+   &lt;/transportSender&gt;
+  </pre>
+  </code>
+  
+  <h4>Transport Receiver</h4>
+ 
+  
+  <p>You need a mail address that has pop access, the mail Listener can be activated by adding following entry to the server.xml file or client.xml file or in both.</p>
+  
+  <code><pre>
+  &lt;transportReceiver name="mail" class="org.apache.axis.transport.mail.SimpleMailListener">
+        &lt;parameter name="transport.mail.pop3.host" locked="xsd:false"&gt;pop server host&lt;/parameter&gt;
+        &lt;parameter name="transport.mail.pop3.user" locked="xsd:false"&gt;user name&lt;/parameter&gt;
+        &lt;parameter name="transport.mail.pop3.password" locked="xsd:false"&gt;password&lt;/parameter&gt;
+        &lt;parameter name="transport.mail.pop3.port" locked="xsd:false"&gt;110&lt;/parameter&gt;
+        &lt;parameter name="transport.mail.replyToAddress" locked="xsd:false"&gt;email address&lt;/parameter&gt;
+  &lt;/transportReceiver&gt;
+  </pre></code>
+  
+  <p>At the Client side if the Mail Listener is needed it is automatically started by Axis2. If the Mail Listener is need to be started as the server it can be done with following command with the all the axis2 jars and the mail dependency jars in the classpath.</p>
+  
+  <code>Java org.apache.axis.transport.mail.SimpleMailListener repository-directory</code>
+  
+  <h4>Configure James as SMTP and POP server</h4>
+  <p>Download the <a href="http://james.apache.org/">Apache James</a> and start the James, connect to the James via telnet for administrator James with following code
+</p>
+  <code>
+  <pre>
+  $telnet 127.0.0.1 4555
+  Trying 127.0.0.1...
+Connected to localhost.localdomain (127.0.0.1).
+Escape character is '^]'.
+JAMES Remote Administration Tool 2.2.0
+Please enter your login and password
+Login id:
+root
+Password:
+root
+Welcome root. HELP for a list of commands
+  </pre>
+  </code>
+
+  <p>add users to the James</p>
+  <code>
+  <pre>
+adduser axis2-server axis2
+User axis2-server added
+adduser axis2-client axis2
+User axis2-client added
+Connection closed by foreign host.
+  </pre>
+  </code>  
+  
+  <p>Now the James is up and running with the accounts</p>
+  
+  <h2>Enable REST support</h2>
+  <h3>Enable the REST support for the Server side</h3>
+  <p>Add the following parameter in the server.xml file</p>
+  <code>&lt;parameter name="eanbleREST" locked="xsd:false"&gt;true&lt;/parameter&gt;</code>
+  
+  
+  <h3>Enable the REST support for the Client side</h3>
+  <p>There are two ways to enable REST at the client side, first is to do the same thing done at the 
+  Server side in the client.xml file or do the following in the Call.</p>
+  <code>call.set(Constants.Configuration.DO_REST,"true");</code>
+
 </body>
 </html>