lunes, 6 de diciembre de 2010

Vistas de Bases de datos con JPA

Una de las cosas que más me gusta de JPA es que una vez que desplegamos nuestra aplicación web no tenemos que preocuparnos de la creación de las tablas en la base de datos ni de los tipos de los campos.

Si tenemos que trabajar con vistas en base de datos, JPA las trata de la misma forma que si fueran tablas. Con que pongamos la anotación @Entity encima de una clase y se le de el nombre de una vista, se trabajaría igual que con cualquier tabla. La única diferencia es que no se pueden realizar operaciones de escritura (inserts y updates).

Si tenemos configurado JPA para que automáticamente genere todas las tablas, tenemos un pequeño problema, ya que para crear la vista, primero tendríamos que arrancar la aplicación web y que se creen todas las tablas necesarias. En ese momento también se creará una con el nombre de la vista que nosotros queremos crear, ya que como hemos dicho antes, le hemos añadido la anotación @Entity como al resto de entidades.

Esta tabla no tiene ningún sentido porque nunca vamos a meter datos en ella. Lo que tendremos que hacer es eliminarla y generar la vista manualmente después del primer arranque.

No sé si será lo más óptimo posible o si hay alguna otra posibilidad que yo desconozca, pero se me ocurrió una forma de poder añadir un listener en nuestra aplicación web para que no sea necesario tener que realizar todos estos pasos y que en el momento de arrancar la aplicación, se realicen automáticamente y no tengamos que preocuparnos en adelante por la creación manual de las vistas.

La idea es añadir a nuestra aplicación un Listener que se encargue de realizar los siguientes pasos:

- Mirar si existe la tabla con el nombre de la vista que queremos crear. En caso de que exista (Esto ocurriría únicamente la primera vez que arranca la aplicación web) se borrará.
- Si la vista existe (Esto ocurriría en los posteriores arranques de la aplicación), ésta se borrará para que si ha habido algún cambio de versión en la aplicación que requiere añadir, suprimir o modificar algún campo de la vista, no sea necesaria ninguna intervención manual.
- La query de la vista estará harcodeada en el listener, y lo que se hará después será crearla.

Este listener necesita que todas las tablas estén ya creadas, por lo que se tendrá que ejecutar siempre después del de Spring, que es el que se encarga de cargar JPA. Por ello, es importante que no se nos olvide ponerlo siempre después del ContextLoaderListener en el fichero web.xml


.....


org.springframework.web.context.ContextLoaderListener




RUTA DEL LISTENER

.....


El código del listener lo pongo a continuación. Si alguien lo quiere reutilizar que tenga en cuenta que la forma en la que he obtenido por código una referencia al DataSource de la base de datos posiblemente será diferente, ya que yo he aprovechado que el DataSource lo tengo definido como un Bean de Spring. Otra persona igual tiene que recuperarlo directamente mediante JNDI.



public class DBViewsCreator implements ServletContextListener
{
private static final Log log = LogFactory.getLog(DBViewsCreator.class);
private static final String TESTVIEW_NAME = "vplayer";
private static final String TESTVIEW_QUERY = "Select * from player p where p.active = true";

public void contextInitialized(ServletContextEvent servletContextEvent)
{
log.info("Creating DB views");
Connection conn = null;
try {
DataSource ds = getDatasource();
conn = ds.getConnection();
DatabaseMetaData md = conn.getMetaData();
DatabaseUtils.recreateView (md, TESTVIEW_NAME, TESTVIEW_QUERY, conn);
} catch (Exception e) {
log.error("Error during Database Views creation",e);
} finally {
try {
if (conn != null) conn.close(); }
catch (SQLException e) {
log.error("Error closing database connection",e);
}
}
}

private DataSource getDatasource (){
//Obtenemos el datasource de donde nos venga mejor, ya sea mediante JNDI o accediendo a un bean de Spring.
// En mi caso he utilizado la clase AppContext para recuperar el bean con nombre "dataSource". Explicada en
// http://blog.jdevelop.eu/2008/07/06/access-the-spring-applicationcontext-from-everywhere-in-your-application/
DataSource ds = (Datasource)AppContext.getApplicationContext().getBean ("dataSource");
return ds;
}

public void recreateView (DatabaseMetaData md, String viewName, String query, Connection conn) throws SQLException{
deleteView(md, viewName, query, conn);
createView(md, viewName, query, conn);
}

public void deleteView (DatabaseMetaData md, String viewName, String query, Connection conn) throws SQLException{
//primero comprobamos si existe la definición con el nombre de la vista, ya sea tabla o vista.
if (existsQuartzSchema(md, viewName)){
//Si existe la borramos y recreamos para tenerla siempre actualizada.
Statement stmt = conn.createStatement();
try {
//La primera vez que se arranque la aplicación, la siguiente instrucción dará error
// porque no existe la vista.
stmt.execute("DROP VIEW "+viewName);
} catch (SQLException e) {
try {
stmt.execute("DROP TABLE "+viewName);
} catch (SQLException e1) {
log.error("Error droping table "+viewName, e1);
throw e;
}
} finally{
if (stmt != null) stmt.close();
}
}
}

public static void createView (DatabaseMetaData md, String viewName, String query, Connection conn) throws SQLException{
//Creamos la vista.
Statement stmt = conn.createStatement();
try{
stmt.execute("CREATE VIEW "+viewName+" AS ("+query+")");
log.info("view "+viewName+" created successfully");
} catch (SQLException e) {
log.error("Error creating view "+viewName+" with query: "+query, e);
throw e;
} finally{
if (stmt != null) stmt.close();
}
}

public void contextDestroyed(ServletContextEvent servletContextEvent) {}
}


Espero que os sirva de ayuda, y si a alguien se le ocurre una idea mejor de cómo integrar las vistas en JPA que lo comente por favor.

4 comentarios:

  1. Me parece interesante tu solución, creo que haré algo similar.
    Una pregunta: si se crea la tabla, y tengo una tabla y un vista, ¿qué lee la entidad?.¿lo has probado?

    ResponderEliminar
  2. Me alegro de que te guste mi solución :-D

    Eso que comentas no puede ocurrir. En una base de datos no puede existir una tabla y vista con el mismo nombre, por lo que JPA no tendría porque elegir entre una y otra.

    ResponderEliminar
  3. Una opción es generar una unidad de persistencia distinta a la principal que actualiza el esquema, en la principal se deben listar todas las entidades que dominara y se debe agregar propiedad para excluir todas las entidades que no esten listadas en ella. La nueva unidad de persistencia, dejarla en modo lectura y listar la entidad asociada a la vista. De esa manera no se crea la tabla.

    ResponderEliminar
  4. Una opción es generar una unidad de persistencia distinta a la principal que actualiza el esquema, en la principal se deben listar todas las entidades que dominara y se debe agregar propiedad para excluir todas las entidades que no esten listadas en ella. La nueva unidad de persistencia, dejarla en modo lectura y listar la entidad asociada a la vista. De esa manera no se crea la tabla.

    ResponderEliminar