axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: xml-axis/java/docs user-guide.html
Date Thu, 15 Nov 2001 16:13:34 GMT
butek       01/11/15 08:13:34

  Modified:    java/docs user-guide.html
  Updated with the latest Wsdl2java gew gaws.
  Revision  Changes    Path
  1.20      +85 -1     xml-axis/java/docs/user-guide.html
  Index: user-guide.html
  RCS file: /home/cvs/xml-axis/java/docs/user-guide.html,v
  retrieving revision 1.19
  retrieving revision 1.20
  diff -u -r1.19 -r1.20
  --- user-guide.html	2001/10/22 12:00:43	1.19
  +++ user-guide.html	2001/11/15 16:13:34	1.20
  @@ -197,7 +197,7 @@
     call <code>addParameter</code> for each parameter, like so:
   <div class="example">
  -<pre>  call.addParameter( "testParam", org.apache.axis.encoding.XMLType.XSD_STRING,
  +<pre>  call.addParameter( "testParam", org.apache.axis.encoding.XMLType.XSD_STRING,
Call.PARAM_MODE_IN );</pre>
   This will assign the name <b>testParam</b> to the 1st (and only) parameter
  @@ -579,6 +579,90 @@
     would also get a companion class &quot;MyDataTypeHolder&quot;. These classes

     exist so that we have a reasonably clean mapping for WSDL's in/out and out parameters

     in Java. See the examples for more details.</p>
  +<h4>Wsdl2java details</h4>
  +Wsdl2java has a number of options, some of which have already been detailed.
  +<p>Usage:&nbsp; java org.apache.axis.wsdl.Wsdl2java [options] WSDL-URI
  +<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -h, --help
  +print this message and exit
  +<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -v, --verbose
  +print informational messages
  +<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -s, --skeleton
  +emit skeleton class for web service
  +<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -m, --messageContext
  +emit a MessageContext parameter to skeleton methods
  +<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -N, --NStoPkg
  +mapping of namespace to package
  +<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -o, --output
  +output directory for emitted files
  +<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -d, --deployScope
  +add scope to deploy.xml: "Application", "Request", "Session"
  +<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -t, --testCase
  +emit junit testcase class for web service
  +<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -n, --noImports
  +only generate code for the immediate WSDL document
  +-h, --help</h5>
  +Print the usage statement and exit
  +-v, --verbose</h5>
  +See what the tool is generating as it is generating it.
  +-s, --skeleton</h5>
  +Detailed above.
  +-m, --messageContext</h5>
  +The AXIS runtime contains a MessageContext that is normally not available
  +to the server-side implementation.&nbsp; Turning on this option adds a
  +MessageContext argument to each operation in the server-side interface
  +so that the implementation can be given the context.
  +-N, --NStoPkg &lt;argument>=&lt;value></h5>
  +By default, package names are generated from the namespace strings in the
  +WSDL document.&nbsp; Users can provide their own mapping using the --NStoPkg
  +argument, which can be repeated as often as necessary, once for each unique
  +namespace mapping.&nbsp; For example, if there is a namespace in the WSDL
  +document called "urn:AddressFetcher2", and you want files generated from
  +the objects within this namespace to reside in the package samples.addr,
  +you would provide the following option to Wsdl2java:
  +<pre>--NStoPkg urn:AddressFetcher2=samples.addr</pre>
  +If there are a number of namespaces in the WSDL document, listing a mapping
  +for them all could become tedious.&nbsp; To help keep the command line
  +terse, Wsdl2java will also look for mappings in a file called
  +residing in the default package (ie., no package).&nbsp; The entries in
  +this file are of the same form as the arguments to the --NStoPkg command
  +line option.&nbsp; For example, instead of providing the command line option
  +as above, we could provide the same information in
  +(Note that the colon must be escaped in the properties file.)
  +<p>If an entry for a given mapping exists both on the command line and
  +in the properties file, the command line entry takes precedence.
  +-o, --output &lt;argument></h5>
  +The root directory for all emitted files.
  +-d, --deployScope &lt;argument></h5>
  +Add scope to deploy.xml: "Application", "Request", or "Session".&nbsp;
  +If this option does not appear, no scope tag appears in deploy.xml, which
  +the AXIS runtime defaults to "Request".
  +-t, --testCase</h5>
  +Generate a client-side JUnit test case.
  +-n, --noImports</h5>
  +Only generate code for the WSDL document that appears on the command line.&nbsp;
  +The default behaviour is to generate files for all WSDL documents, the
  +immediate one and all imported ones.
   <h2><a name="DeploymentReference"></a>Deployment Reference</h2>
   <i>Note: this reference reflects the state of the deploy.xml structure as of the

   alpha 1 release. This will <b>very likely change</b> in a subsequent release

View raw message