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