blob: 1ebf4db007e5f591e6fe8ad9c3e58f108f752854 [file] [log] [blame]
Sample: JAX-WS top-down development
===================================
Introduction
============
This sample demonstrates top-down development (i.e. development starting with a WSDL document) of a service and client using the JAX-WS API. The sample is based on an interop scenario for base data types which may be found at http://mssoapinterop.org/ilab/ .
Building the service from scratch
=================================
The service may be constructed from scratch by executing the wsimport tool (found in the Sun JAX-WS RI) on the BaseDataTypesDocLibB.wsdl file: 'wsimport -keep -verbose BaseDataTypesDocLibB.wsdl' (The -keep option tells the tool to keep the generated files and the -verbose option causes the tool to list what is generated.) After the files have been generated you will need to provide an implementation of the service (i.e. a class equivalent to TopDownSampleService.java).
Deploying the service
=====================
The classes can be packaged into a jar and the jar can be dropped into the servicejars directory of a deployed axis2 server.
Building the client from scratch
================================
The dynamic proxy client may be constructed from scratch by executing the wsimport tool (found in the Sun JAX-WS RI) on the BaseDataTypesDocLibB.wsdl file: 'wsimport -keep -verbose BaseDataTypesDocLibB.wsdl' (The -keep option tells the tool to keep the generated files and the -verbose option causes the tool to list what is generated.) After the files have been generated you will need to provide an implementation of the client (i.e. a class equivalent to TopDownSampleClient.java).
Running the Client
==================
The client can be run via the axis2.sh or axis2.bat scripts (e.g. 'axis2.sh org.apache.axis2.jaxws.interop.InteropSampleClient'.) The endpoint URL is extracted at runtime from the WSDL, so you can either modify the soap:address to refer to Microsoft's endpoint at http://131.107.72.15/SoapWsdl_BaseDataTypes_XmlFormatter_Service_Indigo/BaseDataTypesDocLitB.svc or to a local endpoint such as http://localhost:8080/axis2/services/TopDownSampleServiceService.IBaseDataTypesDocLitBPort