blob: c90ca4c45c00c63b769f451e5733d857dcce9ac9 [file] [log] [blame]
Java First demo using jax-ws APIs and jsr-181
=============================================
This demo illustrates how to develop a service use the "code first"
approach using the JAX-WS APIs.
Building and running the demo using Maven
---------------------------------------
From the base directory of this sample (i.e., where this README file is
located), the pom.xml file is used to build and run the demo.
Using either UNIX or Windows:
mvn clean install (builds the demo and creates a WAR file for optional Tomcat deployment)
mvn -Pserver (from one command line window -- only if using a non-WAR standalone service)
mvn -Pclient (from a second command line window)
To remove the code generated from the WSDL file and the .class
files, run "mvn clean".
Alternative: WAR deployment of service to Tomcat (either embedded or standalone)
---------------------------------------------------------------------------
1.) Update the endpointAddress value in the client.Client class to the WAR-hosted
value, for running this sample on your local machine most likely:
"http://localhost:8080/java_first_jaxws/services/hello_world".
2.) Standalone Tomcat: Manually copy the generated WAR file to the Tomcat webapps folder,
or, if you have Maven and Tomcat set up to use the Tomcat Maven Plugin
(http://tomcat.apache.org/maven-plugin-2.2/tomcat7-maven-plugin/index.html) you can
use the mvn tomcat7:redeploy command instead.
For embedded Tomcat 7: Just run mvn tomcat7:run-war from the project base folder.
For embedded Tomcat 8: Just run mvn cargo:run from the project base folder.
Prior to running the client (mvn -Pclient) it would be good to confirm the
generated WSDL can be seen from a web browser at:
http://localhost:8080/java_first_jaxws/services/hello_world?wsdl