TIP N° 5 : BUENA PRACTICA PARA CONFIGURAR UN DATA SOURCE EN JBOSS EAP

22.06.2022

DataSource:

La mayoría de las aplicaciones Java EE involucran una base de datos que contiene la información que los usuarios necesitan para acceder y realizar las operaciones CRUD básicas (crear, leer, actualizar y eliminar).

El primer paso es la implementación de un controlador JDBC como modulo.

¿Qué es un controlador JDBC?

Un controlador JDBC es un componente que utilizan las aplicaciones Java para comunicarse con una base de datos. El controlador JDBC está empaquetado en un archivo JAR (Java Archive) y contiene un archivo de clase que contiene la definición del controlador. Los controladores JDBC están disponibles a través de los proveedores de bases de datos, como MySQL o PostgresSQL. Para usar un controlador JDBC en EAP versiones desde la 6 y 7, primero debe instalarse como un módulo en el servidor.

Paso 1: Creación de modulo del controlador JDBC:

Agregar el módulo del controlador JDBC se puede hacer manualmente o mucho más simplemente con el EAP CLI. El comando de adición de módulo de la CLI requiere que el usuario proporcione:

Nombre: Un nombre basado en un nombre de paquete de Java que EAP utilizará para almacenar el archivo JAR y un archivo de configuración llamado módulo. Debe ser único y no puede entrar en conflicto con las existentes bibliotecas disponibles en el directorio $JBOSS_HOME/modules.

Recursos: Se refiere a la ubicación que almacena el archivo JAR.

Dependencias: Identifique qué bibliotecas de Java utiliza el controlador JDBC y dónde se encuentran ubicado en su JBoss EAP.

Puede descargar el driver desde el sitio web del proveedor del producto MySQL, PostgreSQL, Oracle, IBM, Sybase, Microsoft, etc. Dependiendo del motor que necesite conectar.

O si está en una distribución Linux como RHEL, se puede hacer a través del comando yum.

Un ejemplo para el conector de mysql:

#yum -y install mysql-connector-java

Para agregar un módulo a través del EAP CLI, la sintaxis para el comando es de la siguiente forma:

Por ejemplo, el siguiente comando en EAP CLI creará el módulo JDBC MySQL, usando el archivo mysql-connector-java.jar que se descargó del proveedor de la base de datos:

NOTA:

Debido a que este comando en realidad no modifica el archivo standalone.xml o domain.xml, el servidor EAP no necesita estar ejecutándose y la CLI no necesita estar en modo conectado.

Después de ejecutar este comando, se crea un nuevo directorio en /opt/jboss-eap/modules/com/ mysql/main. El nuevo directorio contiene el archivo JAR proporcionado, así como un módulo.xml que se genera en función de las dependencias dadas del controlador.

Ejemplo de como debiese quedar el archivo de configuración:

Paso 2: Creación de un DS Non-XA:

Podemos generarlo de dos formas, una a través del CLI del EAP o a través de la consola web de administración:

CLI EAP:

Iniciar la herramienta CLI, a través del script "jboss-cli.sh".

Ejemplo:

Ejecute el siguiente comando para crear una fuente de datos que no sea XA, configurando las siguientes variables:

Un ejemplo de creación para un DS MySql:

Habilitación de datasource:

Vía consola de administración web:

A través de la consola de administración web, se debe realizar de la siguiente manera:

1. Inicie sesión en la Consola de administración.

2. Navegue a la pestaña configuración.

3. Seleccione DataSources.

4. Agregar.

Luego de configurado los principales atributos del Data Source como la url, el usuario y la contraseña, finalmente se debe habilitar como vemos en la siguiente imagén:

Y asi se ve finalmente un Data Source correctamente configurado y habilitado en la consola de JBOSS EAP.

¿Necesitas hablar con nosotros?