nmukhi 2003/01/07 09:52:44
Modified: java/samples/customfactory/client/dynamic README.html
java/samples/ejb/client/dynamic README.html
java/samples/localjava/client/stub README.html
java/samples/multibinding/client/dynamic README.html
java/samples/multibinding/client/stub README.html
Log:
Minor changes to READMEs (typos etc.)
Revision Changes Path
1.2 +1 -1
xml-axis-wsif/java/samples/customfactory/client/dynamic/README.html
Index: README.html
===================================================================
RCS file:
/home/cvs/xml-axis-wsif/java/samples/customfactory/client/dynamic/README.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- README.html 20 Dec 2002 12:53:22 -0000 1.1
+++ README.html 7 Jan 2003 17:52:43 -0000 1.2
@@ -10,7 +10,7 @@
<h2>
Web Services Invocation Framework:<br>
Invoking the CustomFactory Sample using WSIF's dynamic invocation interface</h2>
-<p>After you have <a href="../../../../doc/samples.html">set up the CLASSPATH in
your environment</a>, to invoke this sample using WSIF's DII, run the DynamicInvoker
class. Specify as command line arguments the location of the WSDL file for the
stockquote sample followed by the operation you wish to invoke and the symbol for the
company whose stockquote you are interested in. For example, <br><tt>java
clients.DynamicInvoker samples/simplesoap/StockquoteSOAP.wsdl getQuote IBM</tt></p>
+<p>After you have <a href="../../../../doc/samples.html">set up the CLASSPATH in
your environment</a>, to invoke this sample using WSIF's DII, run the DynamicInvoker
class. Specify as command line arguments the location of the WSDL file for the
stockquote sample followed by the operation you wish to invoke and the symbol for the
company whose stockquote you are interested in. For example, <br><tt>java
clients.DynamicInvoker samples/customfactory/StockquoteSOAP.wsdl getQuote IBM</tt></p>
<p>To see details of how the WSIF API is used to make invocations dynamically, take
a look at the code for the <a
href="../../../clients/DynamicInvoker.java">DynamicInvoker class</a>.</p>
<hr width="100%">
</body></html>
1.2 +1 -1 xml-axis-wsif/java/samples/ejb/client/dynamic/README.html
Index: README.html
===================================================================
RCS file: /home/cvs/xml-axis-wsif/java/samples/ejb/client/dynamic/README.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- README.html 13 Dec 2002 22:59:55 -0000 1.1
+++ README.html 7 Jan 2003 17:52:43 -0000 1.2
@@ -12,7 +12,7 @@
Invoking the EJB Sample using WSIF's dynamic invocation interface</h2>
<p>First you need to <a href="../../../../doc/samples.html">set up the CLASSPATH in
your environment</a>. Beyond the standard classpath setting, you also need to add the
J2EE client jar files to your classpath. The set of J2EE client JARs is vendor
specific; refer to the documentation in your application server on how to set up the
environment for an EJB client, and add the JAR files specified. For JBoss users, we
have included a script to set up the client environment. To run this script, make sure
you are in your base WSIF directory (the one that contains the <tt>classpath.bat</tt>
script. Set the variable <tt>JBOSS_HOME</tt> to point to your JBoss installation. From
there, run the command <tt>samples\ejb\client\jboss_setup\jboss.bat</tt>. This sets up
the entire client classpath required to run the sample using JBoss client JAR
files.</p>
<p>The <a href="../../AddressBook.wsdl">WSDL file</a> that describes the service
and its EJB binding is vendor-specific in the <tt><ejb:address></tt> element.
The <tt>initialContextFactory</tt>, <tt>jndiName</tt> and <tt>jndiProviderURL</tt>
attributes will all depend on your specific deployment; refer to your application
server documentation on how to write an EJB client to learn more about JNDI and
related issues. Make sure these values are all correct before you try running the
client.</p>
-<p>After you have set up your classpath, to invoke this sample using WSIF's DII,
run the <tt>Run</tt> class located in this directory. This class will populate an
addressbook with two names and then query each of them by invoking various operations
supported by the service. To run this class, specify on the command line the location
of the WSDL file for the service. For example, <br><tt>java ejb.clients.dynamic.Run
samples/ejb/AddressBook.wsdl</tt></p>
+<p>After you have set up your classpath, to invoke this sample using WSIF's DII,
run the <tt>Run</tt> class located in this directory. This class will populate an
addressbook with two names and then query each of them by invoking various operations
supported by the service. To run this class, specify on the command line the location
of the WSDL file for the service. For example, <br><tt>java ejb.client.dynamic.Run
samples/ejb/AddressBook.wsdl</tt></p>
<p>Look at the code in the <tt>Run.java</tt> file in this directory to see how to
use WSIF's DII yourself. Note that the <tt>DynamicInvoker</tt> class we used to <a
href="../../../simplesoap/client/dynamic/README.html">invoke the simplesoap sample
dynamically</a> cannot be used for this one since the <tt>DynamicInvoker</tt> as it
stands now is limited to invocation of services using primitive schema types only.</p>
<hr width="100%">
</body></html>
1.3 +1 -1 xml-axis-wsif/java/samples/localjava/client/stub/README.html
Index: README.html
===================================================================
RCS file: /home/cvs/xml-axis-wsif/java/samples/localjava/client/stub/README.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- README.html 11 Dec 2002 20:49:16 -0000 1.2
+++ README.html 7 Jan 2003 17:52:43 -0000 1.3
@@ -20,7 +20,7 @@
</ul>
</p>
<p>This directory contains a file called <tt>Run.java</tt> that contains the
<tt>main</tt> method. This is the logic that uses the generated stub interface to run
the sample. So you can run this class, specifying on the command line the location of
the WSDL file for the sample. For example, <br>
-<tt>java samples.localjava.client.stub.Run
samples/localjava/AddressBook.wsdl</tt></p>
+<tt>java localjava.client.stub.Run samples/localjava/AddressBook.wsdl</tt></p>
<p>The sample code will use the stub interface to populate an addressbook with two
entries and will then query the addressbook for those two addresses using the
corresponding names.</p>
<p>To generate the stub interface, you can use any tool that generates Java
interfaces for WSDL services using their port type descriptions, such as WSDL2Java
from Axis. WSIF assumes a correspondence between the generated Java interface and the
WSDL port type that has its abstract description as specified in the JAX-RPC
specification. This particular sample did not use WSDL2Java in a simple way (due to a
current bug in WSDL2Java that prevents it from processing WSDLs that do not have a
valid SOAP endpoint or binding. We managed to get it to work by commenting out the
java binding that is currently there, and introducing a binding element that describes
a SOAP binding. After doing this, we ran WSDL2Java in the following way:<br>
<tt>java org.apache.axis.wsdl.WSDL2Java ../../AddressBook.wsdl</tt><br>
1.2 +6 -4
xml-axis-wsif/java/samples/multibinding/client/dynamic/README.html
Index: README.html
===================================================================
RCS file:
/home/cvs/xml-axis-wsif/java/samples/multibinding/client/dynamic/README.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- README.html 17 Dec 2002 17:14:12 -0000 1.1
+++ README.html 7 Jan 2003 17:52:43 -0000 1.2
@@ -11,10 +11,12 @@
Web Services Invocation Framework:<br>
Invoking the MultiBinding Sample using WSIF's dynamic invocation interface</h2>
<p>After you have <a href="../../../../doc/samples.html">set up the CLASSPATH in
your environment</a>, to invoke this sample using WSIF's DII, run the DynamicInvoker
class. Specify as command line arguments the location of the WSDL file for the
multibinding sample followed by the operation you wish to invoke, an optional
preferred port in parentheses and the symbol for the company whose stockquote you are
interested in. For example,
-<br>Invocation with no port preference: <tt>java clients.DynamicInvoker
samples/simplesoap/StockquoteSOAP.wsdl getQuote IBM</tt>
-<br>Invocation with SOAP port preference: <tt>java clients.DynamicInvoker
samples/simplesoap/StockquoteSOAP.wsdl getQuote(StockQuoteSOAPPort) IBM</tt>
-<br>Invocation with java port preference: <tt>java clients.DynamicInvoker
samples/simplesoap/StockquoteSOAP.wsdl getQuote(StockQuoteJavaPort) IBM</tt>
+<br>Invocation with no port preference: <tt>java clients.DynamicInvoker
samples/multibinding/StockQuoteService.wsdl getQuote IBM</tt>
+<br>Invocation with SOAP port preference: <tt>java clients.DynamicInvoker
samples/multibinding/StockQuoteService.wsdl getQuote(StockQuoteSOAPPort) IBM</tt>
+<br>Invocation with java port preference: <tt>java clients.DynamicInvoker
samples/multibinding/StockQuoteService.wsdl getQuote(StockQuoteJavaPort) IBM</tt>
</p>
<p>To see details of how the WSIF API is used to make invocations dynamically, take
a look at the code for the <a
href="../../../clients/DynamicInvoker.java">DynamicInvoker class</a>. Note the use of
the <tt>portName</tt> parameter to make the invocation using the selected port.</p>
<hr width="100%">
-</body></html>
\ No newline at end of file
+</body></html>
+
+WRONG FILE
\ No newline at end of file
1.2 +3 -5 xml-axis-wsif/java/samples/multibinding/client/stub/README.html
Index: README.html
===================================================================
RCS file: /home/cvs/xml-axis-wsif/java/samples/multibinding/client/stub/README.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- README.html 17 Dec 2002 17:14:12 -0000 1.1
+++ README.html 7 Jan 2003 17:52:43 -0000 1.2
@@ -12,16 +12,14 @@
Invoking the Multibinding Sample through a high level stub interface</h2>
First, you must <a href="../../../../doc/samples.html">set up the CLASSPATH in your
environment</a>.
<p>This directory contains a file called <tt>Run.java</tt> that contains the
<tt>main</tt> method. This is the logic that uses the generated stub interface to run
the sample. So you can run this class, specifying on the command line the location of
the WSDL file for the sample, the symbol for the company whose stock quote you are
interested in and an optional port preference. For example,
-<br>Invoking the service without specifying any port preference:
-<tt>java multibinding.client.stub.Run samples/multibinding/StockquoteSOAP.wsdl
IBM</tt>
<br>Invoking the service with the SOAP port preference:
-<tt>java multibinding.client.stub.Run samples/multibinding/StockquoteSOAP.wsdl IBM
StockQuoteSOAPPort</tt>
+<tt>java multibinding.client.stub.Run samples/multibinding/StockquoteService.wsdl
IBM StockQuoteSOAPPort</tt>
<br>Invoking the service with the java port preference:
-<tt>java multibinding.client.stub.Run samples/multibinding/StockquoteSOAP.wsdl IBM
StockQuoteJavaPort</tt>
+<tt>java multibinding.client.stub.Run samples/multibinding/StockquoteService.wsdl
IBM StockQuoteJavaPort</tt>
</p>
<p>The WSIF API allows programs to choose a preferred port when getting a reference
to the stub interface. Any calls made via that stub interface will then use the
selected port and its associated binding protocol. See the <tt>Run.java</tt> code for
details.</p>
<p>To generate the stub interface, you can use any tool that generates Java
interfaces for WSDL services using their port type descriptions, such as WSDL2Java
from Axis. WSIF assumes a correspondence between the generated Java interface and the
WSDL port type that has its abstract description as specified in the JAX-RPC
specification. This particular sample used WSDL2Java in the following way:<br>
<tt>java org.apache.axis.wsdl.WSDL2Java ../../StockquoteService.wsdl</tt><br>
After the tool finished running, we deleted all the generated files except
<tt>NetXmethodsServicesStockquoteStockQuotePortType.java</tt> (this is the java
interface corresponding to the port type and is all that is required by WSIF).</p>
<hr width="100%">
-</body></html>
\ No newline at end of file
+</body></html>
