JAX-RPC 2.0 Early Access Samples Documentation

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.

1.0 Directory Structure

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.

2.0 Prerequisites

Here is the list of prerequisites that needs to be met before any of the samples can be invoked:

  1. Download Java 2 Standard Edition 5.0 Update 2 (J2SE 5.0 U2) from java.sun.com/j2se/1.5.0/download.jsp.
  2. Download Sun Java System Application Server Platform Edition 8.1 2005 Q1 UR1 (SJSAS PE 8.1 or Application Server) or later from java.sun.com/j2ee/1.4/download.html. SJSAS PE 8.1 download page has J2EE 1.4 SDK 2005Q1 UR1 available as All-In-One bundle and SJSJAS PE 8.1 available as separate bundle. Make sure that you download SJSAS PE 8.1 separate bundle only and use J2SE 5.0 U2 as the J2SE platform for it's installation. Although the download page requires J2SE 1.4.2 SDK for SJSAS PE 8.1, J2SE 5.0 U2 is required for JAX-RPC 2.0 binaries and must be used as the J2SE platform for SJSAS PE 8.1 for the samples to work.
  3. Invoke AS_HOME/bin/asant install from the root directory of the JAX-RPC 2.0 EA bundle.

3.0 Invoking the sample

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.