README.adoc

../shared-doc/attributes.adoc

resteasy-jaxrs-client: External JAX-RS Client

The resteasy-jaxrs-client quickstart demonstrates an external JAX-RS RestEasy client, which interacts with a JAX-RS Web service that uses CDI and JAX-RS.

What is it?

The resteasy-jaxrs-client quickstart demonstrates an external JAX-RS RestEasy client which interacts with a JAX-RS Web service that uses CDI and JAX-RS in {productNameFull}.

This client "calls" the HelloWorld JAX-RS Web Service that was created in the helloworld-rs quickstart. See the Prerequisite section below for details on how to build and deploy the helloworld-rs quickstart.

../shared-doc/system-requirements.adoc ../shared-doc/start-the-standalone-server.adoc

Prerequisites

Important

This quickstart depends on the deployment of the helloworld-rs quickstart for its test. Before running this quickstart, see the helloworld-rs README file for details on how to deploy it.

You can verify the deployment of the helloworld-rs quickstart by accessing the following content:

• The XML content can be viewed by accessing the following URL: http://localhost:8080/helloworld-rs/rest/xml

• The JSON content can be viewed by accessing this URL: http://localhost:8080/helloworld-rs/rest/json

Run the Client

1. Start the {productName} server with the standalone default profile as described above.

2. Make sure the helloworld-rs quickstart has been deployed on the server as noted in the Prerequisites section above.

3. Open a terminal and navigate to the root directory of this quickstart.

4. Type the following command to run the client:

   $ mvn clean package exec:java

Investigate the Console Output

This command will compile the example and execute a test to make two separate requests to the Web Service. Towards the end of the Maven build output, you should see the following if the execution is successful:

===============================================
URL: http://localhost:8080/helloworld-rs/rest/xml
MediaType: application/xml

*** Response from Server ***

<xml><result>Hello World!</result></xml>

===============================================
===============================================
URL: http://localhost:8080/helloworld-rs/rest/json
MediaType: application/json

*** Response from Server ***

{"result":"Hello World!"}
===============================================

../shared-doc/run-the-quickstart-in-jboss-developer-studio.adoc

1. Before you run this quickstart, make sure you import, deploy, and test the helloworld-rs quickstart as described in the Prerequisites section of this file.

2. Import this quickstart into {JBDSProductName}.

3. Build and run the quickstart project.

   • Right-click on the {artifactId} project and choose Run As –> Maven build.

   • Enter clean package exec:java for the Goals and click Run.

   • The client output displays in the Console window.

4. To undeploy the helloworld-rs quickstart, right-click on the helloworld-rs project and choose Run As –> Maven build. Enter wildfly:undeploy for the Goals and click Run.