Spring 2.5.1 MVC + Tiles 2.0.5 基本配置

我只要想起来就去看看Turbine，但真的很令人失望，自2.3.2以后，好多年没有更新了，与之相关的项目比如maven都发展的很快，甚至不支持Turbine了。

Tiles不是另一种渲染技术，而是一种视图布局技术，这个跟Turbine的布局很相似，甚至更强大。

我使用MyEclipse6.0的Add Spring Capabilities功能加入Spring MVC等所依赖的库，发现已经支持Spring 2.0了。很高兴哦！

当我兴致高昂的从http://tiles.apache.org下载了tiles的jar包，并且按照google上搜到的一篇教程http://esffor.javaeye.com/blog/96052进行部署，却怎么也测试不成功。
页面中的<tiles:getAsString name="title" />和<tiles:insertAttributename="header" />都无法正常输出，日志打印出TilesContainer not initialized的异常信息。

我已经注意到：

<definition name="template" page="/WEB-INF/tiles/mainTemplate.jsp">
    <put name="title" value="default title"/>
    <put name="header" value="/WEB-INF/tiles/header.jsp"/>
    <put name="content" value="/WEB-INF/tiles/content.jsp"/>
    <put name="footer" value="/WEB-INF/tiles/footer.jsp"/>
</definition>

在tiles2中必须改为：

<definition name="template"
    template="/WEB-INF/tiles/mainTemplate.jsp">
    <put-attribute name="title" type="string" value="default title" />
    <put-attribute name="header" type="template"
        value="/WEB-INF/tiles/header.jsp" />
    <put-attribute name="content" type="template"
        value="/WEB-INF/tiles/content.jsp" />
    <put-attribute name="footer" type="template"
        value="/WEB-INF/tiles/footer.jsp" />
</definition>

网络上使用Spring mvc+tiles的案例和文章极少，我怀疑是Spring 2.0不支持tiles2，但是在tiles的官网上已经找不到更早的版本了。

幸运的是，Spring官网已经发布了2.5.1，在官网2.5.1文档http://static.springframework.org/spring/docs/2.5.x/reference/view.html#view-tiles中，我看到了

14.3. Tiles

It is possible to integrate Tiles - just as any other viewtechnology - in web applications using Spring. The following describesin a broad way how to do this.

NOTE: This section focuses on Spring's support for Tiles 2 (the standalone version of Tiles, requiring Java 5+) in the org.springframework.web.servlet.view.tiles2package. Spring also continues to support Tiles 1.x (a.k.a. "StrutsTiles", as shipped with Struts 1.1+; compatible with Java 1.4) in theoriginal org.springframework.web.servlet.view.tiles package.

14.3.1. Dependencies

To be able to use Tiles you have to have a couple of additionaldependencies included in your project. The following is the list ofdependencies you need.

• Tiles version 2.0.4 or higher

• Commons BeanUtils

• Commons Digester

• Commons Logging

These dependencies are all available in the Spring distribution.

看来我的怀疑是正确的。

以下是Spring 2.5.1 MVC + Tiles 2.0.5的配置：

---

从sourceforge下载spring-framework-2.5.1-with-dependencies.zip，并从中拉出以下jar文件（最小化依赖）
#spring 2.5.1
commons-logging.jar
log4j-1.2.14.jar

spring-beans.jar
spring-core.jar
spring-context.jar

spring-web.jar
spring-webmvc.jar

#with tiles 2.0.5
commons-beanutils-1.7.0.jar
commons-digester-1.8.jar

tiles-core-2.0.5.jar
tiles-api-2.0.5.jar
tiles-jsp-2.0.5.jar

jstl.jar

#当然，除此之外还需要为web工程加入j2ee 1.4的Libraries和JDK1.5或以上的Libraries。

步骤：
1、最好配置好log4j，便于在配置过程中排错。
2、修改web.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<web-app 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">
    <servlet>
        <servlet-name>training</servlet-name>
        <servlet-class>
            org.springframework.web.servlet.DispatcherServlet
        </servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>training</servlet-name>
        <url-pattern>*.htm</url-pattern>
    </servlet-mapping>
    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>
</web-app>

3、在WEB-INF目录下增加training-servlet.xml文件，修改其内容为：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN 2.0//EN" "http://www.springframework.org/dtd/spring-beans-2.0.dtd">
<!-- Application context definition for "example" DispatcherServlet.  -->
<beans>
    <bean name="/home.htm" class="Action.TilesHomeController"></bean>
    <bean id="viewResolver"
        class="org.springframework.web.servlet.view.UrlBasedViewResolver">
        <property name="viewClass"
            value="org.springframework.web.servlet.view.tiles2.TilesView" />
    </bean>
    <bean id="tilesConfigurer"
        class="org.springframework.web.servlet.view.tiles2.TilesConfigurer">
        <property name="definitions">
            <list>
                <value>/WEB-INF/defs/tiles-def.xml</value>
            </list>
        </property>
    </bean>
</beans>

4、在WEB-INF目录下增加defs/tiles-def.xml，其内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE tiles-definitions PUBLIC
       "-//Apache Software Foundation//DTD Tiles Configuration 2.0//EN"
       "http://tiles.apache.org/dtds/tiles-config_2_0.dtd">
<tiles-definitions>
    <definition name="template"
        template="/WEB-INF/tiles/mainTemplate.jsp">
        <put-attribute name="title" type="string" value="default title" />
        <put-attribute name="header" type="template"
            value="/WEB-INF/tiles/header.jsp" />
        <put-attribute name="content" type="template"
            value="/WEB-INF/tiles/content.jsp" />
        <put-attribute name="footer" type="template"
            value="/WEB-INF/tiles/footer.jsp" />
    </definition>
    <definition name="courseDetail" extends="template">
        <put-attribute name="title" value="courseDetail title"
            type="string" />
        <put-attribute name="content" type="template"
            value="/WEB-INF/tiles/courseContent.jsp" />
    </definition>
</tiles-definitions>

5、在WEB-INF目录下增加tiles目录，并在tiles目录下增加以下文件：
mainTemplate.jsp

<%...@ page session="false"%>
<%...@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles"%>
<html>
    <head>
        <title><tiles:getAsString name="title" />
        </title>
    </head>
    <body>
        <table border="2" width="300" bordercolor="Gray">
            <tr>
                <td bgcolor="Blue">
                    <tiles:insertAttribute name="header" />
                </td>
            </tr>
            <tr>
                <td>
                    <tiles:insertAttribute name="content" />
                </td>
            </tr>
            <tr>
                <td>
                    <tiles:insertAttribute name="footer" />
                </td>
            </tr>
        </table>
    </body>
</html>

header.jsp

this is from header

content.jsp

<h1>
    this is from content
</h1>

footer.jsp

this is from footer

courseContent.jsp

<%...@page language="java" pageEncoding="UTF-8"%>
<%...@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles"%>
this is courseContent

6、在src下增加一个java class文件：Action.TilesHomeController.java：

package Action;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.validation.BindException;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.AbstractCommandController;

public class TilesHomeController extends AbstractCommandController ...{

    protected ModelAndView handleRequestInternal(HttpServletRequest arg0,
            HttpServletResponse arg1) throws Exception ...{
        return new ModelAndView("courseDetail");
    }

    @Override
    protected ModelAndView handle(HttpServletRequest arg0,
            HttpServletResponse arg1, Object arg2, BindException arg3)
            throws Exception ...{
        return null;
    }

}

7、部署到tomcat 5.x，启动Tomcat，访问http://localhost:8080/exercise-2.5.1/home.htm，可看到如下网页：

this is from header this is courseContent this is from footer

这就说明Spring 2.5 MVC + tiles 2配置成功了。