Usando o Tiles 2

Baixe os arquivos do tiles 2 do repositorio maven ou verifique a versão mais nova no homepage do tiles2.

Além disso, você deverá ter no seu diretório /WEB-INF/lib os seguintes jars do jarkata commons project:

  • commons-beanutils-1.7.0
  • commons-collections-2.1
  • commons-digester-1.7

web.xml

Para usar tiles2 temos que adicionar o servlet no web.xml. Configure o arquivo web.xml conforme abaixo:

<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
        <display-name>Nome da aplicação</display-name>

        <context-param>
                <param-name>javax.servlet.jsp.jstl.fmt.localizationContext </param-name>
                <param-value>messages</param-value>
        </context-param>

        <servlet>
                <servlet-name>vraptor2</servlet-name>
                <servlet-class>org.vraptor.VRaptorServlet</servlet-class>
            <load-on-startup>1</load-on-startup>
        </servlet>

        <servlet-mapping>
                <servlet-name>vraptor2</servlet-name>
                <url-pattern>*.logic</url-pattern>
        </servlet-mapping>


        <!--servlet do tiles2 -->
        <servlet>
                <servlet-name>tiles</servlet-name>
                <servlet-class>org.apache.tiles.servlet.TilesServlet</servlet-class>
                <init-param>
                        <param-name>definitions-config</param-name>
                        <param-value>/WEB-INF/tiles-defs.xml</param-value>
                </init-param>
                <load-on-startup>2</load-on-startup> 
        </servlet>      


        <welcome-file-list>
                <welcome-file>index.jsp</welcome-file>
        </welcome-file-list>
</web-app>

O Layout - /template/layout.jsp

Vamos criar nosso Layout num arquivo layout.jsp. Nesse exemplo usaremos uma tabela, que usa tags do tiles que são substituidos dinamicamente.

Coloque o arquivo no diretório /templates/ (como todos os outros jsps) da sua aplicação web.

<%@ taglib uri="http://struts.apache.org/tags-tiles" prefix="tiles" %>
<head>
        <title><tiles:getAsString name="title"/>
        </title>
</head>
<body>
<table> 
<tr>
        <td>
                <tiles:attribute name="header"/>
        <td>
</tr>
<tr>
        <td>
                <tiles:attribute name="body"/>
        </td>
</tr>
</table>
</body>
</html>

Dividímos a página em duas áreas, header e body.

Na composição do layout nada muda para o Tiles 1.

header e body - /template/header.jsp e /template/body.jsp

Crie um arquivo header.jsp, por exemplo:

<b>VRaptor com tiles2</b>

E também crie um arquivo body.jsp, por exemplo:

Corpo da página

tiles-defs.xml

O arquivo tiles-defs.xml define o mapeamento entre os templates. Configure-o na pasta /WEB-INF/ com a seguinte estrutura:

<?xml version="1.0" encoding="ISO-8859-1" ?>
 <!DOCTYPE tiles-definitions PUBLIC
       "-//Apache Software Foundation//DTD Tiles Configuration 2.0//EN"
       "http://struts.apache.org/dtds/tiles-config_2_0.dtd">

<tiles-definitions>

    <definition name="base.layout" template="/templates/layout.jsp">
        <put name="title"  value=":: Tiles with Vraptor ::" />
        <put name="header" value="/templates/header.jsp" />
        <put name="body"   value="/templates/body.jsp" />
    </definition>

</tiles-definitions>

A versão do dtd deverá ser 2.0, não copie o tiles-defs.xml de outra versão.

Repare que ele difere um pouco da versão 1, onde é template era layout.

index.jsp

Para usar seu layout crie um jsp que irá chamá-lo usando o tag tiles:insertDefinition. . Vamos chamar a pagina index.jsp:

<%@ taglib uri="http://struts.apache.org/tags-tiles" prefix="tiles" %>

<tiles:insertDefinition name="base.layout"/>

Esta tag também mudou, agora usa-se tiles:insertDefinition name="" onde name é o nome do template definido no tiles-defs.xml

Pronto, já pode usar o Tiles com o Vraptor.


Configuração

Para esse tutorial usamos:

  • JDK 1.5 e JDK 1.6
  • Tomcat 5.5.17
  • Vraptor 2.3