《Spring实战》-第六章:渲染视图(表达式,标签库,模板)

慢慢来比较快,虚心学技术

前言:视图解析器可以将逻辑视图名转换成物理实现

一、视图解析器

Spring提供了13个基本的视图解析器,能够将逻辑视图名转换为物理实现,如上一篇中提到的InternalResourceViewResolver。

此处我们只了解其中几个比较常用的视图解析器:

  • FreeMarkerViewResolver:将视图解析为 FreeMarker 模板
  • InternalResourceViewResolver:将视图解析为Web应用的内部资源
  • TilesViewResolver:将视图解析为 Apache Tile 定义,其中 tile ID 与视图名称相同。注意有两个不同的TilesViewResolver实现,分别对应于 Tiles 2.0 和Tiles 3.0
  • ThymeleafViewResolver: 将逻辑视图名称解析为 Thymeleaf 模板视图

使用不同的解析器可以实现将视图解析成不同类型的内容展现

二、具体视图解析器分析Demo

Ⅰ、创建JSP视图

基础实现如上一章《Spring实战》-第五章:Web中的Spring(SpringMVC注解实现)
)所述,InternalResourceViewResolver还支持将逻辑视图名转换成JstlView,我们只需要修改其viewClass为org.springframework.web.servlet.view.JstlView.class即可

@Bean
public ViewResolver viewResolver(){
    InternalResourceViewResolver resourceViewResolver = new InternalResourceViewResolver();
    resourceViewResolver.setPrefix("/WEB-INF/view/");
    resourceViewResolver.setSuffix(".jsp");
    resourceViewResolver.setExposeContextBeansAsAttributes(true);
    resourceViewResolver.setViewClass(org.springframework.web.servlet.view.JstlView.class);
    return resourceViewResolver;
}

Ⅱ、使用Apache Tile视图定义布局

如果一个应用多个视图需要使用很多重复性的内容,如头部,尾部等,或许我们会一个个的去复制使用,但是一旦做了任何更改,将需要同步进行多次更改,效率是很低的。

Apache Tiles是一个JavaEE应用的页面布局框架。Tiles框架提供了一种模板机制,可以为某一类页面定义一个通用的模板,该模板定义了页面的整体布局。布局由可以复用的多个块组成,每个页面可以有选择性的重新定义块而达到组件的复用。

SpringMVC结合Tile使用,案例如下:

引入tiles支持jar包:

<!--tiles-->
<dependency>
    <groupId>org.apache.tiles</groupId>
    <artifactId>tiles-jsp</artifactId>
    <version>3.0.5</version>
</dependency>

①创建TilesConfig配置类,同时定义视图解析器TilesViewResolver

@Configuration
@EnableAspectJAutoProxy
@ComponentScan(basePackages = {"com.my.spring.controller"})
@EnableWebMvc /*<mvc:annotation-driven> 开启mvc配置*/
public class TilesConfig {
    /**
     * 定义默认处理器
     */
    @Bean
    public TilesConfigurer tilesConfigurer(){
        TilesConfigurer tilesConfigurer = new TilesConfigurer();
        //指定tiles的位置
        tilesConfigurer.setDefinitions(new String[]{"/WEB-INF/layout/tiles.xml"});
        //开启刷新功能
        tilesConfigurer.setCheckRefresh(true);

        return tilesConfigurer;
    }

    //定义使用TilesViewResolver
    @Bean
    public ViewResolver viewResolver(){
        return new TilesViewResolver();
    }
}

②定义Tiles

由上述配置代码中可以,Tiles文件是一个xml文件,创建位于/WEB-INF/layout/tiles.xml,使用<tiles-definitions>作为根节点,使用<definition>节点包裹一个Tile

<?xml version="1.0" encoding="UTF-8" ?>
<!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>
    <!--定义一个名为base的tile,其模板文件时WEB-INF/layout下的base.jsp-->
    <definition name="base" template="/WEB-INF/layout/base.jsp">
        <!--定义属性header,指向视图/WEB-INF/layout/header.jsp-->
        <put-attribute name="header" value="/WEB-INF/layout/header.jsp"/>
        <!--定义属性footer,指向视图/WEB-INF/layout/header.jsp-->
        <put-attribute name="footer" value="/WEB-INF/layout/footer.jsp"/>
    </definition>
    <!--定义一个名为home的tile,继承了名为base的tile,自动继承header和footer属性-->
    <definition name="home" extends="base" >
        <!--定义属性body,指向视图/WEB-INF/layout/home.jsp-->
        <put-attribute name="body" value="/WEB-INF/view/home.jsp"/>
    </definition>
</tiles-definitions>

③编写主模板base.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<!--引入tiles标签库-->
<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="t"%>
<html>
<head>
    <title>base</title>
</head>
<body>
    <div id = "header">
        <!--此处引入上tiles.xml文件中定义的属性header,实际上就是将header属性指向的header.jsp引入此处-->
        <t:insertAttribute name="header"></t:insertAttribute>
    </div>
    <div id="content">
         <!--此处引入属性body,一般来说这个地方都是用来作为空占位,所以base tile才没有body属性,此处是被继承者填充的-->
        <t:insertAttribute name="body"></t:insertAttribute>
    </div>
    <div id="footer">
        <!--此处引入上tiles.xml文件中定义的属性footer,实际上就是将footer属性指向的footer.jsp引入此处-->
        <t:insertAttribute name="footer"></t:insertAttribute>
    </div>
</body>
</html>

④编写属性模板文件:header.jsp和footer.jsp这两个文件作为模板文件都是十分简洁的

header.jsp:

    <div style="font-size: medium;font-weight: bolder">TestDemo</div>

footer.jsp:
    <span style="align-content: center">@create by Mr D</span>

⑤编写目标文件:home.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="t"%>
<h1>Hello World</h1>

[图片上传中...(image-bd63b2-1553308187599-15)]

⑥编写基本Controller方法home(),方法返回一个逻辑视图名“home”,经过TilesViewResolver后被解析为完整视图:base.jsp中的body属性由home.jsp填充

@Controller
public class HomeController {

    @RequestMapping(method = RequestMethod.GET,value = "/home")
    public String home(){
        //返回试图名为home的视图
        return "home";
    }
}

⑦浏览器访问结果如下:

Ⅲ、使用Thymeleaf

尽管JSP和Tiles十分便捷,但是终究建立在Servlet的基础之上,有时候很多代码并不是完全的前端代码,使其变得很混乱。Thymeleaf模板是原生的,不依赖于标签库。它能在接受原始 HTML 的地方进行编辑和渲染

案例如下:

引入Thymeleaf支持jar包:

<!-- https://mvnrepository.com/artifact/org.thymeleaf/thymeleaf-spring4 -->
<dependency>
    <groupId>org.thymeleaf</groupId>
    <artifactId>thymeleaf-spring4</artifactId>
    <version>3.0.9.RELEASE</version>
</dependency>

①创建ThymeleafConfig配置类,装配ThymeleafViewResolver用于将逻辑视图名称解析为 Thymeleaf 模板视图,SpringTemplateEngine用于处理模板并渲染结果;TemplateResolver 用于加载 Thymeleaf 模板

@Configuration
public class ThymeleafConfig implements WebMvcConfigurer {
    @Autowired
    private ApplicationContext applicationContext;

    /**
     * 装配模板引擎(解析器),用于处理模板并渲染结果
     */
    @Bean
    public SpringResourceTemplateResolver templateResolver() {
        SpringResourceTemplateResolver templateResolver = new SpringResourceTemplateResolver();
        templateResolver.setCharacterEncoding("UTF-8");
        templateResolver.setApplicationContext(applicationContext);
        templateResolver.setPrefix("/WEB-INF/view/");//指定视图前缀
        templateResolver.setSuffix(".html");//指定视图后缀
        return templateResolver;
    }

    /**
     * 装配模板引擎,用于处理模板并渲染结果
     */
    @Bean
    public SpringTemplateEngine templateEngine() {
        SpringTemplateEngine templateEngine = new SpringTemplateEngine();
        templateEngine.setTemplateResolver(templateResolver());
        templateEngine.setEnableSpringELCompiler(true);

        return templateEngine;
    }

    /**
     * 装配视图解析器
     */
    @Override
    public void configureViewResolvers(ViewResolverRegistry registry) {
        ThymeleafViewResolver resolver = new ThymeleafViewResolver();
        resolver.setCharacterEncoding("UTF-8");
        resolver.setTemplateEngine(templateEngine());
        registry.viewResolver(resolver);
    }
}

②编写基本页面:ThymeleafHtml.html,绑定bean对象,将bean对象属性作为输出

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org"><!--引入thymeleaf支持-->
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>SpringMVC5+Thymeleaf示例</title>
</head>
<body>
<h1>Spring MVC + Thymeleaf Hello World example</h1>
<p th:text="${bean.id}"></p>
<p th:text="${bean.name}"></p>
</body>
</html>

③编写基础Controller方法,返回逻辑视图名指向ThymeleafHtml.html,并将数据封装返回

@RequestMapping(method = RequestMethod.GET,value = "/getBean")
public String getBeanByParam(String data, Model model){

    JSONObject jo = JSON.parseObject(data);
    Integer id = jo.getInteger("id");
    BaseBean bean = this.baseService.findBean(id);

    model.addAttribute("bean",bean);

    return "ThymeleafHtml";
}

④浏览器访问结果:可以看到,返回的bean成功被绑定到页面属性中

但是,Thymeleaf更出色的地方是实现表单绑定,将表单和对象绑定到一起

⑤创建一个AddBeanHtml.html文件,其中包含一个表单文件

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <form method="post" action="addBean" th:object="${baseBean}">
        <div class="error" th:if="${#fields.hasErrors('*')}">
            <ul>
                <li th:each="err: ${#fields.errors('*')}" th:text="${err}">
                    Input is incorrect
                </li>
            </ul>
        </div>
        <label th:class="${#fields.hasErrors('id')}?'error'">Id</label>
        <input type="text" th:field="*{id}" th:class="${#fields.hasErrors('id')}?'error'"/><br>
        <label th:class="${#fields.hasErrors('name')}?'error'">Name</label>
        <input type="text" th:field="*{name}" th:class="${#fields.hasErrors('name')}?'error'"/><br>

        <button type="submit">提交</button>
    </form>
</body>
</html>

⑥编写基本控制方法,将上述代码提交的类展示到ThymeleafHtml.html中去

@RequestMapping(method = RequestMethod.POST,value = "/addBean")
public String addBean(BaseBean baseBean, Model model){

    model.addAttribute("bean",baseBean);

    //返回试图名为home的视图
    return "ThymeleafHtml";
}

网页请求如下:

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,463评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,868评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,213评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,666评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,759评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,725评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,716评论 3 415
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,484评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,928评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,233评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,393评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,073评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,718评论 3 324
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,308评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,538评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,338评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,260评论 2 352

推荐阅读更多精彩内容