Tutorial: Instalar JBoss 7 en NetBeans y crear un DataSource MySQL

El objetivo de esta entrada es mostrar cómo realizar la instalación de JBoss Application Server en Windows, luego vamos a crear un DataSource para una base de datos MySQL y finalmente añadiremos JBoss a NetBeans para utilizarlo durante el desarrollo de nuestros proyectos.

Descargando e instalando JBoss AS 7 en Windows

Vamos al portal de descargas de JBoss Application Server y descargamos la versión Final. JBoss se descarga como un archivo comprimido (jboss-as-7.1.1.Final.zip). Por simplicidad lo descomprimiremos en nuestra carpeta de usuario: C:\Users\André\jboss-as-7.1.1.Final.
A esa ruta la conoceremos como JBOSS_HOME:

(Opcional) Iniciando el servidor JBoss

JBoss está listo para ser iniciado, pero antes de hacerlo vamos a setear la variable de entorno JAVA_HOME pues de no ser así, al iniciar el servidor éste nos mostrará un WARNING. Podemos hacerlo siguiendo este tutorial.
Ahora sí, para iniciar el servidor abrimos la Consola de Windows (Inicio, "cmd") y nos movemos (comando cd) al directorio bin de JBOSS_HOME, es decir:

Una vez ubicados en ese directorio, digitaremos el script que inicia a JBoss: standalone.bat (ENTER) y obtendremos lo siguiente:

Listo, tenemos el servidor JBoss ejecutándose. Para detenerlo, sólo debemos presionar CTRL+C en la consola y luego cerrarla.

Creando un DataSource MySQL en JBoss AS 7

Vamos a configurar un recurso en JBoss: el DataSource que utilizaremos en nuestros proyectos para conectarse a nuestra base de datos en MySQL.

Agregando el driver MySQL a JBoss:
Vamos a $JBOSS_HOME\modules\com y creamos la carpeta mysql, y dentro de la carpeta mysql, creamos la carpeta main. Dentro de la carpeta main, copiamos el driver de MySQL: mysql-connector-java-5.1.26.jar que puedes descargar desde acá. También creamos un archivo llamado module.xml con el siguiente contenido:

Debemos tenerlo así: (prestar atención a la ruta)

Creando la referencia al driver de MySQL
Editamos el archivo $JBOSS_HOME\standalone\configuration\standalone.xml añadiendo la referencia al módulo mysql con la línea <driver name="mysql" module="com.mysql"/> justo después de la etiqueta <drivers>:

Creamos el DataSource
Finalmente, en el mismo archivo , añadimos el siguiente código justo antes de la etiqueta <drivers>:

 jdbc:mysql://localhost:3306/bd_ventas
 mysql
 
  root
  TU-PASSWORD
 
 
  100
  true
 

Añadiendo JBoss AS 7 a NetBeans

Ahora estamos listos para añadir JBoss a NetBeans. Abrimos NetBeans y vamos al menú Herramientas/Servidores (Tools/Servers para los que tienen la versión en inglés) y damos clic en Agregar Servidor (Add Server):

Se abrirá la ventana Agregar Instancia de Servidor (Add Server Instance), seleccionamos JBoss Application Server y damos clic en Siguiente (Next):

En la siguiente ventana hacemos clic en Examinar (Browse), seleccionamos la ruta donde descomprimimos JBoss y damos clic en Siguiente (Next):

Finalmente veremos las propiedades por defecto de nuestra instancia de JBoss. Lo dejaremos tal como está y hacemos clic en Finalizar (Finish):

Cerramos la ventana Servidores (Servers) y ahora nos vamos a la pestaña Servicios del panel izquierdo de NetBeans. Desplegamos el nodo Servidores (Servers) e iniciamos JBoss Application Server dándole clic derecho y luego Iniciar (Start):

Los mismos mensajes que vimos en la consola de Windows, los veremos ahora en la consola de NetBeans: se nos informa que JBoss ha sido iniciado, y un detalle muy importante, que JBoss nos ha reconocido el DataSource java:/VentasDS que hemos añadido anteriormente:

Si todo ha salido bien hasta ahora, ya tenemos JBoss añadido a NetBeans con un DataSource listo para ser utilizado en nuestros proyectos. Para detenerlo, bastará dar clic en el botón rojo de la consola de NetBeans "Detener el Servidor" (Stop the server).

Hasta la próxima.