Desarrollo de Servicios Web en Netbeans PDF
Desarrollo de Servicios Web en Netbeans PDF
Desarrollo de Servicios Web en Netbeans PDF
Proyecto de grado
Edicin 2009
Contenido
1. 2. 3. Objetivo ....................................................................................................................................... 3 Servicio Web ............................................................................................................................... 3 Cliente del Servicio Web ............................................................................................................ 5
1. Objetivo
El presente documento tiene como objetivo describir brevemente los pasos necesarios para construir servicios web utilizando la herramienta Netbeans 6.7. Se espera que sea de utilidad a los desarrolladores del Hospital de Clnicas, tanto a la hora de crear nuevos servicios web como crear clientes de los mismos.
2. Servicio Web
Para crear un ws primero hay que crear un proyecto web y luego new -> web-service indicando el nombre y el paquete donde se guardar el .java. Esto crea una carpeta llamada Web Service en donde aparece la definicin del ws, y en Source Packages encontramos el paquete que contiene el .java para el ws. Este .java se tiene que modificar para agregar las operaciones a exponer en el ws. El esqueleto de un ws es el siguiente:
package com.ws; import javax.jws.WebMethod; import javax.jws.WebParam; import javax.jws.WebService; @WebService() public class WSSumador { @WebMethod(operationName = "sumar", action = "sumar") public int sumar(@WebParam(name="a") int a, @WebParam(name="b") int b) { return a + b; } @WebMethod(operationName = "restar", action = "restar") public int restar(@WebParam(name="a") int a, @WebParam(name="b") int b) { return a - b; } /** Generado con el wizard **/ @WebMethod (operationName = "multiplicar") public int multiplicar (@WebParam(name="x") int a, @WebParam(name="b") int b) { return a * b; } }
La anotacin @Webservice() debe ponerse antes de declarar la clase. La anotacin @WebMethod debe anteceder a cada mtodo que queremos exponer, indicando el nombre del mtodo y la accin. En general estos dos campos tienen el mismo nombre. La anotacin @WebParam debe anteceder a cada parmetro de cada funcin que queremos exponer indicando el nombre con el que ser expuesto dicho parmetro. El nombre puede ser distinto al nombre de la variable, como sucede en el primer parmetro del mtodo multiplicar. Para agregar ms ws al proyecto se deben seguir los mismos pasos. En las propiedades del proyecto debemos indicar en qu servidor de aplicacin va a correr el ws (Tomcat, JBoss, etc) y de acuerdo a esto se genera un wsdl con el puerto en el que est disponible dicho servidor.
<body> <h1>Calculator Service</h1> <form name="Submit" action="ClientServlet"> <input type="text" name="value1" value="2" size="3"/>+ <input type="text" name="value2" value="2" size="3"/>= <input type="submit" value="Get Result" name="GetResult" /> </form> </body> Luego hay que agregar una referencia al ws que creamos anteriormente. Para ello, File -> new -> Web Service Client. Aqu indicamos en que proyecto se encuentra el ws, en este caso el ws est en el proyecto WebService. A continuacin aparecer en la carpeta Web Service References una nueva referencia a WSSumador. Resta consumir el ws desde el Servlet, cuyo cdigo es el siguiente:
package com.cliente; import import import import import import import import import import com.ws.WSSumador; com.ws.WSSumadorService; java.io.IOException; java.io.PrintWriter; javax.servlet.ServletException; javax.servlet.http.HttpServlet; javax.servlet.http.HttpServletRequest; javax.servlet.http.HttpServletResponse; javax.xml.rpc.soap.SOAPFaultException; javax.xml.ws.WebServiceRef;
public class ClientServlet extends HttpServlet { @WebServiceRef(wsdlLocation = "http://localhost:8080/WebService/WSSumador?wsdl") public WSSumadorService service; protected void processRequest(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
Con la anotacin @WebServiceRef obtenemos la informacin del wsdl. Luego creamos una variable de tipo WSSumadorService y luego invocamos el mtodo getWSSumadorPort() para obtener una instancia que contendr los mtodos definidos en el ws.