Diferencia entre revisiones de «SiteMesh 2»
(→Instalar SiteMesh Manualmente) |
(→Configurando SiteMesh) |
||
| Línea 48: | Línea 48: | ||
En los siguientes pasos explicaremos como implementar un ejemplo simple en un proyecto existente: | En los siguientes pasos explicaremos como implementar un ejemplo simple en un proyecto existente: | ||
| − | + | 1. Crear la página '''menu.jsp''' dentro de una carpeta nueva llamada data en el directorio de contenido web (generalmente web) con el siguiente contenido. | |
<pre> | <pre> | ||
<h1>Beverages</h1> | <h1>Beverages</h1> | ||
| Línea 57: | Línea 57: | ||
</pre> | </pre> | ||
| − | + | 2. Crear la página '''hours.jsp''' en la misma ubicación que la página anterior con este contenido. | |
<pre> | <pre> | ||
<h1>Weekdays</h1> | <h1>Weekdays</h1> | ||
| Línea 65: | Línea 65: | ||
</pre> | </pre> | ||
| − | + | 3. Crear la página de layout ('''basic-theme.jsp''')en la misma carpeta con el siguiente contenido. | |
<pre> | <pre> | ||
<?xml version="1.0" encoding="UTF-8" ?> | <?xml version="1.0" encoding="UTF-8" ?> | ||
| Línea 88: | Línea 88: | ||
''El tag decorator:body será reemplazado por el contenido de la página a "decorar".'' | ''El tag decorator:body será reemplazado por el contenido de la página a "decorar".'' | ||
| − | + | 4. Configurar el archivo decorator.xml de la siguiente forma | |
<pre> | <pre> | ||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | ||
| Línea 100: | Línea 100: | ||
''Con esta configuración estamos indicando que se aplique el decorador '''basic-theme.jsp''' a todas los contenidos previamente creados en la carpeta "/data".'' | ''Con esta configuración estamos indicando que se aplique el decorador '''basic-theme.jsp''' a todas los contenidos previamente creados en la carpeta "/data".'' | ||
| − | + | 5. Por último es necesario reiniciar el servidor, para que tome los cambios realizados en el proyecto, y luego al acceder a alguna de las páginas '''menu.jsp''' o '''hours.jsp''' se visualizarán sus contenidos decorados con el layout configurado ('''basic-theme.jsp''') | |
== Nuestra experiencia == | == Nuestra experiencia == | ||
Revisión del 15:44 14 sep 2012
Contenido
Qué es SiteMesh
Es un framework Java para aplicaciones web que aplica el patrón de diseño Decorator para permitir la separación de contenido en la capa de presentación.
Con este framework se puede definir la distribución de contenido (layout) de la vista y componerla en base a páginas simples, las cuales conformarán una página compleja (decorada) justo antes de enviarse al cliente.
Para qué se usa
SiteMesh utiliza Filters disponibles a partir de la versión 2.3 de Java Servlet.
- SiteMesh intercepta las peticiones de todas las paginas HTML generadas, procesa el contenido y lo "decora" para obtener el resultado final.
- También puede generar una pagina compleja a partir de varias pequeñas.
Cómo se implementa
Instalar SiteMesh Manualmente
Seguir estos 3 pasos:
1. Agregar la biblioteca SiteMesh jar en WEB-INF/lib 2. Configurar el siguiente filtro en el archivo WEB-INF/web.xml, dentro del tag <web-app>
<filter> <filter-name>sitemesh</filter-name> <filter-class>com.opensymphony.sitemesh.webapp.SiteMeshFilter</filter-class> </filter> <filter-mapping> <filter-name>sitemesh</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>
3. Crear el archivo decorators.xml en el directorio WEB-INF con el siguiente contenido
<?xml version="1.0" encoding="UTF-8"?> <decorators> </decorators>
Hasta acá la aplicación debe seguir funcionando normalmente, ya que no se esta implementando ningún decorators aún.
Configurando SiteMesh
Según el propio sitio de SiteMesh la mejor forma para entender esta biblioteca es usándola.
En los siguientes pasos explicaremos como implementar un ejemplo simple en un proyecto existente:
1. Crear la página menu.jsp dentro de una carpeta nueva llamada data en el directorio de contenido web (generalmente web) con el siguiente contenido.
<h1>Beverages</h1> <p>Cappucino $3.25</p> <p>Latte $3.35</p> <p>Espresso $2.00</p> <p>Mocha $3.50</p>
2. Crear la página hours.jsp en la misma ubicación que la página anterior con este contenido.
<h1>Weekdays</h1> <p>5:00pm - 10:00pm</p> <p>Weekends</p> <p>5:00pm - 10:00pm</p>
3. Crear la página de layout (basic-theme.jsp)en la misma carpeta con el siguiente contenido.
<?xml version="1.0" encoding="UTF-8" ?>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title></title>
</head>
<body>
<h1>Header</h1>
<p><b>Navigation</b></p>
<hr />
<decorator:body />
<hr />
<h1>Footer</b></h1>
</body>
</html>
El tag decorator:body será reemplazado por el contenido de la página a "decorar".
4. Configurar el archivo decorator.xml de la siguiente forma
<?xml version="1.0" encoding="UTF-8"?>
<decorators defaultdir="/decorators">
<decorator name="basic-theme" page="basic-theme.jsp">
<pattern>/data/*</pattern>
</decorator>
</decorators>
Con esta configuración estamos indicando que se aplique el decorador basic-theme.jsp a todas los contenidos previamente creados en la carpeta "/data".
5. Por último es necesario reiniciar el servidor, para que tome los cambios realizados en el proyecto, y luego al acceder a alguna de las páginas menu.jsp o hours.jsp se visualizarán sus contenidos decorados con el layout configurado (basic-theme.jsp)
