Desarrollo de Servicios Web con JBuilder

Transcripción

1 Artículos técnicos Grupo Danysoft: Desarrollo de Servicios Web con JBuilder Segunda parte Oscar Cristobal Ruiz Departamento Java Equipo Grupo Danysoft Enero (902)

2 Desarrollo de Servicios Web con JBuilder Este artículo es la segunda entrega de una serie de dos documentos sobre el desarrollo de Servicios Web con JBuilder. Los Servicios Web han aparecido en el panorama de las tecnologías de la información como una nueva alternativa al problema de la programación distribuida. Nos proporcionan la posibilidad de acceder a una serie de servicios que se encuentran en un equipo remoto. La primera entrega mostraba cómo consumir un Servicio Web remoto, en este caso, el servicio se llamaba BabelFish, y nos ofrecía la funcionalidad de traducción. Puede obtener el artículo en la web seleccionando la opción Boletines. En esta segunda entrega, vamos a crear un sencillo Servicio Web que proporcionará información de los productos de una empresa virtual. Tiene un parámetro de entrada, el numero de referencia de un producto, y un parámetro devuelto, el precio del mismo. El presente artículo mostrará cómo usar JBuilder para publicar el Servicio Web, y cómo consumirlo. Servicios Web y JBuilder de Borland Web Services Kit for Java es un paquete que ofrece varias utilidades que le permiten hacer aplicaciones completas con servicios web desde JBuilder, tanto consumirlos como crearlos. Web Services Kit for Java está directamente incluido en JBuilder 8, y se ofrece como paquete adicional para versiones anteriores en el sitio Puede descargarlo de forma gratuita. Su integración con JBuilder es absoluta y automática tras su instalación. Nuestro Servicio Web Vamos a crear un Servicio Web muy sencillo. No pretendo llevar al extremo las posibilidades de los Servicios Web, sino mostrar las herramientas que Borland le proporciona para crear y consumir Servicios Web, además de exponerle el potencial que los Servicios Web le ponen a su alcance. En primer lugar crearé una aplicación muy sencilla. Esta aplicación accederá de forma local a una base de datos muy simple, con una tabla de dos columnas: número de referencia de un producto, y precio en euros. Crearé un método que permita obtener el precio de un producto a partir de su número de referencia. En ese punto, será donde comience a usar el Web Services Kit for Java. Crearé el servidor de Servicios Web, y publicaré el método anterior como servicio disponible. Por último, desarrollaré un cliente muy sencillo que utilice el anterior Servicio web. Creación de la Aplicación La siguiente pantalla muestra el Explorador de Bases de Datos de JBuilder, accesible desde el menú Herramientas Explorador de bases de datos. Se trata de una herramienta que permite navegar por las tablas de una base de datos. En la figura

3 aparece la única tabla, llamada PRODUCTOS, de una base de datos Interbase. La tabla contiene algunos registros de productos, relacionando número de referencia con precio en euros. Bien, esa es la base de datos contra la que realizaremos las consultas. A continuación, voy a crear una nueva clase, que incluirá el método de consulta a la base de datos. Para ello uso el Asistente para clases, y creo una nueva clase vacía, llamada Consulta. Ahora crearé un método que admite como parámetro una referencia, y devuelve en un int el precio del producto. Para acceder a Interbase, voy a utilizar los componentes DataExpress, incluidos en JBuilder Enterprise. DataExpress nos proporciona componentes que nos facilitan la conexión y realización de consultas a base de datos. Estos componentes presentan ciertas ventajas respecto al uso de los APIs estándar de Sun, ya que pueden configurarse visualmente desde el diseñador gráfico de JBuilder como cualquier otra JavaBean. En este caso, no me voy a detener en la creación de la aplicación de acceso a base de datos. Voy a mostrarles directamente el listado completo del fichero Consulta.java. Se trata de una clase que tiene un método que realiza una consulta a la base de datos. Muestro el código por si alguien quiere desarrollar la aplicación a la vez que lee el artículo, pero lo interesante vendrá a continuación, cuando les muestre cómo exponer una clase como Servicio Web.

4 package serviciosweb2; import com.borland.dx.sql.dataset.*; public class Consulta { public int obtenerprecio(string referencia){ Database database1 = new Database(); QueryDataSet querydataset1 = new QueryDataSet(); int precio = 0; if (referencia == null) return 0; querydataset1.setquery(new com.borland.dx.sql.dataset.querydescriptor(database1, "SELECT PRODUCTOS.PRECIO FROM PRODUCTOS WHERE PRODUCTOS.REFERENCIA='" + referencia + "'", null, true, Load.ALL)); database1.setconnection(new com.borland.dx.sql.dataset. ConnectionDescriptor("jdbc:interbase://localhost/C:\\ " + "Documentos\\Articulos\\ServiciosWeb\\PRODUCTOS.gds","SYSDBA", "masterkey", false, "interbase.interclient.driver")); querydataset1.open(); precio = querydataset1.getint("precio"); querydataset1.close(); database1.closeconnection(); return precio; Bien, hasta aquí sólo hemos creado una aplicación. Pasemos a lo interesante: su publicación como Servicio Web. Publicación de un método como Servicio Web En el primer artículo usamos uno de los asistentes disponibles en el Web Services Kit for Java. El asistente Import WSDL nos creaba las clases necesarias para acceder a un Servicio Web ya existente. En este segundo artículo, vamos a utilizar los otros dos. En primer lugar, usaremos el asistente Export Class as a Web Service. Puede

5 acceder a este asistente desde el menú Archivo Nuevo Web Services, pero es preferible hacer clic con el botón derecho del ratón sobre Consulta.java en el panel de proyecto, ya que de ese modo estamos indicando directamente la clase que queremos exponer como Servicio Web. El asistente tiene una gran cantidad de campos y opciones, pero en este caso podemos pulsar directamente en Finalizar. Quizá sea interesante el segundo paso, en el que JBuilder nos permite indicar los métodos de la clase que deseamos publicar. Por defecto se publican todos los métodos de la clase, en este caso, únicamente nuestro método obtenerprecio. JBuilder creará automáticamente el documento WSDL que define nuestro Servicio Web. También crea clases que permiten acceder al Servicio Web, incluido un TestCase que nos permitirá testear nuestro servicio con el marco JUnit. JUnit es un marco de trabajo que nos permite testear aplicaciones Java. Puede encontrar más información en Para terminar, debemos crear la aplicación web que servirá el Servicio Web. En este caso, vamos a usar como Servidor Web a Tomcat 4.0, incluido en JBuilder. Seleccione en el menú Archivo Nuevo Web Services, y lance el asistente SOAP Server. En este caso, la primera pantalla del asistente es de vital importancia. En ella, se nos permite indicar el nombre del nodo web que identificará en JBuilder a la aplicación web, así como el directorio en el que guardaremos los ficheros que lo compongan. Deben coincidir con la dirección SOAP especificada en el fichero WSDL. Por defecto, el anterior asistente creó la URL: De modo que se debe configurar la página como muestra la siguiente figura. Presione Aceptar, y a continuación Terminar. Este asistente añadirá el nodo axis en el panel de proyecto. Esta aplicación web es la que sirve nuestro Servicio Web. Ya hemos terminado de crearlo. A continuación, vamos a ejecutar el TestCase para ver si todo fue correcto. Seleccione en primer lugar el fichero index.html dentro del nodo axis, y haciendo clic con el botón derecho del ratón, seleccione Ejecutar Web. De este modo se lanza el

6 servidor Tomcat 4.0, con nuestra aplicación web. Ya hemos lanzado el servidor web, ahora vamos a ejecutar el test. Para ello, haga clic con el botón derecho del ratón sobre el fichero ConsultaServiceTestCase.java, y seleccione en el menú pop-up la opción Ejecutar Test utilizando valores por defecto. De este modo ejecutamos el test, y debería obtener una pantalla similar a la siguiente. En la parte inferior, puede verificar que el test tuvo éxito. Creación de un IU que consuma el Servicio Web Para terminar, crearé un interfaz de usuario que permita consumir el servicio web. En la siguiente figura, le muestro el interfaz que yo utilicé. Acompaño la figura con el panel de estructura, como ayuda por si estuviese intentando recrear la aplicación completa.

7 No entraré en mayor detalle sobre el interfaz. Lo realmente interesante está en el código que recoge el suceso de presionar el botón Consultar. Aquí lo tiene. void jbutton1_actionperformed(actionevent e) { try { serviciosweb2_generated.consultaserviceporttype binding; binding = new serviciosweb2_generated. ConsultaServiceLocator().getConsultaServicePort(); String referencia = "ref-" + jtextfield1.gettext(); int precio = binding.obtenerprecio(referencia); jlabel3.settext("producto: " + referencia); jlabel4.settext("precio: " + precio); catch (ServiceException ex) { catch (RemoteException ex) { Lo único que hace el método es consumir el servicio web, obteniendo la referencia a buscar del campo de texto del interfaz, y mostrando el resultado por pantalla, en el panel inferior. Para terminar, la siguiente figura muestra la aplicación final en ejecución. Si desea más información, formación o adquirir JBuilder, no dude en contactar con el equipo Danysoft en info@danysoft.com o en el tfno (si llama desde españa) o en el (si llama desde fuera).