Para los que han trabajado anteriormente con NetBeans no encontrarn muchas diferencias en la interfaz con relacin a versiones

anteriores, la pantalla de carga inicial si es muy diferente, la interfaz de desarrollo no lo es tanto, luego de la carga inicial vamos a crear un proyecto, para ello vamos al elemento de men File y luego a New Project, tambin podemos usar el short-cut Ctrl+May+N.

Luego aparecer la interfaz de creacin de proyecto, en la que elegiremos un tipo especfico de proyecto, para el objetivo actual vamos a elegir la categora Java Web e internamente el proyecto Web Application, si se trata de la primera vez que estamos cargando un proyecto de este tipo tambin observaremos el proceso de activacin del Java Web y el EE en el NetBeans.

Luego, el asistente nos solicitar el nombre del proyecto y la ubicacin, como nombre usaremos proyecto, y la ubicacin que usaremos ser la ubicacin por default, se presiona el botn Next y se procede a la eleccin del servidor y la versin del Java EE, como servidor se usar el Glassfish y la versin de Java EE ser la Java EE 6 Web.

La ltima parte del asistente es la eleccin de los frameworks que vamos a implementar en el proyecto, en este caso en particular no implementaremos ningn framework en especial, se presiona el botn Finish y el asistente proceder a la creacin de todos los archivos bsicos del proyecto, esto tomar algunos segundos y tiene una barra de progreso indicadora.

Al finalizar la generacin de los archivos del proyecto, tendremos una vista como la mostrada en la siguiente imagen, donde se puede apreciar la estructura de archivos del proyecto.

Ahora es momento de configurar el servidor de base de datos, para las labores de contencin de datos de los proyectos que vamos a desarrollar, en el panel de la derecha, a la altura de la pestaa Projects se encuentra la pestaa Services, dentro de la cual existen cinco grupos de servicios, el grupo que nos interesa es el de Databases, lo desplegamos y tenemos un gestor de bases de datos registrado (Java DB) y una base de datos registrada (sample, el tercer item dentro del grupo Databases).

Lo siguiente a hacer ser registrar el servidor de bases de datos MySQL, instalado como se indica en el tutorial de instalacin de MySQL, para ello damos clic derecho en el grupo Databases, y se elegir el elemento Register MySQL Server, ya que vamos a registrar la instancia de MySQL instalada anterioremente, finalmente ser necesario el ingreso de la informacin solicitada para el registro de la instancia de MySQL, asumiendo que no hay datos modificados durante el proceso de instalacin del MySQL, slo ser necesario el ingreso de la contrasea de administrador de la instancia de MySQL.

Terminado el proceso anterior, tendremos un nuevo elemento dentro del grupo de servicios Databases, este nuevo elemento representa a la instancia del servidor MySQL y muestra tambin el puerto desde donde se est accediendo a los servicios de la instancia.

Una vez registrada la instancia de MySQL es necesario conectarla, para ello damos clic derecho sobre el nombre de la instancia registrada y seleccionamos Connect, si las credenciales entregadas antes son correctas y el servidor esta en funcionamiento (el servicio de MySQL esta en ejecucin) se desplegar la relacin de bases de datos registradas en la instancia.

Ahora podremos crear una base de datos, las funciones de administracin del servidor de bases de datos desde NetBeans son bastante bsicas pero suficientes para cumplir con el objetivo del tutorial, damos clic derecho nuevamente sobre el nombre de la instancia registrada y esta vez seleccionamos Create Database, luego de lo cual nos ser solicitado el nombre d e la base de datos, la cual se llamar proyecto.

Al terminar la creacin de una nueva base de datos en MySQL se puede observar la aparicin de un nuevo elemento dentro del registro del servidor MySQL, este nuevo elemento representa a la nueva base de datos de nombre proyecto, en la segunda imagen se observa el despliegue del otro nuevo elemento, el que aparece en el grupo de servicios Databases, este registro es especfico para la base de datos y no para el servicio de MySQL, el nombre es jdbc:mysql://localhost:3306/proyecto y representa la conexin a la base de datos recin creada, al desplegar su contenido podemos observar claramente que no tiene ningn registro de tablas.

Una vez finalizado el registro del servidor de bases de datos (MySQL) y la creacin de la base de datos con la que vamos a trabajar ya podemos regresar a la pestaa de proyectos, procederemos a crear una nueva clase Entidad, para ello bastar con darle clic derecho al nombre del proyecto y dentro de New elegimos Entity Class le daremos como nombre Facultad y, para efectos de orden, el paquete donde lo pondremos se llamar clases, es necesario observar que el check de creacin de unidad de persistencia este activado. Al hacer clic en el botn Next procederemos con la creacin de la Unidad de Persistencia.

La unidad de persistencia contiene los datos de conexin especficos para la base de datos con la que vamos a trabajar, le asigna un nombre y gestiona la conexin con el servidor y la base de datos de trabajo. Dejaremos el nombre de la unidad de persistencia tal y como est, tambin dejaremos con el valor por default al Proveedor de Persistencia, EclipseLink (JPA 2.0)(default), luego procedemos con la creacin del respectivo Data Source, para ello desplegamos el combo de Data Source y elegimos New Data Source.

En el nuevo cuadro de dilogo le asignamos un nombre a nuestro Data Source y una conexin, la misma que creamos luego de registrar al gestor de MySQL, hasta tener el cuadro de dilogo tal y como se observa en la imagen, luego presionamos el botn OK, finalmente la estrategia de generacin de tablas ser Drop and Create, ya que as nos aseguramos que las modificaciones introducidas en las clases sean replicadas en la base de datos, luego se presiona el botn Finish.

Finalizado el proceso anterior tenemos una nueva clase creada en la carpeta Source Packages, dentro del paquete clases, tal y como se observa en la siguiente imagen, esta clase es nuestro primer EJB (Enterprise Java Bean) del tipo Entidad, bsicamente su funcin es modelar la base de datos por medio de JPA (Java Persistence API).

Vamos a introducir un nuevo atributo en la clase, el atributo nombre de tipo String, para ello colocaremos el cursor justo debajo de la lnea de definicin del atributo id, es decir en la lnea 23 de acuerdo con la imagen anterior, presionamos las teclas Alt+Insert y en el men contextual elegimos Add Property luego llenamos el cuadro de dilogo como se observa en la siguiente imagen, el cdigo a insertar se muestra en la parte inferior de la imagen.

El cdigo autogenerado se insertar en la posicin donde dejamos el cursor, por eso es importante invocar esta opcin con el cursor justo debajo de la declaracin del atributo id. para asegurarnos que el nuevo atributo sea tambin persistido, es necesario agregar una anotacin encima del mismo, es decir, en la lnea 24, la anotacin ser @Basic, la que le indica al compilador la obligatoriedad de persistir dicho atributo como columna en una tabla. Si es la primera vez que se lleva a cabo esto en una clase, saldr un error detectado por el NetBeans.

Si sale el error bastar con hacer un clic derecho en el icono del error (el foco con la admiracin en rojo) y luego seleccionar el Add import para que aada la respectiva instruccin imp ort en la cabecera de la clase, como se puede observar en las imgenes siguientes.

Ahora prepararemos otro EJB, esta vez del tipo Session Bean, basado en la entidad recin creada, para eso damos clic derecho en el nombre del proyecto, luego en New y en Other (ya que no se observa el enlace para Session Bean for Entity Clases), en la ventana emergente elegiremos la categora Enterprise Java Beans y el tipo de archivo Session Bean for Entity Clases, presionamos el botn Next.

En la siguiente ventana nos muestra la relacin de las clases entidad disponibles en nuestro proyecto, en nuestro caso slo tenemos una, y la aadimos como Clase Entidad Seleccionada, presionamos el botn Next.

Como datos finales colocaremos el nombre del paquete, ya saben, con fines de mantener el orden y aislar los cambio, el nombre del paquete que usaremos ser clases.beans, adems ordenaremos que se cree una interfaz de tipo local, es local porque el acceso al session bean ser en el mismo equipo y no desde otros equipos, al presionar el botn Finish observamos como se crean tres nuevos archivos en el paquete clases.beans.

Ahora estamos listos para la fase final, crearemos un Web Service, para ello nuevamente damos clic derecho sobre el nombre del proyecto, elegimos New y buscamos la opcin Web Service, luego tenemos un nuevo asistente, en el le daremos nombre al Web Service, el nombre elegido ser ServicioWeb, la ubicacin ser en el paquete servicio, luego elegimos Create Web Service from Existing Session Bean y presionamos el botn Browse

En la bsqueda nos muestra la relacin de los EJBs de tipo session disponibles en el proyecto, slo observamos el creado en el paso anterior, su nombre es FacultadFacade, una vez capturado el EJB, como se observa en la segunda imagen, podemos presionar el botn Finish.

Es tiempo de compilar y desplegar, la estructura del proyecto se observa en la primera imagen, si la ventana de salida de datos no se puede observar en la parte inferior de la IDE bastar con ir al men Windows, luego a Output y dar clic Output, o presionar Ctrl+4.

Ahora damos clic derecho al nombre del proyecto y elegimos la tercera opcin, Clean and Build, la que llevar a cabo el proceso de limpieza y compilacin del proyecto, dicho proceso debe tener como resultado final una lnea similar a la mostrada en la segunda imagen, con las palabras BUILD SUCCESSFUL de color verde.

Una vez compilado el proyecto es tiempo de desplegarlo, el despliegue se llevar a cabo en el servidor elegido originalmente al momento de crear el proyecto, en nuestro caso ser el Glassfish. Debido a que este no es un proyecto estndar no vamos a correr el cdigo (Run), lo que vamos a hacer es desplegar el cdigo en el servidor de aplicaciones, para ello damos clic derecho en el nombre del proyecto, y buscamos la opcin Deploy, en la ventana Output seleccionamos la pestaa Glassfish Server 3.1 y si no tenemos ningn problema, deberamos tener una lnea de salida similar a la resaltada en la segunda imagen, INFO: proyecto implementado correctamente en xx milisegundos.

Como fase final, es hora de probar el servicio web recin desplegado, para ello, en la estructura del proyecto, desplegamos la carpeta Web Services, encontramos nuestro ServicioWeb, le damos clic derecho y ubicamos la opcin Test Web Service, la cual nos mostrar una pgina web con los servicios publicados en el web service.

Ahora probaremos uno de los mtodos publicados en el web service, si presionamos el botn count obtendremos el conteo de los objetos Facultad almacenados en la base de datos, como se observa en las imgenes, el resultado es cero, lo cual es perfectamente normal si consideramos que an no hemos hecho ningn ingreso en la base de datos, sin embargo el obtener este nmero tambin nos confirma que todo esta funcionando bien.

Recuerdan como creamos una base de datos , haciendo uso de la pestaa servicios?, es momento de regresar al mismo sitio y ver si han habido cambios en la base de datos originalmente creada, para ello damos clic en la pestaa Services y buscamos la conexin a la base de datos que creamos al inicio del tutorial, le damos clic derecho y luego en Refresh, finalmente observamos como se han creado elementos que antes no se encontraban ah, entre ellos las tablas facultad y sequence, adems, dentro de la tabla facultad se encuentran los campos ID y NOMBRE los que coinciden con los atributos creados en la clase entidad creada anteriormente.

El actual tutorial es slo una simple exposicin de los pasos para llevar a cabo mltiples tareas, como la creacin de EJBs de tipo entidad, de tipo sesin y la creacin de un Web Service, adems nos muestra lo sencillo que es el uso de JPA para el manejo de la persistencia sin necesidad de trabajar demasiado a nivel del gestor de bases de datos, esto nos permitir llevar a cabo el proceso de desarrollo sin perder de vista el modelo de clases ni el diseo orientado a objetos ya que ser JPA quien administre la conversin entre el modelo orientado a objetos y el modelo relacional, basado en una conversin Objeto-Relacional.