JAX-WS Development With Eclipse - 7.3

Tomcat needs to be linked into the IDE so Eclipse can start and stop the servlet container as well as deploy web services to it. (See the Eclipse/Tomcat FAQ to learn more.) Download and extract the Tomcat binary into its own directory if you haven't already. Next, from the Eclipse Preferences window (Menu item Windows->Preferences), select the Server -> Runtime Environments section and add your Tomcat installation to the IDE:

Ensure that the JRE being used is an actual Java Development Kit (JDK), which Tomcat needs in order to compile JSPs and potentially other source files.

Similar to Tomcat, download the latest release version of Apache CXF and expand into a directory on your computer. Next, from Eclipse Preferences, open up the Web Services -> CXF 2.x Preferences section and enter the CXF directory as shown below.

Also, in the Web Services -> Server and Runtime category, make sure the Server and Web Service Runtimes are set to your version of Tomcat and CXF respectively.

We will next create a Eclipse dynamic web project to contain the web service provider and client. From the Eclipse File menu, Select New -> Dynamic Web Project (or New -> Other, and from the subsequent popup dialog Web -> Dynamic Web Project). Give the project any desired name ("WebServiceSample" is used below), make sure the proper Tomcat server is selected, and then press the Finish button as illustrated:

We'll start from a WSDL-first approach.

We'll now use Eclipse to create a Java-based web service client. Right-click WebServiceSample from the Project Explorer and select New -> Other, and from the New dialog Web Services -> Web Service Client. From the window that appears enter the WSDL file and raise the thumbwheel all the way up to "test", as shown below. Then select "Next" and enter another package name for the client (say "org.example.doubleit.client") so it does not conflict with the web service provider package. Click Finish.

Two modifications to the autogenerated client code will need to be made. First, in the org.example.doubleit.client.DoubleItService file, the wsdlLocation and url fields highlighted below will need to be updated to the actual endpoint URL Eclipse is using for the web service provider. You can find the value by looking at the wsdlLocation field in the DoubleItService class of the web service provider (it's also viewable in the Web Services Explorer test view).

@WebServiceClient(name = "DoubleItService", 
   wsdlLocation = "http://localhost:8080/WebServiceSample/" 
   + services/DoubleItPort?wsdl",
   targetNamespace = "http://www.example.org/DoubleIt") 
   public class DoubleItService extends Service {
    
      public final static URL WSDL_LOCATION;
      public final static QName SERVICE =
         new QName("http://www.example.org/DoubleIt", 
            "DoubleItService");
      public final static QName DoubleItPort = 
         new QName("http://www.example.org/DoubleIt", 
            "DoubleItPort");
    
      static {
         URL url = null;
         try {
            url = new URL(
               "http://localhost:8080/WebServiceSample/" + 
               "services/DoubleItPort?wsdl");
            } catch (MalformedURLException e) {
               System.err.println(
                  "Can not initialize the default wsdl from" 
                  + "http://localhost:8080/doubleit/services/doubleit?wsdl");
               // e.printStackTrace();
            }
            WSDL_LOCATION = url;
         }
...

Second, in the DoubleItPortType_DoubleItPort_Client class modify the value of the _doubleIt_numberToDouble constant to a number you wish to double (say "55") and then save your change. Then right-click the file in the Eclipse editor and select Run As -> Java Application. You should see the result of the web service call (110) in the Eclipse Console window:

INFO: Creating Service {http://www.example.org/DoubleIt}DoubleItService 
from WSDL: http://localhost:8080/WebServiceSample/services/DoubleItPort?wsdl
Invoking doubleIt...
doubleIt.result=110