spring in action 4 6.3使用Apache Tiles

配置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‘
	}

再次重启服务器

这一版的spring in action就是spring in action4作者还算厚道,把相关的图片都提供了.第3版的源代码里没有,找了很久没找到.当然估计是我检索能力也差点.

本文中还有很多图片是从源代码里拿出来的,版权归原作者所有.路径跟源代码一致.无差.

我估计作者长这样...不知道是不是真的..希望不是.LOL