The jaxws-retail
quickstart is a working example of a simple web service endpoint.
The jaxws-retail
quickstart demonstrates the use of JAX-WS in {productNameFull} as a simple profile management application. It also demonstrates usage of wsconsume to generate classes from WSDL file.
You might see the following errors when using JDK 11, or if your Linux environment defines a BASH_FUNC_scl() function. You can ignore these errors.
[ERROR] /bin/sh: scl: line 1: syntax error: unexpected end of file
[ERROR] /bin/sh: error importing function definition for `BASH_FUNC_scl`
You can check that the Web Service is running and deployed correctly by accessing the following URL: http://localhost:8080/{artifactId}/ProfileMgmtService/ProfileMgmt?wsdl. This URL will display the deployed WSDL endpoint for the Web Service.
-
Make sure you Install the Quickstart Parent Artifact in Maven.
-
Verify that the service is deployed properly.
-
Open a terminal and navigate into the client directory of this quickstart.
$ cd client/
-
Type this command to run the client.
$ mvn exec:java
-
You should see the following output in the client console.
Jay Boss's discount is 10.00
../shared-doc/undeploy-the-quickstart.adoc ../shared-doc/run-the-quickstart-in-jboss-developer-studio.adoc
This quickstart is dependent on a WSDL file that is included in the {artifactId}-service
project, so it deploys and runs differently in {JBDSProductName} than the other quickstarts.
Note
|
When you import this project into {JBDSProductName}, you see 17 errors. These You will also see the following warning:
This is a known Eclipse issue. For more information, see Eclipse Bugzilla - Bug 535813. |
This quickstart requires that you build the parent project, deploy the service, and then run the client.
-
To build the parent project, right-click on the {artifactId} project and choose Run As –> Maven install.
-
To deploy the service:
-
Right-click on the {artifactId}-service project and choose Run As –> Maven install.
-
In the {artifactId}-service project, select the target/generated-sources/wsconsume folder and choose Build Path –> Use as Source Folder.
-
Right-click on the jaxws-retail-service project and choose Run As –> Run on Server.
-
Select the {productName} server and click Finish.
-
You should see the following message in the Console tab:
WFLYSRV0010: Deployed "{artifactId}-service.war"
-
You also see the "404 - Not Found" error in the application window. This is because there is no user interface for this quickstart. You can ignore this error.
-
-
To run the application:
-
To access the application, right-click on the {artifactId}-client project and choose Run As –> Java Application.
-
Choose the Client class and click OK.
-
Review the output in the console window. You should see the following message:
Jay Boss's discount is 10.00
-
-
To undeploy the project, right-click on the {artifactId}-service project and choose Run As –> Maven build. Enter
wildfly:undeploy
for the Goals and click Run.
Note
|
You will see the following informational messages. This is because the source files for this JAR are not available in the Maven repository.
|