Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introducing the Sample

This sample demonstrates how to build and call a Web service using a given WSDL file. This approach is also called contract-first.

Info

For more information on contact-first Web services, refer to: http://cxf.apache.org/docs/defining-contract-first-webservices-wi th-wsdl-generation-from-java.html

...

The main client code lives in the class CustomerServiceTester, which needs a proxy to the service and demonstrates some calls and their expected outcome using junit assertions.

The first call is a request getCustomersByName for all customers with name "Smith" and the result is checked. Then, the same method is called with the invalid name "None". In this case a NoSuchCustomerException is expected. The third call shows that the one way method updateCustomer will return instantly even if the service needs some time to process the request.

The classes CustomerServiceClient and CustomerServiceSpringClient show how to get a service proxy using JAX-WS and how to wire it to your business class (in this case, CustomerServiceTester).

Building and

...

running the

...

Using Maven

1. Install and run the WSO2 Application Server. Refer to the Installing Features for instructions. 

...

sample

This sample can be found at <AS_HOME>\samples\Jaxws-Jaxrs\wsdl_first_jaxws) , the maven pom.xml file can be used to build and run the sample using either UNIX or Windows.

3. To build the sample and create a WAR file, run mvn clean install command.

4. Start the Application Server (run bin/wso2server.sh/.bat).

  • mvn -Pdeploy (deploys the generated WAR file on WSO2 AS with related logs on the console)
  • mvn -Pclient (runs the client)

Using Apache Ant  

1. Run "ant" on  <CARBON_HOME>\samples\Jaxws-Jaxrs\ wsdl_first_jaxws directory to deploy the " wsdl_first_jaxws" service on the server.

2. Start the application server and access its Management Console at https://localhost:9443/carbon.

3. Go to "Services -> List" menu to find the "wsdl_first_jaxws" service listed on the "Deployed Services" window.

4. Execute "sh run-client.sh" or "run-client.bat" to run the client

For information on building and running the sample, see Building and Running the JAX-WS Samples.

Info
  1. If you have a EPR location other than http://localhost:9763/java_first_jaxws/services/hello_world, edit the run-client script.
  2. Prior to running the client, it is recommended to confirm that the generated WSDL (http://{ip}:{port}/java_first_jaxws/services/hello_world?wsdl) can be seen from a web browser.

...