Deployment en Cocoon

Apache Cocoon 2: Motivaci�n, Introducci�n y Explicaci�n
Anterior	Cap�tulo 8. Desarrollo en Cocoon	Siguiente

8.3.1. Condiciones m�nimas

Es muy com�n tener varias aplicaciones bajo Cocoon, en cuyo caso es recomendable tener ficheros de configuraci�n aparte para el momento en el que se debe hacer deployment a cada aplicaci�n. Esto mejora la portabilidad y la escalabilidad de los productos.

Para poder lograr esto Cocoon provee una herramienta poderosa, el concepto de SubSitemap.

Un subsitemap no es m�s que un fichero sitemap para una parte en particular de una aplicaci�n de Cocoon.

Para poder utilizar esta t�cnica s�lo se deben tener en cuenta dos cosas:

Incluir en el sitemap general de Cocoon el subsitemap (y especificar a qu� y en d�nde se aplica ese subsitemap).
Incluir el subsitemap en el lugar correcto.

Para esta parte voy a trabajar con el ejemplo de la secci�n referente a contenido est�tico desarrollada al inicio de este cap�tulo (ver ).

Para esta aplicaci�n vamos a construir entonces un subsitemap en el directorio $MiAplicacion/, es decir, el fichero quedar� en la ruta $MiAplicacion/sitemap.xmap.

8.3.2. Inclusi�n de un subsitemap en el sitemap de Cocoon

En el fichero sitemap.xmap de Cocoon se deben a�adir las siguientes l�neas:

Ejemplo 8-9. C�digo para incluir un subsitemap

    
   <map:match pattern="MiAplicacion/*"> 
    <map:mount uri-prefix="MiAplicacion" check-reload="yes" src="$MiAplicacion/sitemap.xmap" 
	reload-method="synchron"/> 
   </map:match>

Bien, miremos un poco este c�digo para comprenderlo mejor:

En la l�nea match pattern="MiAplicacion/*" se le est� indicando a Cocoon que cualquier recurso que intente ser accedido por el URL http://localhost:8080/cocoon/MiAplicacion/ debe ser atendido con el fichero ubicado en $MiAplicacion/sitemap.xmap (esto se le est� indicando con el atributo src de la etiqueta mount, es decir, en la l�nea mount uri-prefix="MiAplicacion" check-reload="yes" src="$MiAplicacion/sitemap.xmap" )
Con el atributo uri-prefix le estamos diciendo que cuando siga el flujo del requerimiento del usuario al subsitemap no le pase la cadena MiAplicacion. Esto es l�gico, ya que para el subsitemap de MiAplicacion, todos los requerimientos que va a atender son de la aplicaci�n MiAplicacion, por lo cual incluirlo en cada uno de los pipelines del subsitemap ser�a redundante.
Con el atributo check-reload damos la opci�n de que Cocoon verifique cuando el subsitemap de MiAplicacion sea modificado para que lo vuelva a cargar. Si el valor del atributo es yes, chequea cada vez que sea modificado, si el valor es no s�lo carga el subsitemap cada vez que sea cargado Cocoon.
Por �ltimo, con el atributo reload-method le indicamos el modo como debe recargar el subsitemap. Si el valor es synchron, recarga el subsitemap cuando se le haga una solicitud y no muestra el resultado del requerimiento hasta que es recargado por completo, caso contrario a cuando el valor es asynchron ya que en este caso, aunque tambi�n recarga en el momento que se haga el requerimiento, deja mostrar el resultado del requerimiento mientras va recargando el fichero. Es de tener en cuenta aqu�, que como el subsitemap no ha sido recargado en el momento que se muestra el resultado de la solicitud del usuario (cuando muestra el resultado empieza a ejecutar el proceso que lo recarga), el resultado mostrado no estar� actualizado con respecto al estado actual de la aplicaci�n, s�lo hasta que sea pedido en la siguiente ocasi�n.

En ambientes de desarrollo es bastante �til tener la opci�n de que cada vez que se haga un cambio, �ste se pueda reflejar de forma inmediata. Sin embargo en ambientes de producci�n es mejor tener configurado que los cambios se reflejen una vez el servicio se baje y se vuelva a restaurar; �sto es para no perjudicar a los usuarios de la aplicaci�n quienes podr�an tener la impresi�n de una aplicaci�n lenta.

Mejor a�n si crea una copia de la aplicaci�n, para tener una en producci�n y otra en desarrollo para hacer las pruebas. Para conocer como crear una aplicaci�n en Cocoon consulte la sugerencia que est� al final de la secci�n Secci�n 6.2.2

8.3.3. C�digo del `subsitemap`

El subsitemap, el cual debe estar ubicado como ya se dijo en la ruta $MiAplicacion/ debe seguir el siguiente estilo:

Ejemplo 8-10. C�digo b�sico de un subsitemap

    
<?xml version="1.0"?>
<map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0">
	<!-- =========================== Components ================================ -->
	<map:components>
		<map:generators default="file"/>
		<map:transformers default="xslt"/>
		<map:readers default="resource"/>
		<map:serializers default="html"/>
		<map:selectors default="browser"/>
		<map:matchers default="wildcard"/>

	</map:components>
	<!-- =========================== Pipelines ================================= -->
	<map:pipelines>
		<map:pipeline>

                        <map:match pattern="index.html">
                               <map:generate type="file" src="$MiAplicacion/XML/index.xml"/>
                               <map:transform type="xslt" src="$MiAplicacion/XSL/HTML/index.xsl"/>
                        </map:match>

			<map:handle-errors>
				<map:transform src="../stylesheets/system/error2html.xsl"/>
				<map:serialize status-code="500"/>
			</map:handle-errors>
		</map:pipeline>
	</map:pipelines>
</map:sitemap>

Miremos un poco este subsitemap:

En las l�neas:


    
	<!-- =========================== Components ================================ -->
	<map:components>
		<map:generators default="file"/>
		<map:transformers default="xslt"/>
		<map:readers default="resource"/>
		<map:serializers default="html"/>
		<map:selectors default="browser"/>
		<map:matchers default="wildcard"/>

	</map:components>

se est�n declarando los componentes del subsitemap y se est� diciendo con el atributo default que para la aplicaci�n en cuesti�n los componentes predeterminados son los que se declararon con el valor de dicho atributo en el sitemap general de Cocoon.

Por otro lado, en las l�neas:


    
	<map:pipelines>
		<map:pipeline>
                        <map:match pattern="index.html">
                               <map:generate type="file" src="$MiAplicacion/XML/index.xml"/>
                               <map:transform src="$MiAplicacion/XSL/HTML/index.xsl"/>
                        </map:match>

			<map:handle-errors>
				<map:transform src="../stylesheets/system/error2html.xsl"/>
				<map:serialize status-code="500"/>
			</map:handle-errors>
		</map:pipeline>
	</map:pipelines>

se est�n declarando los pipelines. Esto se hace de igual forma que como se hace en el sitemap general de Cocoon.

F�jese que en la l�nea


		<map:match pattern="index.html">

se est� diciendo que si se hace una solicitud de la p�gina index.html, tome los datos del documento index.xml y le aplique la transformaci�n dada en index.xsl. Lo importante aqu� es observar que esta p�gina ser� mostrada cuando se cargue la direcci�n http://localhost:8080/cocoon/MiAplicacion/index.html ya que el subsitemap esta dentro de $MiAplicacion y en el sitemap general se dijo que la cadena $MiAplicacion ser�a truncada.

Anterior	Inicio	Siguiente
Contenido Din�mico	Subir	Formato de reuni�n semanal

8.3. Deployment en Cocoon

8.3.1. Condiciones m�nimas

8.3.2. Inclusi�n de un subsitemap en el sitemap de Cocoon

8.3.3. C�digo del subsitemap

8.3.3. C�digo del `subsitemap`