This documentation is for WSO2 Application Server 5.2.0. View documentation for the latest release.
Page Comparison - Building and Running JAX-WS Samples (v.14 vs v.15) - Application Server 5.2.0 - WSO2 Documentation

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Table of Contents

Using Maven


Apache Maven 3 is recommended to build the samples.

From the base directory of the sample (<PRODUCT_HOME>\samples\Jaxws-Jaxrs\<JAX-WS-Sample-Folder>), the maven pom.xml file can be used to build and run the demo. To determine <JAX-WS-Sample>, see JAX-WS Sample Folder.

Using either UNIX or Windows:

  1. Build the demo and create a WAR file.

    Code Block
    mvn clean install ()
  2. Start the WSO2 Application Server by executing one of the following commands, where  <PRODUCT_HOME> is the directory where you installed the product distribution:

    On Windows
    <PRODUCT_HOME>\bin\wso2server.bat --run
    On Linux/Solaris
    sh <PRODUCT_HOME>/bin/            
  3. Deploy the generated WAR file on WSO2 AS with the related logs on the console.

    Code Block
    mvn -Pdeploy
  4. Run the client

    Code Block
    mvn -Pclient

If you wish to remove the target directory:

Code Block
run mvn clean

Using Apache Ant


You need Apache Ant 1.6.2 or higher  to build the samples.


  1. To deploy the sample  service on the server run the following command, from the  <PRODUCT_HOME>\samples\Jaxws-Jaxrs\<JAX-RS-Sample-Folder> directory. To determine <JAX-WS-Sample>, see JAX-WS Sample Folder.

    Code Block
  2. Start the application server and access its Management Console at https://localhost:9443/carbon.
  3. On the Main menu, under Services, click List.
    The Deployed Services window will appear.
  4. Click on the respective JAX-RS sample (e.g., async_jaxws).
  5. Execute one of the following commands to run the client:

    On Windows
    On Linux/Solaris


  6. Try the sample with different QoS options that appear on its dashboard. 
  7. For different options run:

    Code Block
    sh -help


JAX-WS Sample Folder
SampleJAX-WS Sample Folder

Asynchronous Invocation


Build and Invoke a Service Using a WSDL


Develop Services in Code-First Approach


JAX-WS Handlers


MTOM Sample for SWA and XOP


WS-Security Sample on Signature and Encryption

sign_encrypt _jaxws

WS-Security Sample on UsernameToken and Timestamp