Java APIs for XML-based RPC 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-RPC 2.0.
This section explains the directory structure of the bundle:
docs | index.html, this file |
etc | Supporting files required by all the samples |
dispatch | Demonstrates how to dynamically invoke web service endpoints |
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 |
provider | Demonstrates how to build, deploy, and invoke javax.xml.rpc.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. |
Here is the list of prerequisites that needs to be met before any of the samples can be invoked:
AS_HOME/bin/asant install
from the root
directory of the JAX-RPC 2.0 EA bundle.Each sample can be built using the AS_HOME/bin/asant
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.