spring in action 4 6.3使用Apache Tiles

原创

wangtenfee 2016-11-19 15:01:38 博主文章分类：springinaction4 ©著作权

文章标签 in spring action 文章分类 Java 后端开发

©著作权归作者所有：来自51CTO博客作者wangtenfee的原创作品，如需转载，请与作者联系，否则将追究法律责任

配置Tiles视图解析器

需要一个TilesConfigurer bean,该bean用于定位和加载tile定义,还需要一个TilesViewResolver用于将逻辑视图名与tile定义映射起来.在WebConfig.java中

@Configuration
@EnableWebMvc
@ComponentScan(basePackageClasses={AutoScan.class})
public class WebConfig extends WebMvcConfigurerAdapter {

	@Override
	public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
		configurer.enable();
	}
	//第6章内容 6.3
	@Bean
	public TilesConfigurer tilesConfigurer() {
		TilesConfigurer tiles = new TilesConfigurer();
		tiles.setDefinitions(new String[] { "/WEB-INF/layout/tiles.xml", "/WEB-INF/views/**/tiles.xml" });
		tiles.setCheckRefresh(true);
		return tiles;
	}

	//第6章内容 6.3
	@Bean
	public ViewResolver viewResolver() {
		return new TilesViewResolver();
	}
}

现在的apache Tiles有两个版本 2.0和3.0,上面用的3.0.两者有什么区别呢.其实也没什么区别,就是用的包名不一样.两个版本都需要一个TilesConfigurer bean和TilesViewResolver bean.引用的时候,2.0用的是org.springframework.web.servlet.view.tiles2,而3.0用的是org.springframework.web.servlet.view.tiles3.

在配置TilesConfigurer bean时,最重要的是属性definitions的定义.该属性持有一个字符串数组,数组中的每个元素都指定了tile-definition XML文件,在上面的配置中我们使用的是

tiles.setDefinitions(new String[] { "/WEB-INF/layout/tiles.xml", "/WEB-INF/views/**/tiles.xml" });

这表示除了使用/WEB-INF/layout/tiles.xml之外,还会递归查询/WEB-INF/views/文件夹及其子文件夹内所有名为tiles.xml的文件,然后使用它们.

上面配置了TilesConfigurer/TilesViewResolver,用的是java配置,与之等同的xml配置如下所示

<bean id="tilesConfigurer"
	class="org.springframework.web.servlet.view.tiles3.TilesConfigurer">
	<property name="definitions">
		<list>
			<value>/WEB-INF/layout/tiles.xml.xml</value>
			<value>/WEB-INF/views/**/tiles.xml</value>
		</list>
	</property>
</bean>
<bean id="viewResolver"	class="org.springframework.web.servlet.view.tiles3.TilesViewResolver" />

下面来介绍该框架最核心的文件tiles.xml.

tiles.xml文件长这样.里面定义了逻辑视图名与物理视图文件的映射,从下面的内容中还能发现,所有的definition都extends了base,而base加载了一个header和一个footer,所以extends base的definition都有一样的header和footer.

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

  <definition name="base" template="/WEB-INF/layout/page.jsp">
    <put-attribute name="header" value="/WEB-INF/layout/header.jsp" />
    <put-attribute name="footer" value="/WEB-INF/layout/footer.jsp" />
  </definition>

  <definition name="home" extends="base">
    <put-attribute name="body" value="/WEB-INF/views/home.jsp" />
  </definition>

  <definition name="registerForm" extends="base">
    <put-attribute name="body" value="/WEB-INF/views/registerForm.jsp" />
  </definition>

  <definition name="profile" extends="base">
    <put-attribute name="body" value="/WEB-INF/views/profile.jsp" />
  </definition>

  <definition name="spittles" extends="base">
    <put-attribute name="body" value="/WEB-INF/views/spittles.jsp" />
  </definition>

  <definition name="spittle" extends="base">
    <put-attribute name="body" value="/WEB-INF/views/spittle.jsp" />
  </definition>

</tiles-definitions>

在上面的tiles.xml文件中,一个definition就是一个tile,每一个tile就是一个逻辑视图与物理视图文件映射.

书中还有对page.jsp 的描述,讲了怎么tile如何定义布局,怎么加载footer,body,header等等.涉及到了前端的东西,看了头大.

代码结构

第一次启动时报错

因为没有引入tile的包,在build.gradle中加入下面的内容后,refresh gradle即可

	compile ("org.apache.tiles:tiles-core:$tilesVersion") {
		exclude group: 'org.slf4j'
	}
	compile ("org.apache.tiles:tiles-jsp:$tilesVersion") {
		exclude group: 'org.slf4j'
	}

再次重启服务器