springboot_3.2_freemark_基础环境配置

2023-12-11 09:44

本文主要是介绍springboot_3.2_freemark_基础环境配置,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

springboot_3.2_freemark_基础环境配置

    • 一、前言
    • 二、环境
    • 三、相关资料
    • 四、目标
    • 五、默认配置项
    • 六、构建springboot 3.2项目
      • 6.1 pom.xml 内容:
      • 6.2 启动类
      • 6.3 添加ftlh模板
      • 6.4 controller内容
      • 6.5 bootstrap.yml配置
    • 七、总结

一、前言

FreeMarker 是一款模板引擎:即一种基于模板和要改变的数据, 并用来生成输出文本(HTML网页,电子邮件,配置文件,源代码等)的通用工具。 它不是面向最终用户的,而是一个Java类库,是一款程序员可以嵌入他们所开发产品的组件。
模板编写为FreeMarker Template Language (FTL)。它是简单的标签语言。需要在服务器端组织数据,之后通过编写FTL模板显示已经准备好的数据。在模板中,你可以专注于如何展现数据,而在模板之外可以专注于要展示什么数据。

注:从freemarker 2.x 开始模板的默认后缀由 ftl 改为 ftlh(配置类FreeMarkerProperties.DEFAULT_SUFFIX)。

二、环境

  • java 21
  • springboot 3.2

三、相关资料

  • freemark中文管网

四、目标

  • sprinboot 3.2 整合freemarker基础配置;
  • 加入freemarker模板;
  • 编写controller将绑定数据输出到模板中;
  • 运行测试页面;

五、默认配置项

  • jar包:spring-boot-autoconfigure-3.2.0.jar
    • 对象:org.springframework.boot.autoconfigure.freemarker.FreeMarkerProperties

六、构建springboot 3.2项目

项目是通过idea脚手架创建,由于2.x不在维护,建项目时通过服务(https://start.spring.io)只能创建springboot3.x项目,如果想要创建低版本可以使用阿里的脚手架(start.aliyun.com)。springboot3.x只支持java 17 及以上版本。所以建项目前先配置好本地的jdk。

idea脚手架服务更改位置:file/New/New Project/Sping Initializr : Server URL start.string.io ,点击后面的齿轮标记修改!

6.1 pom.xml 内容:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>3.2.0</version><relativePath/> <!-- lookup parent from repository --></parent><groupId>com.test</groupId><artifactId>test2312</artifactId><version>0.0.1-SNAPSHOT</version><name>test2312</name><description>test2312</description><properties><java.version>21</java.version></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-freemarker</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency></dependencies><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><configuration><excludes><exclude><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId></exclude></excludes></configuration></plugin></plugins></build></project>

6.2 启动类

其中在@SpringBootApplication注解中屏蔽了DataSourceAutoConfiguration.class的加载,目的是避免出现“
Failed to configure a DataSource: ‘url’ attribute is not specified and no embedded datasource could be configured.”
错误提示。

因为我们目的只是验证freemarker,不需要数据库相关的依赖,所以不需要配置数据源相关配置。而springboot基础依赖中默认加载了MySQL、Oracle、Mybatis等和数据库相关的依赖包,结果我们的配置文件中却没有添加数据库相关的配置。

package com.test;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration;@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class
})
public class StartApplication {public static void main(String[] args) {SpringApplication.run(StartApplication.class, args);}}

6.3 添加ftlh模板

freemarker2.x开始默认的后缀由ftl改为ftlh了,使用ftl在freemarker3.x中是找不到的。
模板中对spring、list、map等常用的类型,做了绑定和遍历示例。加了个test目录是需要与后面的controller的地址一致。

模板位置:resources\templates\test\index.ftlh

<html>
<head><title>Welcome!</title>
</head>
</body><br><h1>Welcome ${user} !</h1><br><b>展示list中的数据:</b><p><ul><#list lst as item><li>${item}</li></#list></ul><ul></ul></p>
<p><b>map遍历:key值遍历</b><ul><#assign  keys=map?keys/><#list keys as key><li>key=${key}; value=${map["${key}"]};</li></#list></ul><b>map遍历:直接遍历</b><ul><#list map?keys as key><li>key=${key}; value=${map["${key}"]};</li></#list></ul><b>map遍历:直接遍历值</b><ul><#list map?values as value><li>value=${value};</li></#list></ul>
</p>
</body>
</html>

6.4 controller内容

controller中有两个方法,分别是返回text内容 和 绑定ftlh模板内容。

package com.test.controller;import lombok.extern.log4j.Log4j;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.servlet.View;import java.util.Arrays;
import java.util.HashMap;@Controller
@RequestMapping("/test")
public class TestController {private Logger logger = LoggerFactory.getLogger(this.getClass());@GetMapping("/hello")@ResponseBodypublic String hello(){logger.info("hello word~~~");return "hello word!";}@GetMapping("/index.html")public String index(Model model){model.addAttribute("user","joy");var lst = Arrays.asList("11","22","33");var lst4empty = new HashMap<>();var map = new HashMap<String,Object>(){{put("k1",11);}{put("k2",22);}{put("k3",33);}};model.addAttribute("lst",lst);model.addAttribute("lst4empty",lst4empty);model.addAttribute("map",map);logger.info("test index ~~~");return "/test/index";}}

6.5 bootstrap.yml配置

使用这个配置可以方便做环境切换,启动项目时传入dev这个forfile参数可以读到dev环境配置。

spring:profiles.active: ${profile:dev}application:name: test2312http:multipart:max-file-size: 2MBmax-request-size: 2MB
---
spring.profiles: dev
spring:freemarker:templateLoaderPath: classpath:/templates/preferFileSystemAccess: true  #支持热加载,默认为true(生产时false)

七、总结

以上就是一个比较基础的整合过程,需要注意的是通过idea构建时依赖尽量选择少的依赖,否则容易出现各种错误。

这篇关于springboot_3.2_freemark_基础环境配置的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/480254

相关文章

Java编译生成多个.class文件的原理和作用

《Java编译生成多个.class文件的原理和作用》作为一名经验丰富的开发者,在Java项目中执行编译后,可能会发现一个.java源文件有时会产生多个.class文件,从技术实现层面详细剖析这一现象... 目录一、内部类机制与.class文件生成成员内部类(常规内部类)局部内部类(方法内部类)匿名内部类二、

SpringBoot实现数据库读写分离的3种方法小结

《SpringBoot实现数据库读写分离的3种方法小结》为了提高系统的读写性能和可用性,读写分离是一种经典的数据库架构模式,在SpringBoot应用中,有多种方式可以实现数据库读写分离,本文将介绍三... 目录一、数据库读写分离概述二、方案一:基于AbstractRoutingDataSource实现动态

Springboot @Autowired和@Resource的区别解析

《Springboot@Autowired和@Resource的区别解析》@Resource是JDK提供的注解,只是Spring在实现上提供了这个注解的功能支持,本文给大家介绍Springboot@... 目录【一】定义【1】@Autowired【2】@Resource【二】区别【1】包含的属性不同【2】@

springboot循环依赖问题案例代码及解决办法

《springboot循环依赖问题案例代码及解决办法》在SpringBoot中,如果两个或多个Bean之间存在循环依赖(即BeanA依赖BeanB,而BeanB又依赖BeanA),会导致Spring的... 目录1. 什么是循环依赖?2. 循环依赖的场景案例3. 解决循环依赖的常见方法方法 1:使用 @La

Java枚举类实现Key-Value映射的多种实现方式

《Java枚举类实现Key-Value映射的多种实现方式》在Java开发中,枚举(Enum)是一种特殊的类,本文将详细介绍Java枚举类实现key-value映射的多种方式,有需要的小伙伴可以根据需要... 目录前言一、基础实现方式1.1 为枚举添加属性和构造方法二、http://www.cppcns.co

Elasticsearch 在 Java 中的使用教程

《Elasticsearch在Java中的使用教程》Elasticsearch是一个分布式搜索和分析引擎,基于ApacheLucene构建,能够实现实时数据的存储、搜索、和分析,它广泛应用于全文... 目录1. Elasticsearch 简介2. 环境准备2.1 安装 Elasticsearch2.2 J

Java中的String.valueOf()和toString()方法区别小结

《Java中的String.valueOf()和toString()方法区别小结》字符串操作是开发者日常编程任务中不可或缺的一部分,转换为字符串是一种常见需求,其中最常见的就是String.value... 目录String.valueOf()方法方法定义方法实现使用示例使用场景toString()方法方法

Java中List的contains()方法的使用小结

《Java中List的contains()方法的使用小结》List的contains()方法用于检查列表中是否包含指定的元素,借助equals()方法进行判断,下面就来介绍Java中List的c... 目录详细展开1. 方法签名2. 工作原理3. 使用示例4. 注意事项总结结论:List 的 contain

Java实现文件图片的预览和下载功能

《Java实现文件图片的预览和下载功能》这篇文章主要为大家详细介绍了如何使用Java实现文件图片的预览和下载功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... Java实现文件(图片)的预览和下载 @ApiOperation("访问文件") @GetMapping("

Spring Boot + MyBatis Plus 高效开发实战从入门到进阶优化(推荐)

《SpringBoot+MyBatisPlus高效开发实战从入门到进阶优化(推荐)》本文将详细介绍SpringBoot+MyBatisPlus的完整开发流程,并深入剖析分页查询、批量操作、动... 目录Spring Boot + MyBATis Plus 高效开发实战:从入门到进阶优化1. MyBatis