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 WildFly Application Server.
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 WildFly Application Server 12 or later.
All you need to build this project is Java 8.0 (Java SDK 1.8) or later and Maven 3.3.1 or later. See Configure Maven to Build and Deploy the Quickstarts to make sure you are configured correctly for testing the quickstarts.
Start the WildFly Standalone Server
-
Open a terminal and navigate to the root of the WildFly directory.
-
Start the WildFly server with the default profile by typing the following command.
$ WILDFLY_HOME/bin/standalone.sh
NoteFor Windows, use the WILDFLY_HOME\bin\standalone.bat
script.
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
-
Start the WildFly server with the standalone default profile as described above.
-
Make sure the
helloworld-rs
quickstart has been deployed on the server as noted in the Prerequisites section above. -
Open a terminal and navigate to the root directory of this quickstart.
-
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!"}
===============================================
Run the Quickstart in Red Hat JBoss Developer Studio or Eclipse
You can also start the server and deploy the quickstarts or run the Arquillian tests in Red Hat JBoss Developer Studio or from Eclipse using JBoss tools. For general information about how to import a quickstart, add a WildFly server, and build and deploy a quickstart, see Use JBoss Developer Studio or Eclipse to Run the Quickstarts.
-
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. -
Import this quickstart into JBoss Developer Studio.
-
Build and run the quickstart project.
-
Right-click on the resteasy-jaxrs-client 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.
-
-
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.