Milan's blog

J2SE Web Services

To create a web service you don't need to have an Application server (or Web server) installed. This is an illustration how the simple web service can be created in Netbeans5.5 Java Project. I was inspired by a Robert Eckstein and Rajiv Mordani's article about JAX-WS 2.0 With the Java SE 6 Platform and Petr Blaha's blog: Developing Web services for Mustang in Netbeans.

Now in Netbeans5.5 there is a JAX-WS 2.0 technology integrated, which enables you to create and consume web services in Netbeans projects. What is actually supported is : 

1. Web Service creation in Web application and EJB Project 
2. Web Service consumption (WS Client) in Web Application, EJB Project, Enterprise Client Application and raw Java Application.

What's is not supported yet is Web Service Creation in raw Java Application (J2SE Project). 
This is a simple workaround how simply this feature can be achieved in Netbeans5.5.

Steps to create RPC/literal Web Service in Java Application.

1. Start Netbeans5.5, create a new Java Application project and name it GeometricalWS. 
2. In Project Customizer add JAX-WS2.0 Library (this step is necessary only if you run Netbeans IDE on JDK1.5 platform) :
   
3. Create a simple Java class and name it CircleFunctions. Also specify the Package Name for the class: geometricalws
4. Using the @WebService annotation we'll convert this java class to a simple web service. Copy the following code into the editor window:
   

   package geometricalws;
   
   import javax.jws.WebMethod;
   import javax.jws.WebParam;
   import javax.jws.WebService;
   import javax.jws.soap.SOAPBinding;
   
   @WebService(name="Circle", serviceName="CircleService", portName="CirclePort")
   @SOAPBinding(style=SOAPBinding.Style.RPC)
   public class CircleFunctions {
       
      @WebMethod(operationName="area")
      public double getArea(@WebParam(name="r")double r) {
          return java.lang.Math.PI * (r * r);
      }
   
      @WebMethod(operationName="circumference")
      public double getCircumference(@WebParam(name="r")double r) {
           return 2 * java.lang.Math.PI * r;
      }
   }
   

   (Notice that except of @WebService annotation, @WebMethod and @WebParam annotations are used to annotate web service operations and their parameters.
   These annotations influence the way how WSDL file is created from this class)
5. Using the javax.xml.ws.Endpoint:publish method the web service can be deployed to a simple web server provided by jax-ws runtime. Modify the Main class in the following way:
   

   package geometricalws;
   
   import javax.xml.ws.Endpoint;
   
   public class Main {
   
       public static void main(String[] args) {
           String wsAddress = "http://localhost:8765/GeometricalWS/CircleFunctions";
           Endpoint.publish(
               wsAddress,
               new CircleFunctions());
           System.out.println("Web service was published successfuly.\n"+
               "WSDL URL: "+wsAddress+"?WSDL");
           
           // this is the way to make the local web server running until the process is killed
           while (true) {
               try {
                   Thread.sleep(2000);
               } catch (InterruptedException ex) {}
           }
       }   
   }

   (see that the URL address for web service and an instance of CircleFunction class should be specified in publish method)
6. Run the application (using Run Project action on the project node). The message in output window notifies you that web service was published successfuly:
   
   Web service was published successfuly.
   WSDL URL: http://localhost:8765/GeometricalWS/CircleFunctions?WSDL
   
   
7. To ensure the web service was really published open your browser and type the URL of web service description file (wsdl file) to the url text field: http://localhost:8765/GeometricalWS/CircleFunctions?WSDL The wsdl file should appear in browser window.

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soapenv:Body>
    <ans:area xmlns:ans="http://x/">
      <r>10.0</r>
    </ans:area>
  </soapenv:Body>
</soapenv:Envelope>

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soapenv:Body>
    <ans:areaResponse xmlns:ans="http://x/">
      <return>314.1592653589793</return>
    </ans:areaResponse>
  </soapenv:Body>
</soapenv:Envelope>

Steps to create a Client:

1. Create another Java Application project and name it ClientProject. 
2. Create new Web Service client ant type the url of wsdl file to WSDL URL text field, set the package name for the client artifacts (java classes that will be generated from the wsdl):
    
   Press <Finish> button. The Web Service Reference node: CircleFunctions should be created.
   
3. Open Main.java in editor and Drag&Drop the "area" operation node from the ProjectsView to editor. A piece of code should be generated inside the main method.
   Then, set the value for WS operation argument (r). See the picture:
   
   
   
4. Run the Project. The following message should apear in Output Window :
   Result = 314.1592653589793

Posted at 01:30PM Oct 08, 2006 by Milan Kuchtiak in NetBeans  |  Comments[26]