Building and Running JAX-RS Samples

Using Maven

Apache Maven 3 is recommended to build the samples.

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

Open the sample folder in your product pack using a command line and go to the <PRODUCT_HOME>\samples\Jaxws-Jaxrs\<JAX-RS-Sample-Folder> directory. The folders for Jax-rs samples are listed here: JAX-RS Sample Folder.
Build the demo and create a WAR file using the following command.
```
mvn clean install
```
Deploy the generated WAR file in WSO2 AS with the related logs on the console using the following command:
```
mvn -Pdeploy
```
This command will copy the WAR file to the <AS_HOME>/repository/deployment/server/webapps directory.
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
Log in to the management console and click List on the Main menu, under Manage/Applications. This opens the Running Applications page. The deployed applications will be listed here.
You can open the required web application by clicking the Find Services action.

If you want to remove the target directory, run the following command inside the <PRODUCT_HOME>\samples\Jaxrs-Jaxrs\<JAX-RS-Sample-Folder> directory:

mvn clean

Using Apache Ant

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

Open the sample folder in your product pack using a command line and go to the <PRODUCT_HOME>\samples\Jaxws-Jaxrs\<JAX-RS-Sample-Folder> directory. The folders for Jax-rs samples are listed here: JAX-RS Sample Folder.
To deploy the sample, run the following command:
```
ant
```
Start the Application Server and log in to the management console.
You can run the sample in two ways:
1. Log in to the management console. On the Main menu, under Manage/Applications, click List to open the Running Applications page. The deployed applications will be listed here.
2. Using the command line, go the JAX-RS sample directory and execute the following command:
  OS Command
  On Windows run-client.bat
  On Linux/Solaris sh run-client.sh
  The results of the sample will show on the command line.

For different options, run:

sh run-client.sh -help

JAX-RS Sample Folder

Sample	JAX-RS Sample Folder
JAX-RS Basics	jaxrs_basic
JAX-RS Advanced	jaxrs_starbucks_service
JAX-RS Sample on Content Negotiation	jaxrs_content_negotiation

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

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