README.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.

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:

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!"}
===============================================
  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.