README.adoc

../shared-doc/attributes.adoc

jaxws-ejb: An EJB JAX-WS Web Service

The jaxws-ejb quickstart is a working example of the web service endpoint created from an EJB.

What is it?

The jaxws-ejb quickstart demonstrates the use of JAX-WS in {productNameFull} as a simple EJB web service application.

../shared-doc/system-requirements.adoc ../shared-doc/use-of-jboss-home-name.adoc ../shared-doc/start-the-standalone-server.adoc ../shared-doc/install-quickstart-parent-artifact.adoc ../shared-doc/build-and-deploy-the-quickstart.adoc

Access the Application

You can check that the Web Service is running and deployed correctly by accessing the following URL: http://localhost:8080/jaxws-ejb-endpoint/EJB3Bean?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.

   EJB3Bean returning: ejbClient calling

../shared-doc/undeploy-the-quickstart.adoc ../shared-doc/run-the-quickstart-in-jboss-developer-studio.adoc

For this quickstart, follow the special instructions to Deploy and Undeploy a Quickstart Containing Server and Java Client Projects

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

2. To deploy the service:

   • Right-click on the {artifactId}-service subproject, and choose Run As –> Run on Server.

   • Choose the server and click Finish.

   • This starts the server and deploys the service to the server.

3. To access the application:

   • Right-click on the {artifactId}-client subproject and choose Run As –> Java Application.

   • Choose the Client class and click OK.

   • You should see the following message in the Console tab:

     EJB3Bean returning: ejbClient calling

4. To undeploy the project, right-click on the {artifactId} parent project and choose Run As –> Maven build. Enter wildfly:undeploy for the Goals and click Run.

../shared-doc/debug-the-application.adoc

Note

You will see the following informational messages. This is because the source files for these JARs are not available in the Maven repository. The jaxws-ejb-service source files are available in the jaxws-ejb project. [INFO] The following files have NOT been resolved: [INFO] xerces:xercesImpl:jar:sources:2.9.1:compile [INFO] com.wutka:dtdparser:jar:sources:1.21:compile [INFO] org.jboss.quickstarts.eap:jaxws-ejb-service:jar:sources:7.0.0.GA:compile