ws-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From d...@apache.org
Subject cvs commit: ws-site/targets/axis/java/ant ant.html ant.pdf axis-admin.html axis-admin.pdf axis-java2wsdl.html axis-java2wsdl.pdf axis-wsdl2java.html axis-wsdl2java.pdf
Date Wed, 22 Oct 2003 15:17:45 GMT
dims        2003/10/22 08:17:45

  Modified:    targets/axis site.html site.pdf
               targets/axis/java reference.html reference.pdf
                        user-guide.html user-guide.pdf
               targets/axis/java/ant ant.html ant.pdf axis-admin.html
                        axis-admin.pdf axis-java2wsdl.html
                        axis-java2wsdl.pdf axis-wsdl2java.html
                        axis-wsdl2java.pdf
  Log:
  updated axis docs
  
  Revision  Changes    Path
  1.4       +10 -10    ws-site/targets/axis/site.html
  
  Index: site.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/site.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- site.html	16 Oct 2003 21:49:14 -0000	1.3
  +++ site.html	22 Oct 2003 15:17:44 -0000	1.4
  @@ -1304,7 +1304,7 @@
   23     }
   24  }
   </pre>
  -<p xmlns:cinclude="http://apache.org/cocoon/include/1.0">(You'll find this file in
<a href="../samples/userguide/example1/TestClient.java">samples/userguide/example1/TestClient.java</a>)</p>
  +<p xmlns:cinclude="http://apache.org/cocoon/include/1.0">(You'll find this file in
<a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/userguide/example1/TestClient.java">samples/userguide/example1/TestClient.java</a>)</p>
   <p xmlns:cinclude="http://apache.org/cocoon/include/1.0">Assuming you have a network
connection active, this program can be run as follows:</p>
   <pre xmlns:cinclude="http://apache.org/cocoon/include/1.0" class="example">% java
samples.userguide.example1.TestClient
   Sent 'Hello!', got 'Hello!'
  @@ -1400,7 +1400,7 @@
     }
   }
   </pre>
  -<p xmlns:cinclude="http://apache.org/cocoon/include/1.0">(You'll find this very class
in <a href="../samples/userguide/example2/Calculator.java">samples/userguide/example2/Calculator.java</a>.)</p>
  +<p xmlns:cinclude="http://apache.org/cocoon/include/1.0">(You'll find this very class
in <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/userguide/example2/Calculator.java">samples/userguide/example2/Calculator.java</a>.)</p>
   <p xmlns:cinclude="http://apache.org/cocoon/include/1.0">How do we go about making
this class available via SOAP? There are a couple of answers to that question, but we'll start
with the easiest way Axis provides to do this, which takes almost no effort at all!</p>
   <div class="h5">
   <h5>JWS (Java Web Service) Files - Instant Deployment</h5>
  @@ -1430,7 +1430,7 @@
   <div class="h5">
   <h5>Deploying via descriptors</h5>
   </div>
  -<p xmlns:cinclude="http://apache.org/cocoon/include/1.0">To really use the flexibility
available to you in Axis, you should get familiar with the Axis <strong>Web Service
Deployment Descriptor (WSDD)</strong> format. A deployment descriptor contains a bunch
of things you want to "deploy" into Axis - i.e. make available to the Axis engine. The most
common thing to deploy is a Web Service, so let's start by taking a look at a deployment descriptor
for a basic service (this file is <a href="../samples/userguide/example3/deploy.wsdd">samples/userguide/example3/deploy.wsdd</a>):</p>
  +<p xmlns:cinclude="http://apache.org/cocoon/include/1.0">To really use the flexibility
available to you in Axis, you should get familiar with the Axis <strong>Web Service
Deployment Descriptor (WSDD)</strong> format. A deployment descriptor contains a bunch
of things you want to "deploy" into Axis - i.e. make available to the Axis engine. The most
common thing to deploy is a Web Service, so let's start by taking a look at a deployment descriptor
for a basic service (this file is <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/userguide/example3/deploy.wsdd">samples/userguide/example3/deploy.wsdd</a>):</p>
   <pre xmlns:cinclude="http://apache.org/cocoon/include/1.0" class="example">&lt;deployment
xmlns="http://xml.apache.org/axis/wsdd/"
               xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"&gt;
    &lt;service name="MyService" provider="java:RPC"&gt;
  @@ -1566,7 +1566,7 @@
   <p xmlns:cinclude="http://apache.org/cocoon/include/1.0">
   <strong>Message Example</strong>
   </p>
  -<p xmlns:cinclude="http://apache.org/cocoon/include/1.0">A sample message service
can be found in <a href="../samples/message/MessageService.java">samples/message/MessageService.java</a>.
The service class, <span class="codefrag">MessageService</span>, has one public
method, <span class="codefrag">echoElements</span>, which matches the first of
the three method signatures above:</p>
  +<p xmlns:cinclude="http://apache.org/cocoon/include/1.0">A sample message service
can be found in <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/message/MessageService.java">samples/message/MessageService.java</a>.
The service class, <span class="codefrag">MessageService</span>, has one public
method, <span class="codefrag">echoElements</span>, which matches the first of
the three method signatures above:</p>
   <pre xmlns:cinclude="http://apache.org/cocoon/include/1.0" class="example">public
Element[] echoElements(Element [] elems) 
   </pre>
   <p xmlns:cinclude="http://apache.org/cocoon/include/1.0">The <span class="codefrag">MsgProvider</span>
handler calls the method with an array of <span class="codefrag">org.w3c.dom.Element</span>
objects that correspond to the immediate children of the incoming message's SOAP Body. Often,
this array will contain a single Element (perhaps the root element of some XML document conforming
to some agreed-upon schema), but the SOAP Body can handle any number of children. The method
returns an <span class="codefrag">Element[]</span> array to be returned in the
SOAP body of the response message.</p>
  @@ -1683,7 +1683,7 @@
                languageSpecificType="java:my.java.thingy"/&gt;
   </pre>
   <p xmlns:cinclude="http://apache.org/cocoon/include/1.0">The &lt;beanMapping&gt;
tag maps a Java class (presumably a bean) to an XML QName. You'll note that it has two important
attributes, <strong>qname</strong> and <strong>languageSpecificType</strong>.
So in this case, we'd be mapping the "my.java.thingy" class to the XML QName [someNamespace]:[local].</p>
  -<p xmlns:cinclude="http://apache.org/cocoon/include/1.0">Let's take a look at how
this works in practice. Go look at <a href="../samples/userguide/example5/BeanService.java">samples/userguide/example5/BeanService.java</a>.
The key thing to notice is that the argument to the service method is an Order object. Since
Order is not a basic type which Axis understands by default, trying to run this service without
a type mapping will result in a fault. (If you want to try this for yourself, you can use
the bad-deploy.wsdd file in the example5 directory.) But if we put a beanMapping into our
deployment, all will be well. Here's how to run this example (from the example5 directory):</p>
  +<p xmlns:cinclude="http://apache.org/cocoon/include/1.0">Let's take a look at how
this works in practice. Go look at <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/userguide/example5/BeanService.java">samples/userguide/example5/BeanService.java</a>.
The key thing to notice is that the argument to the service method is an Order object. Since
Order is not a basic type which Axis understands by default, trying to run this service without
a type mapping will result in a fault. (If you want to try this for yourself, you can use
the bad-deploy.wsdd file in the example5 directory.) But if we put a beanMapping into our
deployment, all will be well. Here's how to run this example (from the example5 directory):</p>
   <pre xmlns:cinclude="http://apache.org/cocoon/include/1.0" class="example">% java
org.apache.axis.client.AdminClient -llocal:///AdminService deploy.wsdd
   &lt;Admin&gt;Done processing&lt;/Admin&gt;
   
  @@ -1776,7 +1776,7 @@
   <div class="h5">
   <h5>Types</h5>
   </div>
  -<p xmlns:cinclude="http://apache.org/cocoon/include/1.0">The Java class generated
from a WSDL type will be named from the WSDL type. This class will typically, though not always,
be a bean. For example, given the WSDL (the WSDL used throughout the WSDL2Java discussion
is from the <a href="../samples/addr/AddressBook.wsdl">Address Book sample</a>):</p>
  +<p xmlns:cinclude="http://apache.org/cocoon/include/1.0">The Java class generated
from a WSDL type will be named from the WSDL type. This class will typically, though not always,
be a bean. For example, given the WSDL (the WSDL used throughout the WSDL2Java discussion
is from the <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/addr/AddressBook.wsdl">Address
Book sample</a>):</p>
   <pre xmlns:cinclude="http://apache.org/cocoon/include/1.0" class="example">&lt;xsd:complexType
name="phone"&gt;
     &lt;xsd:all&gt;
       &lt;xsd:element name="areaCode" type="xsd:int"/&gt;
  @@ -2013,7 +2013,7 @@
   <div class="h5">
   <h5>Step 1: Provide a Java interface or class</h5>
   </div>
  -<p xmlns:cinclude="http://apache.org/cocoon/include/1.0">Write and compile a Java
interface (or class) that describes the web service interface. Here is an example interface
that describes a web services that can be used to set/query the price of widgets (<a href="../samples/userguide/example6/WidgetPrice.java">samples/userguide/example6/WidgetPrice.java</a>):</p>
  +<p xmlns:cinclude="http://apache.org/cocoon/include/1.0">Write and compile a Java
interface (or class) that describes the web service interface. Here is an example interface
that describes a web services that can be used to set/query the price of widgets (<a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/userguide/example6/WidgetPrice.java">samples/userguide/example6/WidgetPrice.java</a>):</p>
   <pre xmlns:cinclude="http://apache.org/cocoon/include/1.0" class="example">package
samples.userguide.example6;
   <br>/**
    * Interface describing a web service to set and get Widget prices.
  @@ -2054,7 +2054,7 @@
   <li>
   <strong>WidgetPriceSoapBindingImpl.java</strong> : Java file containing the
default server implementation of the WidgetPrice web service.</li>
   <li style="list-style: none">
  -<br> You will need to modify the *SoapBindingImpl file to add your implementation
(see <a href="../samples/userguide/example6/WidgetPriceSoapBindingImpl.java">../samples/userguide/example6/WidgetPriceSoapBindingImpl.java</a>
).</li>
  +<br> You will need to modify the *SoapBindingImpl file to add your implementation
(see <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java//samples/userguide/example6/WidgetPriceSoapBindingImpl.java">samples/userguide/example6/WidgetPriceSoapBindingImpl.java</a>
).</li>
   <li>
   <strong>WidgetPrice.java</strong>: New interface file that contains the appropriate
<strong>java.rmi.Remote</strong> usages.</li>
   <li>
  @@ -2190,7 +2190,7 @@
   <p xmlns:cinclude="http://apache.org/cocoon/include/1.0">Here are the big categories.</p>
   <ul xmlns:cinclude="http://apache.org/cocoon/include/1.0">
   <li>
  -<a href="../samples/"><strong>The samples.</strong></a> These examples
are complete with deployment descriptors and often contain both client and server code.</li>
  +<a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/"><strong>The
samples.</strong></a> These examples are complete with deployment descriptors
and often contain both client and server code.</li>
   <li>
   <strong>The Javadocs.</strong> Full Javadocs are included with the binary distribution.
The Javadocs can be intimidating at first, but once you know the major user classes, they
are one of the fastest ways to an answer.</li>
   <li>
  @@ -4355,7 +4355,7 @@
   <dt>
   <strong>&lt;undeployment&gt;</strong>
   </dt>
  -<dd>The root element of the deployment document which tells Axis that this is an
undeployment. Undeployments are only useful as</dd>
  +<dd>The root element of the deployment document which tells Axis that this is an
undeployment.</dd>
   <dt></dt>
   <dt>
   <strong>&lt;handler [name="</strong><em>name</em><strong>"]
type="</strong><em>type</em><strong>"/&gt;</strong>
  
  
  
  1.4       +1107 -1107ws-site/targets/axis/site.pdf
  
  	<<Binary file>>
  
  
  1.3       +1 -1      ws-site/targets/axis/java/reference.html
  
  Index: reference.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/java/reference.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- reference.html	16 Oct 2003 21:49:16 -0000	1.2
  +++ reference.html	22 Oct 2003 15:17:44 -0000	1.3
  @@ -549,7 +549,7 @@
   <dt>
   <strong>&lt;undeployment&gt;</strong>
   </dt>
  -<dd>The root element of the deployment document which tells Axis that this is an
undeployment. Undeployments are only useful as</dd>
  +<dd>The root element of the deployment document which tells Axis that this is an
undeployment.</dd>
   <dt></dt>
   <dt>
   <strong>&lt;handler [name="</strong><em>name</em><strong>"]
type="</strong><em>type</em><strong>"/&gt;</strong>
  
  
  
  1.3       +105 -105  ws-site/targets/axis/java/reference.pdf
  
  	<<Binary file>>
  
  
  1.3       +9 -9      ws-site/targets/axis/java/user-guide.html
  
  Index: user-guide.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/java/user-guide.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- user-guide.html	16 Oct 2003 21:49:16 -0000	1.2
  +++ user-guide.html	22 Oct 2003 15:17:44 -0000	1.3
  @@ -369,7 +369,7 @@
   23     }
   24  }
   </pre>
  -<p>(You'll find this file in <a href="../samples/userguide/example1/TestClient.java">samples/userguide/example1/TestClient.java</a>)</p>
  +<p>(You'll find this file in <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/userguide/example1/TestClient.java">samples/userguide/example1/TestClient.java</a>)</p>
   <p>Assuming you have a network connection active, this program can be run as follows:</p>
   <pre class="example">% java samples.userguide.example1.TestClient
   Sent 'Hello!', got 'Hello!'
  @@ -465,7 +465,7 @@
     }
   }
   </pre>
  -<p>(You'll find this very class in <a href="../samples/userguide/example2/Calculator.java">samples/userguide/example2/Calculator.java</a>.)</p>
  +<p>(You'll find this very class in <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/userguide/example2/Calculator.java">samples/userguide/example2/Calculator.java</a>.)</p>
   <p>How do we go about making this class available via SOAP? There are a couple of
answers to that question, but we'll start with the easiest way Axis provides to do this, which
takes almost no effort at all!</p>
   <div class="h2">
   <h2>JWS (Java Web Service) Files - Instant Deployment</h2>
  @@ -495,7 +495,7 @@
   <div class="h5">
   <h5>Deploying via descriptors</h5>
   </div>
  -<p>To really use the flexibility available to you in Axis, you should get familiar
with the Axis <strong>Web Service Deployment Descriptor (WSDD)</strong> format.
A deployment descriptor contains a bunch of things you want to "deploy" into Axis - i.e. make
available to the Axis engine. The most common thing to deploy is a Web Service, so let's start
by taking a look at a deployment descriptor for a basic service (this file is <a href="../samples/userguide/example3/deploy.wsdd">samples/userguide/example3/deploy.wsdd</a>):</p>
  +<p>To really use the flexibility available to you in Axis, you should get familiar
with the Axis <strong>Web Service Deployment Descriptor (WSDD)</strong> format.
A deployment descriptor contains a bunch of things you want to "deploy" into Axis - i.e. make
available to the Axis engine. The most common thing to deploy is a Web Service, so let's start
by taking a look at a deployment descriptor for a basic service (this file is <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/userguide/example3/deploy.wsdd">samples/userguide/example3/deploy.wsdd</a>):</p>
   <pre class="example">&lt;deployment xmlns="http://xml.apache.org/axis/wsdd/"
               xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"&gt;
    &lt;service name="MyService" provider="java:RPC"&gt;
  @@ -631,7 +631,7 @@
   <p>
   <strong>Message Example</strong>
   </p>
  -<p>A sample message service can be found in <a href="../samples/message/MessageService.java">samples/message/MessageService.java</a>.
The service class, <span class="codefrag">MessageService</span>, has one public
method, <span class="codefrag">echoElements</span>, which matches the first of
the three method signatures above:</p>
  +<p>A sample message service can be found in <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/message/MessageService.java">samples/message/MessageService.java</a>.
The service class, <span class="codefrag">MessageService</span>, has one public
method, <span class="codefrag">echoElements</span>, which matches the first of
the three method signatures above:</p>
   <pre class="example">public Element[] echoElements(Element [] elems) 
   </pre>
   <p>The <span class="codefrag">MsgProvider</span> handler calls the method
with an array of <span class="codefrag">org.w3c.dom.Element</span> objects that
correspond to the immediate children of the incoming message's SOAP Body. Often, this array
will contain a single Element (perhaps the root element of some XML document conforming to
some agreed-upon schema), but the SOAP Body can handle any number of children. The method
returns an <span class="codefrag">Element[]</span> array to be returned in the
SOAP body of the response message.</p>
  @@ -748,7 +748,7 @@
                languageSpecificType="java:my.java.thingy"/&gt;
   </pre>
   <p>The &lt;beanMapping&gt; tag maps a Java class (presumably a bean) to an
XML QName. You'll note that it has two important attributes, <strong>qname</strong>
and <strong>languageSpecificType</strong>. So in this case, we'd be mapping the
"my.java.thingy" class to the XML QName [someNamespace]:[local].</p>
  -<p>Let's take a look at how this works in practice. Go look at <a href="../samples/userguide/example5/BeanService.java">samples/userguide/example5/BeanService.java</a>.
The key thing to notice is that the argument to the service method is an Order object. Since
Order is not a basic type which Axis understands by default, trying to run this service without
a type mapping will result in a fault. (If you want to try this for yourself, you can use
the bad-deploy.wsdd file in the example5 directory.) But if we put a beanMapping into our
deployment, all will be well. Here's how to run this example (from the example5 directory):</p>
  +<p>Let's take a look at how this works in practice. Go look at <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/userguide/example5/BeanService.java">samples/userguide/example5/BeanService.java</a>.
The key thing to notice is that the argument to the service method is an Order object. Since
Order is not a basic type which Axis understands by default, trying to run this service without
a type mapping will result in a fault. (If you want to try this for yourself, you can use
the bad-deploy.wsdd file in the example5 directory.) But if we put a beanMapping into our
deployment, all will be well. Here's how to run this example (from the example5 directory):</p>
   <pre class="example">% java org.apache.axis.client.AdminClient -llocal:///AdminService
deploy.wsdd
   &lt;Admin&gt;Done processing&lt;/Admin&gt;
   
  @@ -841,7 +841,7 @@
   <div class="h5">
   <h5>Types</h5>
   </div>
  -<p>The Java class generated from a WSDL type will be named from the WSDL type. This
class will typically, though not always, be a bean. For example, given the WSDL (the WSDL
used throughout the WSDL2Java discussion is from the <a href="../samples/addr/AddressBook.wsdl">Address
Book sample</a>):</p>
  +<p>The Java class generated from a WSDL type will be named from the WSDL type. This
class will typically, though not always, be a bean. For example, given the WSDL (the WSDL
used throughout the WSDL2Java discussion is from the <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/addr/AddressBook.wsdl">Address
Book sample</a>):</p>
   <pre class="example">&lt;xsd:complexType name="phone"&gt;
     &lt;xsd:all&gt;
       &lt;xsd:element name="areaCode" type="xsd:int"/&gt;
  @@ -1078,7 +1078,7 @@
   <div class="h5">
   <h5>Step 1: Provide a Java interface or class</h5>
   </div>
  -<p>Write and compile a Java interface (or class) that describes the web service interface.
Here is an example interface that describes a web services that can be used to set/query the
price of widgets (<a href="../samples/userguide/example6/WidgetPrice.java">samples/userguide/example6/WidgetPrice.java</a>):</p>
  +<p>Write and compile a Java interface (or class) that describes the web service interface.
Here is an example interface that describes a web services that can be used to set/query the
price of widgets (<a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/userguide/example6/WidgetPrice.java">samples/userguide/example6/WidgetPrice.java</a>):</p>
   <pre class="example">package samples.userguide.example6;
   <br>/**
    * Interface describing a web service to set and get Widget prices.
  @@ -1119,7 +1119,7 @@
   <li>
   <strong>WidgetPriceSoapBindingImpl.java</strong> : Java file containing the
default server implementation of the WidgetPrice web service.</li>
   <li style="list-style: none">
  -<br> You will need to modify the *SoapBindingImpl file to add your implementation
(see <a href="../samples/userguide/example6/WidgetPriceSoapBindingImpl.java">../samples/userguide/example6/WidgetPriceSoapBindingImpl.java</a>
).</li>
  +<br> You will need to modify the *SoapBindingImpl file to add your implementation
(see <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java//samples/userguide/example6/WidgetPriceSoapBindingImpl.java">samples/userguide/example6/WidgetPriceSoapBindingImpl.java</a>
).</li>
   <li>
   <strong>WidgetPrice.java</strong>: New interface file that contains the appropriate
<strong>java.rmi.Remote</strong> usages.</li>
   <li>
  @@ -1255,7 +1255,7 @@
   <p>Here are the big categories.</p>
   <ul>
   <li>
  -<a href="../samples/"><strong>The samples.</strong></a> These examples
are complete with deployment descriptors and often contain both client and server code.</li>
  +<a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/ws-axis/java/samples/"><strong>The
samples.</strong></a> These examples are complete with deployment descriptors
and often contain both client and server code.</li>
   <li>
   <strong>The Javadocs.</strong> Full Javadocs are included with the binary distribution.
The Javadocs can be intimidating at first, but once you know the major user classes, they
are one of the fastest ways to an answer.</li>
   <li>
  
  
  
  1.3       +274 -274  ws-site/targets/axis/java/user-guide.pdf
  
  	<<Binary file>>
  
  
  1.2       +12 -0     ws-site/targets/axis/java/ant/ant.html
  
  Index: ant.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/java/ant/ant.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- ant.html	16 Oct 2003 21:49:17 -0000	1.1
  +++ ant.html	22 Oct 2003 15:17:45 -0000	1.2
  @@ -299,6 +299,18 @@
       /&gt;
   </pre>
   <p>Here the target.* properties are pulled from a properties file for the system
being deployed to, so a single build file can deploy to different systems with ease.</p>
  +<div class="h4">
  +<h4>Foreach Task</h4>
  +</div>
  +<p>
  +<a href="foreach.html">&lt;axis-admin&gt;</a>
  +</p>
  +<div class="h4">
  +<h4>Runaxisfunctionaltests Task</h4>
  +</div>
  +<p>
  +<a href="runaxisfunctionaltests.html">&lt;axis-admin&gt;</a>
  +</p>
   <div id="pdf" align="right">
   <a href="ant.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
             PDF</a>
  
  
  
  1.2       +118 -60   ws-site/targets/axis/java/ant/ant.pdf
  
  	<<Binary file>>
  
  
  1.2       +77 -0     ws-site/targets/axis/java/ant/axis-admin.html
  
  Index: axis-admin.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/java/ant/axis-admin.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- axis-admin.html	16 Oct 2003 21:49:17 -0000	1.1
  +++ axis-admin.html	22 Oct 2003 15:17:45 -0000	1.2
  @@ -241,6 +241,83 @@
   <h1>Axis-admin Task</h1>
   </div>
   <div class="h3">
  +<div class="h3">
  +<h3>Axis-admin Task</h3>
  +</div>
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<!-- PAGE HEADER -->
  +<tr class="b">
  +<td>
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<tr class="b">
  +<td><strong>Axis-admin Task</strong>
  +<br> Task to administer a local or remote Axis server.</td><td>
  +<!-- PROJECT LOGO --><a href="http://jakarta.apache.org/ant/"><img alt="Apache
Ant" src="../images/ant_logo_large.gif"></a></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +<!-- START RIGHT SIDE MAIN BODY -->
  +<tr class="a">
  +<td>
  +<!-- Applying task/long-description -->
  +<!-- Start Description -->
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<tr class="b">
  +<td>&nbsp;</td>
  +</tr>
  +<tr class="a">
  +<td bgcolor="#525D76"><a name="description"></a><strong>Description</strong></td>
  +</tr>
  +<tr class="b">
  +<td>
  +<pre class="code">Task to administer a local or remote Axis server. Remember, for
remote admin, the server has to be accept remote management calls.</pre>
  +</td>
  +</tr>
  +</table>
  +<!-- End Description -->
  +<!-- Start Attributes -->
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<tr class="b">
  +<td>&nbsp;</td>
  +</tr>
  +<tr class="a">
  +<td bgcolor="#525D76"><a name="attributes"></a><strong>Parameters</strong></td>
  +</tr>
  +<tr class="b">
  +<td>
  +<pre class="code">AttributeDescriptionTypedebugset a debug flagbooleanfailonerrorWhether
or not the build should halt if this task fails. Defaults to true.booleanfileprotocolspecifies
that a simple file protocol be usedjava.lang.Stringhostnamename the host to adminjava.lang.Stringnewpasswordset
a new password; only valid if action=passwdjava.lang.Stringpasswordthe admin passwordjava.lang.Stringportthe
port to connect tointservletpaththe path to the AxisAdmin servletjava.lang.Stringtransportchainset
the transport chain to usejava.lang.Stringurlfull url to the admin endpointjava.lang.Stringusernameusername
to log in asjava.lang.Stringxmlfilethe name of the XML file containing deployment informationjava.io.File</pre>
  +</td>
  +</tr>
  +</table>
  +<!-- End Attributes -->
  +<!-- Start Elements -->
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<tr class="b">
  +<td>&nbsp;</td>
  +</tr>
  +<tr class="a">
  +<td bgcolor="#525D76"><a name="elements"></a><strong>Parameters
as nested elements</strong></td>
  +</tr>
  +<tr class="b">
  +<td></td>
  +</tr>
  +</table>
  +<!-- End Elements -->
  +</td>
  +</tr>
  +<!-- END RIGHT SIDE MAIN BODY -->
  +<!-- FOOTER SEPARATOR -->
  +<tr class="b">
  +<td>
  +<hr noshade="noshade" size="1">
  +</td>
  +</tr>
  +<!-- PAGE FOOTER -->
  +<tr class="a">
  +<td><em>Copyright &copy; 2000-2003, Apache Software Foundation</em></td>
  +</tr>
  +</table>
   <div id="pdf" align="right">
   <a href="axis-admin.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
             PDF</a>
  
  
  
  1.2       +107 -18   ws-site/targets/axis/java/ant/axis-admin.pdf
  
  	<<Binary file>>
  
  
  1.3       +79 -0     ws-site/targets/axis/java/ant/axis-java2wsdl.html
  
  Index: axis-java2wsdl.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/java/ant/axis-java2wsdl.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- axis-java2wsdl.html	16 Oct 2003 21:49:17 -0000	1.2
  +++ axis-java2wsdl.html	22 Oct 2003 15:17:45 -0000	1.3
  @@ -241,6 +241,85 @@
   <h1>Axis-java2wsdl Task</h1>
   </div>
   <div class="h3">
  +<div class="h3">
  +<h3>Axis-java2wsdl Task</h3>
  +</div>
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<!-- PAGE HEADER -->
  +<tr class="b">
  +<td>
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<tr class="b">
  +<td><strong>Axis-java2wsdl Task</strong>
  +<br> Generates a WSDL description from a Java class.</td><td>
  +<!-- PROJECT LOGO --><a href="http://jakarta.apache.org/ant/"><img alt="Apache
Ant" src="../images/ant_logo_large.gif"></a></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +<!-- START RIGHT SIDE MAIN BODY -->
  +<tr class="a">
  +<td>
  +<!-- Applying task/long-description -->
  +<!-- Start Description -->
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<tr class="b">
  +<td>&nbsp;</td>
  +</tr>
  +<tr class="a">
  +<td bgcolor="#525D76"><a name="description"></a><strong>Description</strong></td>
  +</tr>
  +<tr class="b">
  +<td>
  +<pre class="code">Generates a WSDL description from a Java class.</pre>
  +</td>
  +</tr>
  +</table>
  +<!-- End Description -->
  +<!-- Start Attributes -->
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<tr class="b">
  +<td>&nbsp;</td>
  +</tr>
  +<tr class="a">
  +<td bgcolor="#525D76"><a name="attributes"></a><strong>Parameters</strong></td>
  +</tr>
  +<tr class="b">
  +<td>
  +<pre class="code">AttributeDescriptionTypebindingnameThe name to use use for the
binding element. If not specified, the value of the servicePortName + "SoapBinding" is used.java.lang.Stringclassnamethe
class name to import, eg. org.example.Foo. Required. The class must be on the classpath.java.lang.StringexcludeComma
separated list of methods to exclude from the wsdl file.java.lang.StringextraclassesThe setter
for the "extraClasses" attributejava.lang.StringimplclassSometimes extra information is available
in the implementation class file. Use this option to specify the implementation class.java.lang.StringinputOptional
attribute that indicates the name of the input wsdl file. The output wsdl file will contain
everything from the input wsdl file plus the new constructs. If a new construct is already
present in the input wsdl file, it is not added. This option is useful for constructing a
wsdl file with multiple ports, bindings, or portTypes.java.io.FilelocationThe url of the location
of the service. The name after the last slash or backslash is the name of the service port
(unless overridden by the -s option). The service port address location attribute is assigned
the specified value.java.lang.Stringlocationimportthe location of the interface WSDL when
generating an implementation WSDL Required when outputImpl is setjava.lang.StringmethodsIf
this option is specified, only the indicated methods in your interface class will be exported
into the WSDL file. The methods list must be comma separated. If not specified, all methods
declared in the interface class will be exported into the WSDL filejava.lang.Stringnamespacethe
target namespace. Required.java.lang.StringnamespaceimplNamespace of the implementation WSDL.java.lang.StringoutputThe
name of the output WSDL file. If not specified, a suitable default WSDL file is written into
the current directory.java.io.FileoutputimplUse this option to indicate the name of the output
implementation WSDL file. If specified, Java2WSDL will produce separate interface and implementation
WSDL files. If not, a single WSDL file is generatedjava.io.FileporttypenameIndicates the name
to use use for the portType element. If not specified, the class-of-portType name is used.java.lang.Stringserviceelementnamethe
name of the service element. If not specified, the service element is the portTypeNameService.java.lang.Stringserviceportnameservice
port name (obtained from location if not specified)java.lang.StringstopclassesComma separated
list of classes which stop the Java2WSDL inheritance search.java.lang.StringstyleThe style
of the WSDL document: RPC, DOCUMENT or WRAPPED. If RPC, a rpc/encoded wsdl is generated. If
DOCUMENT, a document/literal wsdl is generated. If WRAPPED, a document/literal wsdl is generated
using the wrapped approach.java.lang.Stringtypemappingversionthe default type mapping registry
to use. Either 1.1 or 1.2. Default is 1.1org.apache.axis.tools.ant.wsdl.TypeMappingVersionEnumuseSet
the use optionjava.lang.Stringuseinheritedmethodsshould inherited methods be exported too?
Default=falseboolean</pre>
  +</td>
  +</tr>
  +</table>
  +<!-- End Attributes -->
  +<!-- Start Elements -->
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<tr class="b">
  +<td>&nbsp;</td>
  +</tr>
  +<tr class="a">
  +<td bgcolor="#525D76"><a name="elements"></a><strong>Parameters
as nested elements</strong></td>
  +</tr>
  +<tr class="b">
  +<td>
  +<pre class="code">&nbsp;mapping (org.apache.axis.tools.ant.wsdl.NamespaceMapping)add
a mapping of namespaces to packages&nbsp;mappingset (org.apache.axis.tools.ant.wsdl.MappingSet)add
a mapping of namespaces to packages</pre>
  +</td>
  +</tr>
  +</table>
  +<!-- End Elements -->
  +</td>
  +</tr>
  +<!-- END RIGHT SIDE MAIN BODY -->
  +<!-- FOOTER SEPARATOR -->
  +<tr class="b">
  +<td>
  +<hr noshade="noshade" size="1">
  +</td>
  +</tr>
  +<!-- PAGE FOOTER -->
  +<tr class="a">
  +<td><em>Copyright &copy; 2000-2003, Apache Software Foundation</em></td>
  +</tr>
  +</table>
   <div id="pdf" align="right">
   <a href="axis-java2wsdl.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif"
class="skin"><br>
             PDF</a>
  
  
  
  1.2       +107 -18   ws-site/targets/axis/java/ant/axis-java2wsdl.pdf
  
  	<<Binary file>>
  
  
  1.3       +79 -0     ws-site/targets/axis/java/ant/axis-wsdl2java.html
  
  Index: axis-wsdl2java.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/java/ant/axis-wsdl2java.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- axis-wsdl2java.html	16 Oct 2003 21:49:17 -0000	1.2
  +++ axis-wsdl2java.html	22 Oct 2003 15:17:45 -0000	1.3
  @@ -241,6 +241,85 @@
   <h1>Axis-wsdl2java Task</h1>
   </div>
   <div class="h3">
  +<div class="h3">
  +<h3>Axis-wsdl2java Task</h3>
  +</div>
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<!-- PAGE HEADER -->
  +<tr class="b">
  +<td>
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<tr class="b">
  +<td><strong>Axis-wsdl2java Task</strong>
  +<br> Create Java classes from local or remote WSDL.</td><td>
  +<!-- PROJECT LOGO --><a href="http://jakarta.apache.org/ant/"><img alt="Apache
Ant" src="../images/ant_logo_large.gif"></a></td>
  +</tr>
  +</table>
  +</td>
  +</tr>
  +<!-- START RIGHT SIDE MAIN BODY -->
  +<tr class="a">
  +<td>
  +<!-- Applying task/long-description -->
  +<!-- Start Description -->
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<tr class="b">
  +<td>&nbsp;</td>
  +</tr>
  +<tr class="a">
  +<td bgcolor="#525D76"><a name="description"></a><strong>Description</strong></td>
  +</tr>
  +<tr class="b">
  +<td>
  +<pre class="code">Create Java classes from local or remote WSDL. Mappings from namespaces
to packages can be provided as nested &lt;mapping&gt; elements. Proxy settings are
taken from the java runtime settings of http.ProxyHost, http.ProxyPort, etc. The Ant task
&lt;setProxy&gt; can set these. As well as the nested mapping elements, this task
uses the file NStoPkg.properties in the project base directory for namespace mappingThis task
does no dependency checking; files are generated whether they need to be or not. The exception
to this is the Impl class, which is not overwritten if it exists. This is a safety measure.
However, all other classes are generated overwriting anything that exists.The safe way to
use this task is to have it generate the java source in a build directory, then have a &lt;copy&gt;
task selectively copy the files you need into a safe location. Again, copying into the source
tree is dangerous, but a separate build/src tree is safe. Then include this separate tree
in the &lt;javac&gt; task's src attribute to include it in the build. Implement your
own implementation classes of the server stub and the test cases using the generated templates.
If you want to add methods to autogenerated data types, consider subclassing them, or write
helper classes.Tip: if you &lt;get&gt; the wsdl, and use the &lt;filesmatch&gt;
condition to compare the fetched wsdl with a catched copy, you can make the target that calls
the axis-wsd2ljava task conditional on the WSDL having changed. This stops spurious code regeneration
and follow-on rebuilds across the java source tree.</pre>
  +</td>
  +</tr>
  +</table>
  +<!-- End Description -->
  +<!-- Start Attributes -->
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<tr class="b">
  +<td>&nbsp;</td>
  +</tr>
  +<tr class="a">
  +<td bgcolor="#525D76"><a name="attributes"></a><strong>Parameters</strong></td>
  +</tr>
  +<tr class="b">
  +<td>
  +<pre class="code">AttributeDescriptionTypeallflag to generate code for all elements,
even unreferenced ones default=false;booleandebugflag for debug output; default=falsebooleandeployscopeadd
scope to deploy.xml: "Application", "Request", "Session" optional;java.lang.Stringfactoryname
of the Java2WSDLFactory class for extending WSDL generation functionsjava.lang.StringhelpergenTurn
on/off Helper class generation; default is falsebooleannamespacemappingfileset the mapping
file. This is a properties file of package=namespace order. Optional, default is to look for
a file called NStoPkg.properties in the project directory.java.io.Filenoimportsonly generate
code for the immediate WSDL document, and not imports; default=false;booleanoutputoutput directory
for emitted filesjava.io.Fileserversideemit server-side bindings for web service; default=falsebooleanskeletondeploydeploy
skeleton (true) or implementation (false) in deploy.wsdd. Default is false. Assumes server-side="true".booleantestcaseflag
for automatic Junit testcase generation default is falsebooleantimeouttimeout in milliseconds
for URL retrieval; default is 45 seconds. Set this to -1 to disable timeouts altogether: other
negative values are not allowed)longtypemappingversionthe default type mapping registry to
use. Either 1.1 or 1.2. Default is 1.1org.apache.axis.tools.ant.wsdl.TypeMappingVersionEnumurlURL
to fetch and generate WSDL for. Can be remote or a local file.java.lang.Stringverboseflag
for verbose output; default=falseboolean</pre>
  +</td>
  +</tr>
  +</table>
  +<!-- End Attributes -->
  +<!-- Start Elements -->
  +<table class="ForrestTable" cellspacing="1" cellpadding="4">
  +<tr class="b">
  +<td>&nbsp;</td>
  +</tr>
  +<tr class="a">
  +<td bgcolor="#525D76"><a name="elements"></a><strong>Parameters
as nested elements</strong></td>
  +</tr>
  +<tr class="b">
  +<td>
  +<pre class="code">&nbsp;mapping (org.apache.axis.tools.ant.wsdl.NamespaceMapping)add
a mapping of namespaces to packages&nbsp;mappingset (org.apache.axis.tools.ant.wsdl.MappingSet)add
a mapping of namespaces to packages</pre>
  +</td>
  +</tr>
  +</table>
  +<!-- End Elements -->
  +</td>
  +</tr>
  +<!-- END RIGHT SIDE MAIN BODY -->
  +<!-- FOOTER SEPARATOR -->
  +<tr class="b">
  +<td>
  +<hr noshade="noshade" size="1">
  +</td>
  +</tr>
  +<!-- PAGE FOOTER -->
  +<tr class="a">
  +<td><em>Copyright &copy; 2000-2003, Apache Software Foundation</em></td>
  +</tr>
  +</table>
   <div id="pdf" align="right">
   <a href="axis-wsdl2java.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif"
class="skin"><br>
             PDF</a>
  
  
  
  1.2       +107 -18   ws-site/targets/axis/java/ant/axis-wsdl2java.pdf
  
  	<<Binary file>>
  
  

Mime
View raw message