SpringBoot系列教程web篇之Beetl环境搭建

前面两篇分别介绍了目前流行的模板引擎Freemaker和Thymeleaf构建web应用的方式，接下来咱们看一下号称性能最好的国产模板引擎Beetl，如何搭建web环境

> 本文主要来自官方文档，若有疑问，推荐查看: http://ibeetl.com/guide/#beetl

<!-- more -->

I. 准备

1. 依赖

首先咱们是须要一个springboot项目，基本的pom结构大都类似

<parent>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter-parent</artifactid>
    <version>2.0.4.RELEASE</version>
    <relativepath /> <!-- lookup parent from update -->
</parent>

<properties>
    <project.build.sourceencoding>UTF-8</project.build.sourceencoding>
    <project.reporting.outputencoding>UTF-8</project.reporting.outputencoding>
    <spring-cloud.version>Finchley.RELEASE</spring-cloud.version>
    <java.version>1.8</java.version>
</properties>

<build>
    <pluginmanagement>
        <plugins>
            <plugin>
                <groupid>org.springframework.boot</groupid>
                <artifactid>spring-boot-maven-plugin</artifactid>
            </plugin>
        </plugins>
    </pluginmanagement>
</build>
<repositories>
    <repository>
        <id>spring-milestones</id>
        <name>Spring Milestones</name>
        <url>https://repo.spring.io/milestone</url>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
</repositories>

在这个项目中，咱们主要须要引入两个依赖包，一个web，一个官方提供的beetl-framework-starter，当前最新的版本为 1.2.12.RELEASE

<dependencies>
    <dependency>
        <groupid>org.springframework.boot</groupid>
        <artifactid>spring-boot-starter-web</artifactid>
    </dependency>
    <dependency>
        <groupid>com.ibeetl</groupid>
        <artifactid>beetl-framework-starter</artifactid>
        <version>1.2.12.RELEASE</version>
    </dependency>
</dependencies>

2. 配置参数

一般咱们直接使用默认的thymeleaf参数配置便可，下面给出几个经常使用的配置

beetl:
  enabled: true
  suffix: btl
beetl-beetlsql:
  dev: true # 即自动检查模板变化

II. 项目搭建演示

1. 项目结构

搭建一个web项目和咱们以前的纯后端项目有点不同，前端资源放在什么地方，依赖文件怎么处理都是有讲究的，下面是一个常规的项目结构

如上图，前端资源文件默认放在resources目录下，下面有两个目录

• templates：存放模板文件，能够理解为咱们编写的html，注意这个文件名不能有问题
• static: 存放静态资源文件，如js,css,image等

2. Rest服务

咱们这里提供了三个接口，主要是为了演示三种不一样的数据绑定方式（和前面两篇博文基本同样）

@Controller
public class IndexController {

    @GetMapping(path = {"", "/", "/index"})
    public ModelAndView index() {
        Map<string, object> data = new HashMap&lt;&gt;(2);
        data.put("name", "YiHui Beetl");
        data.put("now", LocalDateTime.now().toString());
        return new ModelAndView("index.btl", data);
    }

    private static String[] contents =
            ("绿蚁浮觞香泛泛，黄花共荐芳辰。\n清霜天宇净无尘。\n登高宜有赋，拈笔戏成文。\n可奈园林摇落尽，悲秋意与谁论。\n眼中相识几番新。\n龙山高会处，落帽定何人。").split("\n");
    private static Random random = new Random();

    @GetMapping(path = "show1")
    public String showOne(Model model) {
        model.addAttribute("title", "临江仙");
        model.addAttribute("content", contents[random.nextInt(6)]);
        return "show1.btl";
    }

    @GetMapping(path = "show2")
    public String showTow(Map<string, object> data) {
        data.put("name", "Show2----&gt;");
        data.put("now", LocalDateTime.now().toString());
        return "show2.btl";
    }
}

上面的三种case中

• 第一个是最好理解的，在建立ModelAndView时，传入viewName和数据
• 第二个是经过接口参数Model，设置传递给view的数据
• 第三种则直接使用Map来传递数据

注意

若是和前面两篇博文进行对比，会发现一个显著的区别，以前的Freemaker, Thymeleaf指定视图名的时候，都不须要后缀，可是这里，必须带上后缀，不然会500错误

---

三个接口，对应的三个btl文件，以下

index.btl

<meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="description" content="SpringBoot Beetl">
    <meta name="author" content="YiHui">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>YiHui's SpringBoot Beetl Demo</title>
    <link rel="stylesheet" href="index.css">



<div>
    <div class="title">hello world!</div>
    <br>
    <div class="content">欢迎访问  ${name}</div>
    <br>
    <div class="sign">当前时间 ${now}</div>
    <br>
    <a href="show1">传参2测试</a> &nbsp;&nbsp;&nbsp;&nbsp;
    <a href="show2">传参3测试</a>
</div>

show1.btl

<meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="description" content="SpringBoot Beetl">
    <meta name="author" content="YiHui">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>YiHui's SpringBoot Beetl Demo</title>
    <link rel="stylesheet" href="index.css">



<div>
    <div class="title">${title}</div>
    <div class="content">${content}</div>
</div>

show2.btl

<meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="description" content="SpringBoot Beetl">
    <meta name="author" content="YiHui">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>YiHui's SpringBoot Beetl Demo</title>
    <link rel="stylesheet" href="index.css">



<div>
    <div class="title">${name}</div>
    <div class="content">${now}</div>
</div>

在上面的模板文件中，须要注意引用css样式文件，路径前面并无static，咱们对应的css文件

index.css

.title {
    color: #c00;
    font-weight: normal;
    font-size: 2em;
}

.content {
    color: darkblue;
    font-size: 1.2em;
}

.sign {
    color: lightgray;
    font-size: 0.8em;
    font-style: italic;
}

3. 演示

启动项目后，能够看到三个页面的切换，模板中的数据根据后端的返回替换，特别是主页的时间，每次刷新都会随之改变

II. 其余

0. 项目&系列文章

• 190822-SpringBoot系列教程web篇之Beetl环境搭建

• 190820-SpringBoot系列教程web篇之Thymeleaf环境搭建

• 190816-SpringBoot系列教程web篇之Freemaker环境搭建

• 工程：https://github.com/liuyueyi/spring-boot-demo

• 项目地址: https://github.com/liuyueyi/spring-boot-demo/tree/master/spring-boot/206-web-beetl

1. 一灰灰Blog

尽信书则不如，以上内容，纯属一家之言，因我的能力有限，不免有疏漏和错误之处，如发现bug或者有更好的建议，欢迎批评指正，不吝感激

下面一灰灰的我的博客，记录全部学习和工做中的博文，欢迎你们前去逛逛

• 一灰灰Blog我的博客 https://blog.hhui.top
• 一灰灰Blog-Spring专题博客 http://spring.hhui.top

</string,></string,>