转载

Spring Boot 与 Kotlin 使用Freemarker模板引擎渲染web视图

在《Spring Boot 与 Kotlin 使用Thymeleaf模板引擎渲染web视图》一文中，我们使用Thymeleaf模板引擎渲染web视图，体验了kotlin 与spring boot结合是相当好的，这篇文章中继续介绍web视图，但是是使用Freemarker模板引擎渲染web视图。

Web相关的介绍这里就不多阐述，还没了解的请移步《Spring Boot 与 Kotlin 使用Thymeleaf模板引擎渲染web视图》

FreeMarker

FreeMarker 是一款模板引擎：即一种基于模板和要改变的数据，并用来生成输出文本（HTML网页、电子邮件、配置文件、源代码等）的通用工具。它不是面向最终用户的，而是一个Java类库，是一款程序员可以嵌入他们所开发产品的组件。

FreeMarker 是免费的，基于Apache许可证2.0版本发布。其模板编写为 FreeMarker Template Language（FTL） ，属于简单、专用的语言。需要准备数据在真实编程语言中来显示，比如数据库查询和业务运算，之后模板显示已经准备好的数据。在模板中，主要用于如何展现数据，而在模板之外注意于要展示什么数据。

基本语法：

${…}：FreeMarker将会输出真实的值来替换大括号内的表达式，这样的表达式被称为interpolation（插值）。
注释：注释和HTML的注释也很相似，但是它们使用<#– and –>来标识。不像HTML注释那样，FTL注释不会出现在输出中（不出现在访问者的页面中），因为FreeMarker会跳过它们。
FTL标签（FreeMarker模板的语言标签）：FTL标签和HTML标签有一些相似之处，但是它们是FreeMarker的指令，是不会在输出中打印的。这些标签的名字以#开头。（用户自定义的FTL标签则需要使用@来代替#）

模版实例

<html>
 <head>
 <title>Welcome!</title>
 </head>
 <body>
 <h1>Welcome ${username}!</h1>
 <p>Our latest product:
 <a href="${latestProduct.url}">${latestProduct.name}</a>!
 </body>
</html>

在Spring Boot中使用 FreeMarker 相关的，只需要引入下面依赖，并在默认的模板路径 src/main/resources/templates 下编写模板文件即可完成。

compile "org.springframework.boot:spring-boot-starter-freemarker:$spring_boot_version"

完整的 build.gradle

group 'name.quanke.kotlin'
version '1.0-SNAPSHOT'

buildscript {
 ext.kotlin_version = '1.2.10'
 ext.spring_boot_version = '1.5.4.RELEASE'
 repositories {
 mavenCentral()
 }
 dependencies {
 classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
 classpath("org.springframework.boot:spring-boot-gradle-plugin:$spring_boot_version")

// Kotlin整合SpringBoot的默认无参构造函数，默认把所有的类设置open类插件
 classpath("org.jetbrains.kotlin:kotlin-noarg:$kotlin_version")
 classpath("org.jetbrains.kotlin:kotlin-allopen:$kotlin_version")
 }
}

apply plugin: 'kotlin'
apply plugin: "kotlin-spring" // See https://kotlinlang.org/docs/reference/compiler-plugins.html#kotlin-spring-compiler-plugin
apply plugin: 'org.springframework.boot'

jar {
 baseName = 'chapter11-5-2-service'
 version = '0.1.0'
}
repositories {
 mavenCentral()
}


dependencies {
 compile "org.jetbrains.kotlin:kotlin-stdlib-jre8:$kotlin_version"
 compile "org.springframework.boot:spring-boot-starter-web:$spring_boot_version"
 compile "org.springframework.boot:spring-boot-starter-freemarker:$spring_boot_version"
 testCompile "org.springframework.boot:spring-boot-starter-test:$spring_boot_version"
 testCompile "org.jetbrains.kotlin:kotlin-test-junit:$kotlin_version"

}

compileKotlin {
 kotlinOptions.jvmTarget = "1.8"
}
compileTestKotlin {
 kotlinOptions.jvmTarget = "1.8"
}

举个例子：通过FreeMarker渲染一个页面。

import org.springframework.stereotype.Controller
import org.springframework.ui.Model
import org.springframework.web.bind.annotation.RequestMapping

/**
 * Created by http://quanke.name on 2018/1/10.
 */
@Controller
class HelloController {

 @RequestMapping("/")
 fun index(model: Model): String {
// / 加入一个属性，用来在模板中读取
 model.addAttribute("host", "http://quanke.name")
 // return模板文件的名称，对应src/main/resources/templates/index.ftl
 return "index"
 }

}

默认在 src/main/resources/templates 目录下增加 index.ftl 文件

注意Freemarker模版的后缀默认是 ftl ,Thymeleaf模版后缀默认是 html

<!DOCTYPE html>
<html>
<body>
<h4>我的博客：${host}！</h4>
<h1>quanke.name</h1>

</body>
</html>

增加使用 kotlin 语言实现的 Spring Boot 启动方法：

import org.springframework.boot.SpringApplication
import org.springframework.boot.autoconfigure.SpringBootApplication


/**
 * Created by http://quanke.name on 2018/1/9.
 */

@SpringBootApplication
class Application

fun main(args: Array<String>) {
 SpringApplication.run(Application::class.java, *args)
}

在 application.yml 文中增加：

#设定ftl文件路径
spring:
 freemarker:
 template-loader-path: classpath:/templates

如上页面，直接打开html页面展现Hello World，但是启动程序后，访问 http://localhost:8080/，则是展示Controller中host的值：http://quanke.name，做到了不破坏HTML自身内容的数据逻辑分离。

更多 FreeMarker 相关的，还请访问 FreeMarker 官网查询使用。

原文 http://quanke.name/posts/39947/

正文到此结束

所属分类： Spring 编程技术

本文标签： map HTML src IO cat 程序员 lib plugin maven 产品 App build Service classpath 数据库注释 Java类 Freemarker web tar 代码开发免费 apache 数据 dependencies 文章 java UI 插件博客 springboot spring https 配置实例 http Spring Boot 目录 ip
版权声明： 本文为互联网转载文章，出处已在文章中说明(部分除外)。如果侵权，请联系本站长删除，谢谢。
本文海报： 生成海报一生成海报二

其他链接

关于本站

本站定位：个人技术类博客

本站作用：写博客、记日志、闲聊扯淡鼓捣技术。

问题交流

Spring Boot 与 Kotlin 使用Freemarker模板引擎渲染web视图

FreeMarker

基本语法：

模版实例

举个例子：通过FreeMarker渲染一个页面。

热门推荐

相关文章

说给你听

本文目录

随机标签

书籍教程

近期评论

网站信息

其他链接

关于本站

问题交流