Apache Cocoon 2: Motivación, Introducción y Explicación
AnteriorCapítulo 8. Desarrollo en CocoonSiguiente

8.2. Contenido Dinámico

8.2.1. Dando lógica con programación en Java

Atención

En Construcción

8.2.2. Acceso a bases de datos

Para acceder una base de datos usted debe tener en cuenta tres pasos:

  1. Configurar el Data Source para acceder la base datos.

    Ésto lo debe hacer en al fichero cocoon.xconf añadiendo las siguientes líneas en la etiqueta datasources

    Ejemplo 8-2. Código para definir un Data Source para acceso a una base de datos

    
    
    <jdbc name="nombreBD">
      <pool-controller min="0" max="10"/>
      <dburl>urlParaConexionABaseDeDatos</dburl>
      <user>NombreUsuario</user>
      <password>contraseñaUsuario</password>
    </jdbc>

    Donde nombreBD es el nombre que se le dará al Data Source, NombreUsuario es el nombre de un usuario registrado en la Base de Datos con el cual se llevará a cabo la conexión y contraseñaUsuario es la contraseña del usuario NombreUsuario con la cual se validará dicho usuario

  2. Configurar el fichero web.xml

    Para que cargue el driver e incluir el driver de tal forma que Cocoon tenga un lugar desde donde cargarlo.

    Para configurar el web.xml con ayuda de la etiqueta init-param y la etiqueta hija de ésta, param-name con valor load-class enunciando dentro de esta última el nombre del driver y separando el nombre de los distintos drivers por coma o espacio. Por ejemplo, para incluir un driver para Oracle y otro para IBM WebSphere las líneas de código que deberían verse en el fichero web.xml serían:

    Ejemplo 8-3. Código para cargar clases para acceso a bases de datos.

    
    
    <init-param>
      <param-name>load-class</param-name>
      <param-value>

        <!-- Para Oracle: -->
        oracle.jdbc.driver.OracleDriver 

        <!-- Para IBM WebSphere: -->
        com.ibm.servlet.classloader.Handler 

	<!-- For parent ComponentManager sample:
        org.apache.cocoon.samples.parentcm.Configurator
        -->
      </param-value>
    </init-param>

    Nota

    Si usted está utilizando la Base de Datos que viene con Cocoon (hsql)este paso no es necesario

  3. Si va a utilizar hsql debe añadir las instrucciones de base de datos que necesite su aplicación, tales como sentencias de autenticación, de creación de tablas, de inserciones de datos, etc. Esto lo debe hacer en el fichero cocoondb.script ubicado en la ruta COCOON_HOME/WEB-INF/db/

    Para nuestro caso se añadieron las siguientes líneas:

    Ejemplo 8-4. Ejemplo de Código de Base de Datos necesario a incluir con la Base de Datos hsql

    
CREATE USER usuario PASSWORD "contrasena" ADMIN
CONNECT USER usuario PASSWORD "contrasena"
CREATE TABLE PRUEBAS(ID INTEGER,NAME VARCHAR,UNIQUE(ID))
INSERT INTO PRUEBAS VALUES(1,'Prueba 1')
INSERT INTO PRUEBAS VALUES(1,'Prueba 2')

    con lo cual se está dando la posibilidad al usuario usuario con contraseña contrasena hacer operaciones sobre la tabla Pruebas, la cuál tiene 2 registros.

8.2.2.1. Etiquetas SQL y ESQL

Para la construcción de páginas XSP, contamos con dos tipos de etiquetas, SQL y ESQL.

La diferencia radica en que ESQL siendo más nuevo, presta mayores funcionalidades como combinar distintos tipos de hojas de estilos, soporte para prepared statements y manejo de varios resultsets en una sola sentencia, entre otras cosas. De ahí su nombre, Extended SQL.

A continuación presentaré dos ejemplos con estas tecnologías para analizar y tener en cuenta cómo funciona cada una.

8.2.2.1.1. Ejemplo con uso de etiqueta SQL

  1. Añada un pipeline en el sitemap que sea de la forma:

    Ejemplo 8-5. Pipeline necesario para una XSP con etiquetas SQL y acceso a una Base de Datos

    
    
   <map:match pattern="MiXSP/MiEjemploXspSql">
    <map:generate src="$MiAplicacion/MiEjemploXspSql"/>
    <map:transform type="sql">
      <map:parameter name="use-connection" value="MiConexion"/>
    </map:transform>
    <map:transform src="stylesheets/simple-sql2html.xsl"/>
    <map:serialize/>
   </map:match>

    Nota

    Para este caso, estamos indicando que el transformador es de tipo sql y que se debe usar una conexión llamada MiConexion. Es decir, estamos indicando desde el sitemap el nombre de la conexión

Teniendo en cuenta todo lo anteriormente expuesto, se pueden escribir páginas con etiquetas sql.

Ejemplo 8-6. Código de una XSP con conexión a Base de datos con etiqueta SQL


    
	<?xml version="1.0"?>

	<page xmlns:sql="http://apache.org/cocoon/SQL/2.0">

	 <title>Una Prueba con SQL</title>
	 <content>
	  <para>Una página con SQL</para>

	  <execute-query xmlns="http://apache.org/cocoon/SQL/2.0"> 
	   <query>
		select id, name from PRUEBAS
	   </query>
	   <execute-query>
	    <query>
		select id, name from PRUEBAS
	    </query>
	   </execute-query>
	  </execute-query>

	 </content>
	</page>

8.2.2.1.2. Ejemplo con uso de etiqueta ESQL

  1. Añada un pipeline en el sitemap que sea de la forma:

    Ejemplo 8-7. Pipeline necesario para una XSP con etiquetas ESQL y acceso a una Base de Datos

    
    
   <map:match pattern="MiXSP/MiEjemploXspEsql">
    <map:generate type="serverpages" src="$MiAplicacion/MiEjemploXspEsql.xsp"/>
    <map:transform src="stylesheets/dynamic-page2html.xsl">
    </map:transform>
    <map:serialize/>
   </map:match>

    Nota

    Para este caso, estamos indicando que el generador es de tipo serverpages.

Teniendo en cuenta todo lo anteriormente expuesto, se pueden escribir páginas con etiquetas sql.

Ejemplo 8-8. Código de una XSP con conexión a Base de datos con etiqueta ESQL


    
	<?xml version="1.0" encoding="ISO-8859-1"?>

	<xsp:page
		  language="java"
		  xmlns:xsp="http://apache.org/xsp"
		  xmlns:esql="http://apache.org/cocoon/SQL/v2"
	>

	  <page>

	   <title>Una prueba con ESQL</title>

	   <content>

	   <esql:connection>
	     <esql:pool>MiConexion</esql:pool>
	     <esql:execute-query>
	       <esql:query>select * from PRUEBAS</esql:query>
	       <esql:results>
		 <esql:row-results>
		   <para><esql:get-string column="name"/></para>
		 </esql:row-results>
	       </esql:results>
	     </esql:execute-query>
	   </esql:connection>

	   </content>
	  </page>
	</xsp:page>

Nota

Note que en este caso, es en la página XSP en donde se define el nombre de la conexión.

Como usted ya se habrá podido dar cuenta, la diferencia en implementación entre ambas tecnologías es mínima. Dependiendo de las necesidades de su aplicación puede escojer entre ambas, teniendo en cuenta las potencialidades de ESQL y el desconocimiento que existe aún por su poco tiempo de vida en el mundo del software.

AnteriorInicioSiguiente
Desarrollo en CocoonSubirDeployment en Cocoon