Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
138 lines (109 sloc) 5.58 KB

jaxws-retail: A Retail JAX-WS Web Service

The jaxws-retail quickstart is a working example of a simple web service endpoint.

What is it?

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.

Server Log: Expected Warnings and Errors

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`

Access the Application

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.

Run the Client

  1. Make sure you Install the Quickstart Parent Artifact in Maven.

  2. Verify that the service is deployed properly.

  3. Open a terminal and navigate into the client directory of this quickstart.

    $ cd client/
  4. Type this command to run the client.

    $ mvn exec:java
  5. You should see the following output in the client console.

    Jay Boss's discount is 10.00

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.


When you import this project into {JBDSProductName}, you see 17 errors. These Java Problems are because these classes are not included in this project. Instead, they are defined in and generated from the {artifactId}-service/src/main/webapp/WEB-INF/wsdl/ProfileMgmtService.wsdl WSDL file. You can ignore these errors.

You will also see the following warning:

WS-I: A problem occured while running the WS-I WSDL conformance check: org.eclipse.wst.wsi.internal.analyzer.WSIAnalyzerException: The WS-I Test Assertion Document (TAD)document was either not found or could not be processed.The WSDLAnalyzer was unable to validate the given WSDL File.

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.

  1. To build the parent project, right-click on the {artifactId} project and choose Run As –> Maven install.

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

  3. 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
  4. 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.


You will see the following informational messages. This is because the source files for this JAR are not available in the Maven repository.

[INFO] The following files have NOT been resolved:
[INFO]    org.apache.ant:ant-launcher:jar:sources:1.7.0:provided
[INFO]    com.sun:tools:jar:sources:1.6:system
[INFO]    asm:asm:jar:sources:3.3.1:provided
You can’t perform that action at this time.