Red Hat

Developer Materials

External JAX-RS Client

  • Author:
  • Contributors: Sande Gilda, Pete Muir
  • Last Update: Nov 17, 2013
  • Level: Intermediate
  • Technologies: JAX-RS
  • Target Product: EAP

What is it?

This example demonstrates an external JAX-RS RestEasy client which interacts with a JAX-RS Web service that uses CDI 1.0 and JAX-RS in Red Hat JBoss Enterprise Application Platform.

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.

System requirements

The application this project produces is designed to be run on Red Hat JBoss Enterprise Application Platform 6.1 or later.

All you need to build this project is Java 6.0 (Java SDK 1.6) or later, Maven 3.0 or later.

Configure Maven

If you have not yet done so, you must Configure Maven before testing the quickstarts.

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 Arquillian Tests

This quickstart provides Arquillian tests.

NOTE: The following commands assume you have configured your Maven user settings. If you have not, you must include Maven setting arguments on the command line. See Run the Arquillian Tests for complete instructions and additional options.

  1. Make sure you have started the JBoss Server 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 command line and navigate to the root directory of this quickstart.
  4. Type the following command to run the test goal with the following profile activated:

     mvn clean test 
    

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/jboss-helloworld-rs/rest/xml
    MediaType: application/xml

    *** Response from Server ***

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

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

    *** Response from Server ***

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

OpenShift

To make this quickstart more interesting, deploy the RESTful service to OpenShift. The following instructions will guide you as to the modifications that must be made to successfully execute the jax-rs-client against a service deployed to OpenShift.

Build and Deploy the Quickstart - to OpenShift

IMPORTANT: This quickstart depends on the deployment of the helloworld-rs quickstart to OpenShift for its test. Follow the instructions Build and Deploy the Quickstart - to OpenShift in the helloworld-rs README to deploy that application to OpenShift. Do NOT yet follow the step "Delete the OpenShift Application".

As it says in the helloworld-rs instructions, you can verify the deployment of the helloworld-rs quickstart by accessing the following content. Be sure to replace the YOUR_DOMAIN_NAME in the URL with your domain name.

Modify the jax-rs-client quickstart pom.xml

Now that you have deployed the application, it is time to make changes to the jax-rs-client quickstart Arquillian tests.

  1. Open a shell command prompt and navigate to the QUICKSTART_HOME/jax-rs-client/ directory.
  2. Make a backup copy of the pom.xml file.
  3. Open the pom.xml file in an editor and modify the xmlUrl and jsonUrl property values as follows. Be sure to replace the YOUR_DOMAIN_NAME in the URL with your OpenShift domain name.

     <property>
         <name>xmlUrl</name>
         <value>http://helloworldrs-YOUR_DOMAIN_NAME.rhcloud.com/rest/xml</value>
     </property>
     <property>
         <name>jsonUrl</name>
         <value>http://helloworldrs-YOUR_DOMAIN_NAME.rhcloud.com/rest/json</value>
     </property>
    

Run the Maven test

Type the following command to run the jax-rs-client:

    mvn test

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://helloworldrs-YOUR_DOMAIN_NAME.rhcloud.com/rest/xml
    MediaType: application/xml

    *** Response from Server ***

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

    ===============================================
    ===============================================
    URL: http://helloworldrs-YOUR_DOMAIN_NAME.rhcloud.com/rest/json
    MediaType: application/json

    *** Response from Server ***

    {"result":"Hello World!"}

    ===============================================

When you are finished testing, restore the pom.xml file to the previous version if you want to test locally.

Delete the OpenShift Application

When you are finished with the application you can delete it from OpenShift as follows:

    rhc app-delete -a helloworldrs

Note: There is a limit to the number of applications you can deploy concurrently to OpenShift. If the rhc app create command returns an error indicating you have reached that limit, you must delete an existing application before you continue.

  • To view the list of your OpenShift applications, type: rhc domain show
  • To delete an application from OpenShift, type the following, substituting the application name you want to delete: rhc app-delete -a APPLICATION_NAME_TO_DELETE

Recent Changelog

  • Nov 17, 2013(Sande Gilda):Bz1029445 Update OpenShift instructions to be more current with latest version
  • Nov 13, 2013(Sande Gilda):Revert Bz1029445 Remove OpenShift instructions from README files as they do not currently work
  • Nov 13, 2013(Sande Gilda):Bz1029445 Remove OpenShift instructions from README files as they do not currently work
  • Nov 8, 2013(Sande Gilda):Bz1028448 Add spaces to end of metadata so it renders with a line break in HTML
  • Oct 7, 2013(Sande Gilda):Merge from master to 6.2.x for ER5
  • Sep 24, 2013(Sande Gilda):Remove references to JBoss AS 7 from the quickstarts
  • Sep 23, 2013(Sande Gilda):Update metadata source URLs to new repository
  • Sep 13, 2013(Sande Gilda):JDF 487 Remove as from quickstart artifactId and archive names and access URLs in README files
  • Jun 12, 2013(Sande Gilda):Modify README file internal links to use generated anchors. Remove hard coded anchors. Fixed obsolete links and other markdown rendering problems
  • Feb 12, 2013(Sande Gilda):Add quickstart source repository of record to the README files
Avg:
Your Rating: