Tutorial JBuilder 7 Entreprise JavaBeans

Transcripción

1 Tutoriales Grupo Danysoft: Tutorial JBuilder 7 Entreprise JavaBeans Equipo Grupo Danysoft septiembre de (+34)

2 Este documento se ha realizado utilizando Doc-To-Help, distribuido en España por : Danysoft Internacional - Avda de España Alcobendas Madrid Tfno Fax danysoft@danysoft.com

3 Sumario Enterprise JavaBeans 5 Desarrollo, despliegue y testeo de una Stateful Session EJB Configuraciones iniciales...5 Creación de la EJB...6 Despliegue en servidor de aplicaciones...8 Desarrollo de un cliente de testeo...10 Resumen...12 Tutoriales Danysoft 13 Qué es un tutorial?...13 Cursos de formación a la carta...13 Tutoriales a distancia...13 Tutoriales sobre demanda...13 Tutoriales JBuilder 7 14 General JBuilder Aplicaciones de acceso a base de datos Enterprise JavaBeans...14 JavaBeans...14 Aplicaciones Web...15 Aplicaciones distribuidas...15 Servicios Web...15 Creación de interfases gráficas...15 Sumario : iii

4

5 Enterprise JavaBeans Desarrollo, despliegue y testeo de una Stateful Session EJB 2.0 JBuilder 7 permite el fácil desarrollo de Enterprise JavaBeans. Provee soporte para especificaciones 1.x y 2.0. Para las especificaciones 1.x, se dispone de diversos asistentes que permiten la generación del código básico a partir del cual desarrollar nuestras propias EJBs, así como del JBuilder JavaBeans Express, herramienta visual que permite el control de aspectos básicos de JavaBeans. Para el caso de creación de EJBs siguiendo la especificación 2.0, JBuilder 7 proporciona un potente diseñador visual two-way, de modo que cualquier cambio en el diseñador se verá inmediatamente reflejado en el código generado, y viceversa. El presente tutorial muestra la creación de una Stateful Session EJB 2.0, su despliegue en un servidor de aplicaciones mediante el uso del asistente Enterprise Deployment, y testeo mediante la creación de un cliente usando el asistente incluido en JBuilder 7. La EJB que se va a desarrollar dispondrá únicamente de un campo de tipo String, getters y setters del mismo, y un ejbcreate adicional. Configuraciones iniciales Comencemos creando un nuevo proyecto. Para ello, seleccionar el menú File New Project. Rellenar el campo Name con el nombre StatefulSessionBeanProy.jpx, y presionar el botón Finish para aceptar el resto de opciones por defecto. Antes de comenzar a desarrollar nuestra aplicación, debemos configurar en JBuilder el servidor de aplicaciones al que queremos desplegar nuestra EJB. Esto es necesario como primer paso, ya que JBuilder generará posteriormente y de forma automática los descriptores de despliegue necesarios para la EJB, y estos pueden ser distintos dependiendo del servidor de aplicaciones de destino. Nota: Para configurar un servidor de aplicaciones en JBuilder, es necesario tenerlo instalado previamente. En el presente tutorial, se va a usar el Borland Enterprise Server AppServer Edition , que viene incluido en el paquete del JBuilder 7 Enterprise. En el caso que usted trabaje con otro servidor de aplicaciones, configurelo en JBuilder de forma análoga. El resto del tutorial es prácticamente independiente del servidor de aplicaciones seleccionado anteriormente. Existen pequeñas diferencias que se notificarán en el punto en el que aparezcan. Comencemos con la configuración del servidor. Para ello, seleccionar el menú Tools Configure Servers. En el diálogo que aparece, seleccionar el servidor de aplicaciones que usted desee. En nuestro caso, seleccionamos Borland Enterprise Server AppServer Edition Activar Enable Server y pulsar Ok. De este modo podemos usar este servidor de aplicaciones. A continuación, deseamos definirlo como servidor por defecto para nuestros proyectos. Para ello, seleccionar el menú Project Default Project Properties, y pulsar en la pestaña Server. JBuilder permite definir un único servidor de aplicaciones para todo tipo de aplicaciones, o bien diversos servidores de aplicaciones para distintos servicios. Por ejemplo, podemos definir un servidor como servidor web, y otro para el despliegue de EJBs. En nuestro caso, definimos el Borland Enterprise Server AppServer como único servidor para todo tipo de servicios. Para ello, configurar el diálogo como aparece en la siguiente figura, y pulsar Ok para validar. Enterprise JavaBeans Página : 5

6 Nota: Es necesario reiniciar el ordenador tras la configuración del servidor por vez primera. Creación de la EJB Para activar el diseñador visual de EJB 2.0, seleccionar File New. Dentro de la ventana que aparece, seleccionar la pestaña Enterprise, y a continuación el elemento EJB2.0 Bean Designer. Pulsar Ok. En JBuilder 7, cada EJB desarrollada debe pertenecer a un módulo de EJB. Un EJB module es una agrupación lógica de una o más beans que son desplegadas en un único fichero JAR. Cada módulo contiene por tanto toda la información necesaria para el despliegue de las EJBs que contiene: ficheros que conforman la EJB, descriptores de despliegue, y fichero manifest. Todo el contenido del módulo se incluirá finalmente en un único archivo JAR. Al intentar activar el diseñador de EJBs, JBuilder ofrece una ventana en la que podemos introducir en qué módulo EJB se desean incluir las EJB que se van a desarrollar. Como nuestro proyecto no contiene ningún módulo, pulsar el botón New para crear un nuevo módulo. Nombrar el módulo MyModule. Observar que en el campo Version se ofrece la posibilidad de escoger la especificación que se desea seguir, 1.x ó 2.0. En este caso, dejar el valor por defecto, EJB 2.0 compliant y pulsar Ok. Una vez creado el módulo, pulsar Ok de nuevo para validar la ventana del diseñador. A continuación, desaparece el editor de texto, y en su lugar aparece el diseñador de EJBs. Pulsar el botón derecho del ratón sobre el área del diseñador, y seleccionar Create EJB Session Bean. Rellenar el menú como aparece en la figura, llamando MyComponent a nuestra EJB. 6

7 Cabría resaltar un par de detalles del anterior menú. En primer lugar, se ha seleccionado disponer de un interfase local y otro remoto. Esta opción está disponible sólo para EJBs que siguen la especificación 2.0. En segundo lugar, se ha fijado el tipo de sesión a Stateful, ya que es la clase de EJB que deseamos generar. El resto de opciones se dejan por defecto. A continuación vamos a crear un campo que se llamará greeting. Para ello, hacer click con el botón derecho del ratón sobre el gráfico de la EJB. Seleccionar Add Field. Rellenar el menú que aparece, como indica la figura. Apreciar que el diseñador permite la creación de métodos getter y setter de modo visual. También permite seleccionar en qué interfases se desea que aparezcan estos métodos, que serán usados para dar valores al campo creado y conseguir el valor del mismo. Creamos ahora un nuevo método ejbcreate. Pulsar el botón derecho del ratón encima del gráfico de la EJB, y seleccionar Add ejbcreate. Cambiar el nombre del método e introducir un parámetro de entrada como se indica en la siguiente figura. Ahora vamos a escribir el código que deseamos que se ejecute al llamar este método. Para ello, hacer click con el botón derecho del ratón sobre la EJB, y seleccionar View Bean Source. De este modo, accedemos al código java de la EJB. Modificar el método creado previamente, añadiendo la siguiente línea de código. public void ejbcreateinit(string greeting) throws CreateException { setgreeting(greeting); } Enterprise JavaBeans Página : 7

8 Hemos creado un ejbcreate adicional que admite un parámetro. Este parámetro inicializa el valor del campo greeting de nuestra EJB. Una vez hecho esto, nuestra Stateful Session Bean ha sido creada! Seleccionar el menú Project Make MyModule. Esta opción hace que JBuilder genere los ficheros asociados a las EJBs incluidas en nuestro módulo. Veamos cuáles han sido los ficheros creados automáticamente por JBuilder. El panel de proyecto debería tener una apariencia similar a la siguiente. En él se pueden ver los siguientes ficheros: La bean propiamente dicha, MyComponentBean.java. Los interfases home, tanto el local MyComponentLocalHome.java, como el remoto MyComponentHome.java. El interfaz local MyComponentLocal.java y el interfaz remoto MyComponent.java. Dentro del nodo del módulo se aprecia el archivo JAR generado. Para conocer que es lo que contiene nuestro archivo JAR, hacer doble click sobre él. Nos aparece lo siguiente en el structure pane: El directorio META_INF contiene los descriptores de despliegue. Los ficheros que aquí aparecen dependen del servidor de aplicaciones definido para nuestro proyecto en el primer apartado del tutorial. Estos ficheros son generados y actualizados de forma automática por JBuilder. En caso de que deseemos modificarlos, se puede acceder a su contenido haciendo doble click sobre ellos. En el mismo directorio también tenemos el fichero manifest.mf, que almacena información sobre el contenido del archivo JAR. Abriendo el nodo statefulsessionbeanproy al hacer click en el símbolo +, aparecen todos los ficheros java generados por JBuilder. Están incluidos los nombrados anteriormente, así como los ficheros java correspondientes a stubs, skeletons, etc. En definitiva, disponemos de todos los ficheros necesarios para el despliegue de esta Enterprise JavaBean en un servidor de aplicaciones, siguiente paso del tutorial. Despliegue en servidor de aplicaciones En este punto ya tenemos completamente desarrollada nuestra EJB. A continuación vamos a desplegarla en nuestro servidor de aplicaciones. JBuilder 7 dispone de un potente y cómodo asistente para el despliegue de aplicaciones. Antes de intentar el despliegue de nuestra EJB, debemos lanzar nuestro servidor de aplicaciones. Consulte los manuales de su servidor de aplicaciones e inicielo. Si su servidor de aplicaciones es el Borland Enterprise Server AppServer Edition , debe ejecutar desde fuera de JBuilder el fichero ias.exe (localizado en la carpeta bin del directorio de instalación del servidor, usualmente C:\BorlandEnterpriseServer\bin\ias.exe). Existe un acceso directo en su carpeta Borland Enterprise Server, llamado Server. El lanzamiento del servidor de aplicaciones puede llevar unos minutos. Una vez el servidor esté iniciado, procedemos al despliegue de nuestra aplicación. Seleccionar el menú Tools Enterprise Deployment. 8

9 Aparece una nueva ventana de diálogo. Su apariencia y opciones pueden variar ligeramente dependiendo del servidor de aplicaciones de destino. Para el Borland Enterprise Server AppServer Edition , la ventana presenta la siguiente apariencia. En el campo Partition, se puede seleccionar la partición en la que deseamos desplegar nuestra EJB, en nuestro caso seleccionamos la partición standard. Seleccionamos también el reiniciar la partición tras el despliegue, verificar los descriptores de despliegue, y la generación de stubs para asegurarnos que los desplegamos también con nuestra EJB. Nota: Como ya citamos anteriormente, la ventana tiene distinta apariencia dependiendo del servidor de aplicaciones. Para un servidor weblogic, la ventana es la siguiente. La herramienta de despliegue para WebSphere e iplanet también varía dependiendo de las versiones. Continuando nuestro tutorial para el servidor Borland Enterprise Server AppServer Edition , presionar el botón Finish. Aparece una nueva ventana que indica como se va desarrollando el proceso de despliegue, que puede llevar unos minutos. Si todo fue correcto, finalmente debe aparecer lo siguiente. Enterprise JavaBeans Página : 9

10 Pulsar Close para terminar. Desarrollo de un cliente de testeo A estas alturas del tutorial, hemos desarrollado con éxito una Stateful Session EJB, y la hemos desplegado en un servidor de aplicaciones. A continuación vamos a desarrollar un sencillo cliente que cree una instancia de nuestra EJB, la reinicie y muestre el valor de su campo. JBuilder 7 provee un asistente para la creación de clientes de EJBs. Para activarlo, seleccionar File New, escoger la pestaña Enterprise, y a continuación EJB TestClient. Vamos a nombrar a nuestro cliente MyComponentTestClient, y vamos a generar un método main para que sea ejecutable. Rellenar la ventana del asistente para que muestre la siguiente apariencia. 10

11 Pulsar Ok. JBuilder genera de forma automática el código para esta clase. Incluye un método main, y un constructor que obtiene el interfaz home. En este tutorial, vamos a usar los interfases remotos de la EJB y no los locales. Vamos a obtener un interfaz usando el interfaz home, y a continuación vamos a usar algunos de sus métodos. Para ello, sobreescribimos el método main de este modo: public static void main(string[] args) { MyComponentTestClient client = new MyComponentTestClient(); MyComponent interfaz; try { interfaz = client.mycomponenthome.createinit("hello!"); System.out.println("Saludo1 = " + interfaz.getgreeting()); interfaz.setgreeting("ciao!"); System.out.println("Saludo2 = " + interfaz.getgreeting()); } catch (Exception e) { } } En el código se ha inicializado el campo al valor Hello! mostrando su valor por pantalla, y a continuación se modifica a Ciao! y se vuelve a mostrar por pantalla. Vamos a ejecutar nuestro cliente. Para ello, creamos una nueva configuración de ejecución. Seleccionar Run Configurations. Seleccionar la pestaña Run, y pulsar el botón New para crear una nueva configuración. En primer lugar, modificar su nombre en Configuration Name. Introducir Tester. A continuación, debemos indicar a JBuilder la clase que contiene el método main que se desea ejecutar. Necesitamos seleccionar en el campo Main Class nuestra clase MyComponentTestClient.java. Para ello, pulsamos el botón elipsis. Aparece la siguiente ventana. Navegar hasta seleccionar nuestro cliente como muestra la anterior figura. Pulsar Ok, y pulsar Ok de nuevo para terminar de crear nuestra configuración de ejecución. Otra vez pulsar el botón Ok para cerrar el diálogo de ejecuciones. Tenemos el servidor corriendo con nuestra Enterprise JavaBean. A continuación, lancemos el cliente! Seleccionar Run Run MyComponentTestClient.java using Tester. La salida de este proceso se puede leer en el propio Message Pane que aparece al ejecutar nuestra clase. En primer lugar, aparece el comando que se ejecutó incluyendo sus parámetros, como el CLASSPATH. Y a continuación, aparece la salida esperada de nuestro testeador. Saludo1 = Hello! Saludo2 = Ciao! De este modo, terminamos el presente tutorial. Enterprise JavaBeans Página : 11

12 Resumen En este tutorial se cubrieron los siguientes tópicos: Configuración de un servidor en la IDE de JBuilder 7. Desarrollo de una Stateful Session EJB 2.0 con el diseñador visual. Despliegue en un servidor de aplicaciones. Creación de un cliente. 12

13 Tutoriales Danysoft Siempre pensando en Usted no sólo es nuestro lema. Es nuestra manera de pensar. Como resultado de ello nos hemos dado cuenta de que un grupo importante de nuestros clientes no estaba siendo contemplado por nuestra oferta de formación. Pensando en ellos creamos los tutoriales Danysoft. Qué es un tutorial? Un tutorial busca dar a conocer una tecnología o parte de ella por medio de un caso práctico debidamente explicado. Se diferencia de un curso de formación tradicional en que, en lugar de tratar un tema desde el punto de vista teórico para luego ver un caso práctico, el tutorial va directamente al caso práctico explicando y codificando al mismo tiempo. Los tutoriales están orientados a programadores medios y avanzados que poseen una base de conocimiento sólida y comprenden mejor una porción de código fuente con un par de aclaraciones que una explicación teórica completa. Y no sólo la comprenden mejor sino que la prefieren. Cuantos de nosotros hemos descargado alguna vez un artículo de Internet y, en lugar de leerlo minuciosamente de principio a fin, hemos salteado todo el texto para ir directamente al código fuente? Seguramente muchos, por no decir la mayoría. Esta es la idea que siguen los tutoriales. Cada tutorial tiene una duración aproximada de tres horas y su contenido es lo suficientemente claro y completo como para no requerir la presencia de un instructor. Esto nos permite ajustarlos fácilmente a las necesidades y deseos particulares de cada uno de nuestros clientes. Gracias a los tutoriales nuestra oferta de formación se amplía considerablemente abarcando un espectro sin igual como sólo Danysoft podía hacerlo. Cursos de formación a la carta Una de las ventajas de los tutoriales es que permiten la configuración de cursos a medida permitiendo abarcar más temas en menos tiempo. En lugar del tradicional curso de formación con un temario rígido, un curso basado en tutoriales puede profundizar en algunos temas y ver por arriba otros, ajustándose mejor a las necesidades y deseos particulares de nuestros clientes. Tutoriales a distancia Debido a que los tutoriales son lo suficientemente claros y completos como para no requerir la presencia de un instructor, estamos en condiciones de satisfacer las demandas de formación de sitios geográficamente distantes a un coste muy conveniente. Si llega Internet entonces llegan los tutoriales Danysoft. Si llega el correo entonces llegan los tutoriales Danysoft. Tutoriales sobre demanda Otra de las ventajas de los tutoriales es la posibilidad de formar sobre demanda. Si no existe un tutorial para el tema buscado, podemos crear uno o los que sean necesarios. Es una posibilidad única. Algo así como contactar al autor de un libro y pedirle que escriba un capítulo sobre un determinado tema de nuestro especial y particular interés. Tutoriales Danysoft Página : 13

14 Tutoriales JBuilder 7 General JBuilder 7. Debugger. Aplicaciones de acceso a base de datos. Configuración de un driver JDBC, y desarrollo de una sencilla aplicación de acceso a Base de Datos. Uso de consultas parametrizadas con JBuilder7. Uso de procedimientos almacenados con JBuilder7. Establecimiento de una relación maestro-detalle. Uso de módulos de datos: mejora del rendimiento. Acceso a datos en ficheros de texto. Añadiendo funcionalidad a nuestra aplicación I: navegación y filtrado. Añadiendo funcionalidad a nuestra aplicación II: columnas calculadas, vistas altenativas de datos. Enterprise JavaBeans Desarrollo, despliegue en Borland Enterprise Server y testeo de una Stateful Session bean EJB 2.0. Desarrollo, despliegue en Borland Enterprise Server y testeo de una Stateless Session bean EJB 2.0. Desarrollo, despliegue en Borland Enterprise Server y testeo de una Entity bean EJB 2.0. Desarrollo, despliegue en Borland Enterprise Server y testeo de una Message Driven bean EJB 2.0. Desarrollo, despliegue en BEA Weblogic Server 7.0 y testeo de una Stateful Session bean EJB 2.0. Desarrollo, despliegue en BEA Weblogic Server 7.0 y testeo de una Stateless Session bean EJB 2.0. Desarrollo, despliegue en BEA Weblogic Server 7.0 y testeo de una Entity bean EJB 2.0. Desarrollo, despliegue en BEA Weblogic Server 7.0 y testeo de una Message Driven bean EJB 2.0. Creación de un productor JMS y un consumidor Message-Driven Bean. Creación de relaciones entre Entity Beans. Acceso a una EJB desde un client servlet. Acceso a una EJB desde un cliente JSP. Acceso a una EJB desde un cliente Aplicación. Creación de una aplicación: Servlet Stateful Session Bean Entity Bean. JavaBeans Desarrollo de una JavaBean con las herramientas de JBuilder 7. Creación y consumo de una JavaBean desde una JSP. 14

15 Aplicaciones Web Desarrollo de una applet con las herramientas de JBuilder 7. Desarrollo de una JSP básica con las herramientas de JBuilder 7. Desarrollo de una JSP usando InternetBeans: acceso a base de datos. Desarrollo de una Servlet básica con las herramientas de JBuilder 7. Desarrollo de una Servlet usando InternetBeans: acceso a base de datos. Servlets: uso de sesión y cookies. Creación de una aplicación web de validación de usuarios. Desarrollo y despliegue en BEA Weblogic Server 7.0 de una aplicación web. Desarrollo y despliegue en Borland Enterprise Server de una aplicación web. Aplicaciones distribuidas Desarrollo de una aplicación CORBA. Desarrollo de una aplicación RMI. Servicios Web Desarrollo de una aplicación que consuma un servicio web. Creación de un servidor de servicios web. Creación de interfases gráficas Introducción al diseñador gráfico de JBuilder 7. Principales componentes Swing. Gestión de Layouts. Creación de menús. Tutoriales JBuilder 7 Página : 15