DataSources en una aplicación Java EE

Todas las aplicaciones en Java EE va a necesitar - al menos - una conexión a una base de datos relacional.

Según el Diseño de Patrones, la conexión a base de datos debe estar fuera de la aplicación que estamos construyendo.

Según el estándar de Java EE, la conexión a la base de datos debe estar basada en un Pool de Conexiones y que esté administrado por el Contenedor Java EE.

Esta conexión a la base de datos es a través de los DataSource del Contenedor Java EE.
En este post veremos que existen tres maneras para implementar un DataSource, con sus ventajas y desventajas, dependiendo de lo que uno desea para su propia implementación.





Ojo: Spring Boot no hace aplicaciones Java EE. En la misma página de Spring Boot dice que hace aplicaciones Spring, no Aplicaciones Java EE.

Declarándolo en el web.xml

El archivo web.xml es estándar entre todas las aplicaciones Java Web, así que allí podemos configurar todo lo necesario para conectarnos a la base de datos

Ejemplo

En el web.xml debería tener las siguientes etiquetas.



Para invocarlos desde el persistence.xml se haría de la siguiente manera.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<persistence xmlns="http://xmlns.jcp.org/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.1" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence http://xmlns.jcp.org/xml/ns/persistence/persistence_2_1.xsd">
  <persistence-unit name="empleadosPU" transaction-type="JTA">
    <jta-data-source>java:app/EmpleadosDS</jta-data-source>
    <exclude-unlisted-classes>false</exclude-unlisted-classes>
    <properties>
      <property name="javax.persistence.schema-generation.database.action" value="create"/>
    </properties>
  </persistence-unit>
</persistence>

Y para invocarlo desde un Componente Java es de la siguiente manera. 

@WebServlet(name = "EmpleadoServlet", urlPatterns = {"/EmpleadoServlet"})
public class EmpleadoServlet extends HttpServlet {

    @Resource(name = "java:app/EmpleadosDS")
    private DataSource empleadosDS;

Ventajas

  • Es tan estándar que podemos usar el mismo .war en diferentes Contenedor Java EE indistintamente tales como Wildfly, TomEE y Payara.
  • Cero configuración en el Contenedor Java EE.
  • Ideal para ambientes de desarrollo
  • Las credenciales de la base de datos es independiente al código Java.
  • No se necesita conocer cómo configurar el Contenedor Java EE.

Desventajas

  • La configuración está basada para un solo servidor de base de datos. Si se desea cambiar a otro, se necesita cambiar el archivo, aunque existen maneras vía maven para actualizar el contenido del web.xml dependiendo del perfil en que se esté ejecutando; por ejemplo, para el ambiente de Producción usa una configuración, y para el de Desarrollo otra.
  • Necesita del driver JDBC en la misma aplicación.

Declarándolo como una anotación @DataSourceDefinition

Esta opción es similar al anterior, solo que todas las credenciales estarán en nuestro código .java.

Ejemplo

Para invocarlos desde el persistence.xml se haría de la misma manera.
  <persistence-unit name="samplePU" transaction-type="JTA">
    <jta-data-source>java:app/SampleDS</jta-data-source>
    <class>com.apuntesdejava.rest.sample.services.ProductCode</class>
    <exclude-unlisted-classes>true</exclude-unlisted-classes>
    <properties>
      <property name="javax.persistence.schema-generation.database.action" value="create-or-extend-tables"/>
    </properties>
  </persistence-unit>

Y desde un componente Java EE igual que el anterior apartado.

Ventajas

  • Es Java 
  • Ideal para ambientes de desarrollo, personales y ejemplos.
  • No se necesita conocer cómo configurar el Contenedor Java EE.

Desventajas

  • Si hay algún cambio en la base de datos, tendríamos que volver a compilar el código.
  • Necesita del driver JDBC en la misma aplicación.

Configurando en el Contenedor Java EE

Esta opción es, a mi punto de vista, la más práctica a la hora de configurar el entorno, ya que en nuestra aplicación solo existirá el código para utilizar una conexión del Pool, y no nos preocupamos de dónde está alojado.
Toda la configuración se hace desde el Panel de Administración del Contenedor Java EE, el administrador del Contenedor puede ajustar el tamaño del Pool, el tiempo de expiración de la conexión, etc.

Ventajas

  • Independencia del código respecto a la conectividad con la base de datos.
  • Mayor flexibilidad para configurar el Pool de Conexiones, tanto que el mismo administrador del Contenedor puede configurarlo al margen del desarrollo de la aplicación.
  • No necesita del driver JDBC en la aplicación. Esta estará en el contenedor Java.

Desventajas

  • Se necesita conocer cómo se configura el Contenedor, generalmente se puede utilizar algunos scripts para realizar tal acción.
  • Por la misma razón, no es estándar entre los Contenedores, para cada uno necesita de una configuración especial.

Ejemplo

Este es el script que utiliza NetBeans para desplegar el proyecto en Payara.


Invocación

La invocación se hace de la misma manera que los demás ejemplos anteriores, ya que es estándar. La configuración del Contenedor Java EE no lo es. 

  <persistence-unit name="sakilaPU" transaction-type="JTA">
    <jta-data-source>jdbc/sakila</jta-data-source>
    <class>com.apuntesdejava.rest.sakila.services.Actor</class>
    <exclude-unlisted-classes>true</exclude-unlisted-classes>
    <properties>
      <property name="javax.persistence.schema-generation.database.action" value="create-or-extend-tables"/>
    </properties>
  </persistence-unit>

Código fuente

El código fuente para este ejemplo, y que funciona para Payara 4, Wildfly 10 y  Apache TomEE 7 está aquí:

https://bitbucket.org/apuntesdejava/payara-micro-demo/src/datasources/rest-demo-services/

Las bases de datos que utilizo son los siguientes:

  • HSQL, que está tomado del post anterior. Se autocrea y siguiendo unas instrucciones se puede llenar esa base de datos.
  • Apache Derby, que está tomando de la base de datos Sample que viene incluido en el JDK.
  • MySQL, utilizando la base de datos Sakila.

Bibliografía

Comentarios

Publicar un comentario

Si quieres hacer una pregunta más específica, hazla en los foros que tenemos habilitados en Google Groups


Ah! solo se permiten comentarios de usuarios registrados. Si tienes OpenID, bienvenido! Puedes obtener su OpenID, aquí: http://openid.net/

Entradas más populares de este blog

UML en NetBeans

Imagen
NetBeans permite programación orientada a objetos como Java y C++. Ahora bien, siendo un IDE muy bueno, debería permitirnos manejar UML para modelar nuestros objetos ¿cierto? Pues bien, aquí les muestro como instalar un plugin en NetBeans que nos permita escribir UML de una manera no convencional. (Mejor que arrastrar y soltar los artefactos en el lienzo.. ya verán)
Leer el artículo completo »

Cambiar ícono a un JFrame

Imagen
Un visitante de mi blog me pidió que le dijera cómo cambiar el ícono de los JFrame. Pero como este tip puede ser útil para toda la comunidad, decidí escribirlo aquí en mi blog. Paso 1 El ícono debe ser una imagen de extensión PNG. Esto se hace más fácil, ya que conseguir una figura y convertirlo en formato .ico es muy complicado. Los PNG nos ayudan bastante. Paso 2 La imagen que será el ícono debe estar dentro del paquete de fuentes, como si fuera una clase más. Si estuviera dentro de un paquete, sería mucho mejor. Paso 3 En el código del JFrame que vamos a poner el ícono, sobreescribimos el método  getIconImage()  conteniendo el siguiente código: (notar cómo se está llamando a la imagen .png) @Override public Image getIconImage() { Image retValue = Toolkit.getDefaultToolkit(). getImage(ClassLoader.getSystemResource("resources/icono.png")); return retValue; } Paso 4 En la vista de diseño del JFrame, lo seleccionamos y vamos sus propiedades, busca...
Leer el artículo completo »

Portales en Java

Imagen
Una aplicación web es relativamente fácil de hacer... pero si nuestro cliente quiere que le hagamos un portal para que sea Intranet, Extranet, administración de contenidos, gestor de archivos, foros, chat, wiki y 50 etc. más, podemos decir "sí se puede", y a medida que avanza el proyecto pensamos que se podría vender a otro cliente, tratamos de hacer lo más estándar posible.... y nunca terminamos. Estos sistemas web que permiten administrar contenidos se llaman Sistemas de Gestión de Contenidos (En inglés Content Management System - CMS) Estos ya tienen todo, o al menos todo el soporte necesario para gestionar contenidos web. Es una plataforma, y nosotros deberíamos unicamente anexarle las partes que faltan y lo que nuestro cliente necesita. Los más conocidos en PHP son Joomla , PHPNuke , Drupal .  Estos se encuentran en los hosting que se alquila por US$20 al año. Son simples, y funcionan para todos tipos de usuarios. Pero ¿y Java?
Leer el artículo completo »