Java APIs for XML Web Services 2.0 is developed as JSR 224 under the Java Community Process (JCP). This document explains the samples that are bundled along with the Early Access Standards Implementation of JAX-WS 2.0.
This section explains the directory structure of the samples
directory in the bundle:
docs | index.html, this file |
etc | Supporting files required by all the samples |
utils | Utility source file(s) required by the samples. |
lib | Utility JAR file(s), generated from the
source files in utils directory, required by the samples.
|
fromjava | Demonstrates how to build, deploy, and invoke a simple Web service starting from a Java service endpoint implementation using annotations. |
fromjavahandler | Same as fromjava sample but with a simple logging handler on the client and server. |
fromwsdl | Demonstrates how to build, deploy, and invoke a simple Web service starting from a WSDL using external customizations. |
fromwsdlhandler | Same as fromwsdl sample but with a simple logging handler on the client and server. |
dispatch | Demonstrates how to dynamically invoke web service endpoints. |
provider | Demonstrates how to build, deploy, and invoke javax.xml.ws.Provider based Web service endpoint. |
annotations | Same as fromjava but shows how to specify a different parameter name, operation name, targetNamespace, and other similar features. |
async | Demonstrates how to generate async operations in a client SEI from a WSDL and invoke it from the client application. |
external-customize | Demonstrates how a client client application can customize a published WSDL using external binding file. |
inline-customize | Demonstrates how a client application and server endpoint can be generated from a WSDL with embedded binding declarations. |
mtom | Demonstrates how to enable MTOM and swaRef. |
mtom-soap12 | Same as mtom sample but shows how to specify SOAP 1.2 binding. |
fromjava-soap12 | Same as fromjava sample but shows how to specify SOAP 1.2 binding. |
fromwsdl-soap12 | Same as fromwsdl sample but shows how to specify SOAP 1.2 binding. |
supplychain | Same as fromjava sample but using JavaBeans as parameter and return types. |
Here is the list of prerequisites that needs to be met before any of the samples can be invoked:
JAVA_HOME
to the J2SE 5.0 installation directory.AS_HOME
to point to
the Application Server installation directory.ANT_HOME
. Please
note that AS_HOME/bin/asant
cannot be used for building and
invoking the samples since JAX-RPC 1.1 implementation is baked into this
version of ant script. ANT_HOME/bin/ant install
from the root
directory of the JAX-WS 2.0 EA2 bundle. This will install JAX-WS 2.0 bundle on
the Application Server referred by AS_HOME
environment
variable.Each sample can be built, deployed and invoked using the ANT_HOME/bin/ant
and build.xml
ant
script in the
root directory of the sample. Each ant script supports the following
set of
targets:
server | Builds and deploy the service endpoint WAR |
client | Builds the client |
run | Runs the client |
It is essential for the service endpoint to be deployed on
Application Server
before clients can be built because clients use the WSDL exposed from
the
service endpoint deployed in the Application Server. So please make
sure that
your Application Server is either running before the server
target
is invoked or run it after the server
target is invoked.
You will
have to wait a few minutes for the Application Server to deploy the
service
endpoint correctly before building the client.
We appreciate your feedback, please send it to users@jax-rpc.dev.java.net.