Aplicaciones web con base de datos en Tomcat 5.5 / 6.0, y Glassfish v2
La mayoría de las veces, las aplicaciones web que desarrollamos deben estar conectada a una base de datos. Hemos aprendido que con Java podemos lograr una conexión a la base de datos usando estas dos líneas básicas:
Una aplicación web puede ser accedida por varios usuarios a la vez, y si nuestra aplicación web utiliza estas sentencias, podremos saturar la conexión a la base de datos. Se podría sobrecargar de conexiones y nuestra aplicación podría caerse. Le ponemos puros .close() por todos lados, y de cuando en cuando aparecerá el error: "La conexión se ha cerrado". Entonces, tendremos que pensar un sistema de semáforo para poder tomar y liberar la base de datos dependiendo de la carga de conexiones. Nuestra aplicación web ya deja de serlo porque nos centramos en la administración del recurso. Y finalmente tiramos la toalla porque se está volviendo muy complejo algo que debería ser simple. Vaya, y solo por esas dos líneas.
Esto no es nada nuevo. Al inicio se encontró esos problemas, y también salieron las soluciones. Es usar un Pool de Conexiones de base de datos.
Lo que se explicará en este post es cómo hacer una aplicación web utilizando una conexión a base de datos de una manera profesional. Ya no con esas dos líneas. Dejaremos que la conexión a la base de datos (usando un pool de conexión) se haga cargo el contenedor web (o de aplicaciones).
Aunque en este post se tratará de ser lo más independientemente posible con lo que respecta a los IDEs, se mencionará a NetBeans 6.01 y Eclipse 3.3 como referencia.
La secuencia que usaremos será simple:
El index.jsp es bastante simple:
Y resultado.jsp es este:
El servlet será algo como esto. ListarServlet.java:
Vemos que las dos lineas de conexión de la base de datos que vimos al inicio de este post, fueron reemplazados por
Para el caso del Tomcat 5.5 y 6, existe un archivo llamado context.xml ubicando dentro de la carpeta META-INF. Si no existe, lo podemos crear con toda confianza.
Este archivo indica cómo debe desplegarse la aplicación web cuando se cargado al Tomcat. El NetBeans lo crea automáticamente. En el Eclipse lo podemos crear.
La documentación para esta archivo se encuentra aquí:
Bien, el archivo context.xml deberá tener lo siguiente.
Se pueden identificar algunos atributos como username, password, driverClassName y url. En vez declararse en la clase java (como vimos al inicio de este post), lo colocamos en este .xml. Si necesitácemos cambiar de base de datos (por ejemplo, ya no será localhost, sino se encuentra en otro host) solo editamos el atributo correspondiente.
Con esto, la aplicación funciona (al menos a mi). Pero he leido mucha documentación (incluyendo la del mismo Tomcat) que se debe agregar unos tags al archivo web.xml. Y son los siguientes.
Para comenzar, debemos cambiar el servidor de ejecución de nuestra aplicación. En NetBeans, entramos a las propiedades del proyecto, y en la categoría Run cambiamos a Glassfish.
Y si estamos en Eclipse, entramos a las propiedades del proyecto y cambiamos la biblioteca del Runtime Server de Tomcat a Glassfish.
Nota: no olvidemos copiar el .jar del JDBC de la base de datos en $GLASSFISH/domains/domain1/lib
Si usamos NetBeans, el IDE creará automáticamente el archivo WEB-INF/sun-web.xml Si estamos usando Eclipse, lo crearemos utilizando este contenido.
Para ello entramos a la consola en http://localhost:4848 (por omisión, el usuario es admin y la contraseña adminadmin). Luego, en el panel de la izquierda seleccionamos Resources > JDBC > Connection Pools y hacemos clic en el botón superior "New". Escribimos los valores para identificar nuestro Pool que crearemos a continuación:
Damos clic en Next. Y en la siguiente ventana buscaremos las propiedades necesarias para establacer la conexión a la base de datos. Es decir: url, user, password, ServerName (=localhost), databasename(=DatabaseName). Hacemos clic en Finish.
Podemos hacer clic al Pool recién creado, y le damos clic en el botón "Ping" para ver si está bien configurado.
Ahora, debemos crear el Recurso JDBC. Para ello, en el panel izquierdo entramos a Resources > JDBC > JDBC Resources y le damos clic en "New".
Escribimos los valores que hagan referencia al Pool que acabamos de crear. Recordemos que el nombre del JNDI debe ser ser el mismo que hacemos referencia en web.xml.
Y listo. Lo ejecutamos y veremos que la aplicación funciona normal. ¿Qué hemos modificado en la aplicación? solo hemos creado un archivo de despliegue, pero en la lógica de la aplicación.... nada.
Class.forName("clase.driver.Driver");
Connection conn=DriverManager.getConnection("url:jdbc","usuario","pass");
Una aplicación web puede ser accedida por varios usuarios a la vez, y si nuestra aplicación web utiliza estas sentencias, podremos saturar la conexión a la base de datos. Se podría sobrecargar de conexiones y nuestra aplicación podría caerse. Le ponemos puros .close() por todos lados, y de cuando en cuando aparecerá el error: "La conexión se ha cerrado". Entonces, tendremos que pensar un sistema de semáforo para poder tomar y liberar la base de datos dependiendo de la carga de conexiones. Nuestra aplicación web ya deja de serlo porque nos centramos en la administración del recurso. Y finalmente tiramos la toalla porque se está volviendo muy complejo algo que debería ser simple. Vaya, y solo por esas dos líneas.
Esto no es nada nuevo. Al inicio se encontró esos problemas, y también salieron las soluciones. Es usar un Pool de Conexiones de base de datos.
Lo que se explicará en este post es cómo hacer una aplicación web utilizando una conexión a base de datos de una manera profesional. Ya no con esas dos líneas. Dejaremos que la conexión a la base de datos (usando un pool de conexión) se haga cargo el contenedor web (o de aplicaciones).
Aunque en este post se tratará de ser lo más independientemente posible con lo que respecta a los IDEs, se mencionará a NetBeans 6.01 y Eclipse 3.3 como referencia.
Nuestra aplicación web
Nuestra aplicación web no será algo fuera de este mundo. Puedes usar una base de datos que ya estés usando. En mi caso usaré una base de datos en MySQL.La secuencia que usaremos será simple:
- Al ejecutarse la aplicación, se mostrará el /index.jsp. Este redireccionará al servlet /Listar
- El servlet /Listar se conectará a la base de datos, obtendrá una consulta, y el resultado lo pondrá en una variable de sesión.
- El servlet redireccionará la petición a /resultado.jsp quien mostrará el resultado al usuario.
El index.jsp es bastante simple:
<jsp:forward page="/Listar" />
Y resultado.jsp es este:
<%@page contentType="text/html" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>JSP Page</title>
</head>
<body>
<h2>Resultado</h2>
${resultado}
</body>
</html>
El servlet será algo como esto. ListarServlet.java:
public class ListarServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException{
try {
Context ctx = new InitialContext();
DataSource ds=(DataSource) ctx.lookup("java:comp/env/jdbc/TestDB");
Connection conn=ds.getConnection();
Statement stmt=conn.createStatement();
ResultSet rs=stmt.executeQuery("SELECT count(*) as cuenta FROM padron");
int result=0;
if (rs.next())
result=rs.getInt("cuenta");
request.setAttribute("resultado", result);
RequestDispatcher rd=getServletContext().getRequestDispatcher("/resultado.jsp");
rd.forward(request, response);
conn.close();
} catch (SQLException ex) {
ex.printStackTrace();
} catch (NamingException ex) {
ex.printStackTrace();
}
}
}
Vemos que las dos lineas de conexión de la base de datos que vimos al inicio de este post, fueron reemplazados por
Context ctx = new InitialContext();
DataSource ds=(DataSource) ctx.lookup("java:comp/env/jdbc/TestDB");
Connection conn=ds.getConnection();
Para el caso del Tomcat 5.5 y 6, existe un archivo llamado context.xml ubicando dentro de la carpeta META-INF. Si no existe, lo podemos crear con toda confianza.
Este archivo indica cómo debe desplegarse la aplicación web cuando se cargado al Tomcat. El NetBeans lo crea automáticamente. En el Eclipse lo podemos crear.
La documentación para esta archivo se encuentra aquí:
- Tomcat 5.5: http://tomcat.apache.org/tomcat-5.5-doc/config/context.html
- Tomcat 6: http://tomcat.apache.org/tomcat-6.0-doc/config/context.html
Bien, el archivo context.xml deberá tener lo siguiente.
<?xml version="1.0" encoding="UTF-8"?>
<Context path="/demoweb" reloadable="true" crossContext="true">
<Resource name="jdbc/TestDB"
auth="Container"
type="javax.sql.DataSource"
maxActive="100"
maxIdle="30"
maxWait="10000"
username="user"
password="pass"
driverClassName="com.mysql.jdbc.Driver"
url="jdbc:mysql://localhost:3306/javatest?autoReconnect=true"/>
</Context>
Se pueden identificar algunos atributos como username, password, driverClassName y url. En vez declararse en la clase java (como vimos al inicio de este post), lo colocamos en este .xml. Si necesitácemos cambiar de base de datos (por ejemplo, ya no será localhost, sino se encuentra en otro host) solo editamos el atributo correspondiente.
Con esto, la aplicación funciona (al menos a mi). Pero he leido mucha documentación (incluyendo la del mismo Tomcat) que se debe agregar unos tags al archivo web.xml. Y son los siguientes.
<resource-ref>
<res-ref-name>jdbc/TestDB</res-ref-name>
<res-type>javax.sql.DataSource</res-type>
<res-auth>Container</res-auth>
<res-sharing-scope>Shareable</res-sharing-scope>
</resource-ref>
Configurando para que se ejecute en Glassfish.
Ahora, imaginemos que debamos utilizar nuestra aplicación en un contenedor de aplicaciones en el cual ya se tiene configurada la conexión a la base de datos. Y el estándar de la organización en que estamos trabajando es el Glassfish. (Aún no me resulta con JBoss 5, así que lo dejaré para otra ocasión)Para comenzar, debemos cambiar el servidor de ejecución de nuestra aplicación. En NetBeans, entramos a las propiedades del proyecto, y en la categoría Run cambiamos a Glassfish.
Y si estamos en Eclipse, entramos a las propiedades del proyecto y cambiamos la biblioteca del Runtime Server de Tomcat a Glassfish.
Nota: no olvidemos copiar el .jar del JDBC de la base de datos en $GLASSFISH/domains/domain1/lib
Si usamos NetBeans, el IDE creará automáticamente el archivo WEB-INF/sun-web.xml Si estamos usando Eclipse, lo crearemos utilizando este contenido.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sun-web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Application Server 9.0 Servlet 2.5//EN" "http://www.sun.com/software/appserver/dtds/sun-web-app_2_5-0.dtd">
<sun-web-app error-url="">
<context-root>/demoweb</context-root>
<class-loader delegate="true"/>
<jsp-config>
<property name="keepgenerated" value="true">
<description>Keep a copy of the generated servlet class java code.</description>
</property>
</jsp-config>
</sun-web-app>
Para ello entramos a la consola en http://localhost:4848 (por omisión, el usuario es admin y la contraseña adminadmin). Luego, en el panel de la izquierda seleccionamos Resources > JDBC > Connection Pools y hacemos clic en el botón superior "New". Escribimos los valores para identificar nuestro Pool que crearemos a continuación:
Damos clic en Next. Y en la siguiente ventana buscaremos las propiedades necesarias para establacer la conexión a la base de datos. Es decir: url, user, password, ServerName (=localhost), databasename(=DatabaseName). Hacemos clic en Finish.Podemos hacer clic al Pool recién creado, y le damos clic en el botón "Ping" para ver si está bien configurado.
Ahora, debemos crear el Recurso JDBC. Para ello, en el panel izquierdo entramos a Resources > JDBC > JDBC Resources y le damos clic en "New".Escribimos los valores que hagan referencia al Pool que acabamos de crear. Recordemos que el nombre del JNDI debe ser ser el mismo que hacemos referencia en web.xml.
Y listo. Lo ejecutamos y veremos que la aplicación funciona normal. ¿Qué hemos modificado en la aplicación? solo hemos creado un archivo de despliegue, pero en la lógica de la aplicación.... nada.
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/