Last Modified: 05/04/05
The documentation for JAX-RPC 2.0 as well as the sample applications will be periodically updated in the JAX-RPC project on Java.net.
Please go to http://jax-rpc.dev.java.net for the latest documentation and samples.
Requires JDK 5.0 Update 2 or greater
Requires any one of the containers listed below (only if you intend to deploy Web service endpoints)
Supported
Sun Java System Application Server 8.1 UR1 (Application Server) or greater (instructions below)
Unsupported
Java Web Services Developer Pack 1.5 or greater (instructions here)
Tomcat 5.5.x (instructions here)
This release implements the JavaTMfor XML-based RPC 2.0 Specification.
JAXB 2.0 for XML schema binding
Annotations
WSDL customization
Improved handler framework
Provider interface
Dispatch
Asynchronous invocation
Once the JAX-RPC 2.0 EA bundle is extracted, it needs to be installed on the
Application Server. You need to invoke AS_HOME/bin/asant install
command from the root directory of the extracted bundle to install JAX-RPC 2.0
binaries on the Application Server, where AS_HOME
is the
installation directory of the Application Server. However this step is required
if you intend to build and deploy a Web service on the Application Server.
If you intend to only invoke an already existing Web service, then
alternatively you can use the wscompile
and wsdeploy
scripts in the bin
directory of the JAX-RPC 2.0 EA bundle. To use
these scripts, you need to set JAXRPC_HOME
to the root directory of
the JAX-RPC 2.0 EA extracted bundle.
Web Services Security is not supported in this Early Access release.
The client APIs for Dynamic Proxy and the Call are not supported in this Early Access release.
Use of the following API methods will cause a “not supported in JAXRPC 2.0 EA” exception to be thrown.
javax.xml.rpc.ServiceFactory
:
public Service createService(URL wsdlLocation, QName
serviceName) throws ServiceException;
javax.xml.Service
:
public Call[] getCalls(QName portName) throws
ServiceException;
public Call createCall(QName portName) throws
ServiceException;
public Call createCall(QName portName, QName operationName)
throws ServiceException;
public Call createCall(QName portName, String operationName)
throws ServiceException;
public Call createCall() throws ServiceException;
public java.rmi.Remote getPort(QName portName, Class
serviceEndpointInterface) throws ServiceException;
public java.rmi.Remote getPort(Class serviceEndpointInterface)
throws ServiceException;
public Iterator getPorts() throws ServiceException;
public java.net.URL getWSDLDocumentLocation();
public TypeMappingRegistry getTypeMappingRegistry();
public SecurityConfiguration
getSecurityConfiguration();
javax.xml.rpc.Call
:
All methods
TargetNamespace
and typeNamespaceBase
from
the jaxrpc-ri.xml
deployment descriptor are not used.
apt
, wscompile
, and wsdeploy
ant tasks, always set the fork
attribute to true
.
For white papers and the latest JAX-RPC technology and documentation, go to http://jax-rpc.dev.java.net.
Please use the JAXB 2.0 and JAXRPC 2.0 forum for feedback.
Copyright © 2005 Sun Microsystems, Inc. All rights reserved.