Building and Running JAX-RS Samples

Using Maven

Follow the steps given below before you build and run the sample.

1. Remove the following parent POM reference from the sample's pom.xml file, which is stored in the <PRODUCT_HOME>\samples\ directory.

   <parent> 
   	<groupId>org.wso2.appserver</groupId> 
   	<artifactId>wso2appserver-samples-parent</artifactId> 
   	<version>5.2.1</version> 
   </parent>

   Note that this step is necessary because of a known issue, which will be fixed in AS 6.0.0.

2. As shown below, add the <version> and <groupid> elements to the pom.xml file, after the parent element which you commented out in the first step.
   

   <groupId>org.wso2.appserver</groupId>
   <version>5.2.1</version>

To build and run the sample:

1. Open the maven  pom.xml file, which is in the base directory of the sample (i.e.,  <PRODUCT_HOME>\samples\Jaxws-Jaxrs\<JAX-WS-Sample-Folder> ). To determine  <JAX-RS-Sample>, see JAX-RS Sample Folder.

2. Build the demo and create a WAR file using the following command.
   

   mvn clean install

3. Start  the WSO2 Application Server by executing one of the following commands, where <PRODUCT_HOME> is the directory where you installed the product distribution:
   

   OS	Command
   On Windows	<PRODUCT_HOME>\bin\wso2server.bat --run
   On Linux/Solaris	sh <PRODUCT_HOME>/bin/wso2server.sh

4. Deploy the generated WAR file on WSO2 AS with the related logs on the console.

   mvn -Pdeploy

5. Run the client.

   mvn -Pclient

If you wish to remove the target directory, run the following command:

mvn clean

Using Apache Ant

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 (see JAX-RS Sample Folder).

   ant

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 will appear.

4. Click on the respective JAX-RS sample (e.g., jaxrs_starbucks_service).
   Execute one of the following commands to run the client:
   

   OS	Command
   On Windows	run-client.bat
   On Linux/Solaris	sh run-client.sh

    

5. Try the sample with different QoS options that appear on its dashboard. 

6. For different options, run:
   

   sh run-client.sh -help

    

JAX-RS Sample Folder