七.Thymeleaf模板引擎 1.模板引擎

由于SpringBoot默认不支持 JSP（因为默认打包方式为jar包，jsp不支持在jar包内运行)，需要引入第三方模板引擎技术实现页面渲染。

其实jsp就是一个模板引擎，还有用的比较多的freemarker、Thymeleaf。但再多的模板引擎，他们的思想都是一样的，什么样一个思想呢我们来看一下这张图：

模板引擎的作用：写一个页面模板，比如有些值是动态的，我们可以在这些值的地方写一些表达式。而这些值，从哪来呢，就是我们在后台封装一些数据。然后把这个数据和页面模板交给我们模板引擎，模板引擎按照我们这个数据帮你把表达式解析、填充到我们指定的位置，最终把这个数据生成一个我们想要的内容给我们写展现出去
SpringBoot推荐的是Thymeleaf模板引擎

2.Thymeleaf语法

1、表达式
表达式部分官方文档：https://www.thymeleaf.org/doc/tutorials/3.0/usingthymeleaf.html#standard-expression-syntax

表达式名字	语法	用途
变量取值 表达式	${…}	获取请求域、session域、对象等值
选择变量 表达式	*{…}	获取上下文对象值
消息 表达式	#{…}	消息（获取国际化等值）
链接 表达式	@{…}	生成适应当前项目根路径的链接
片段 表达式	~{…}	导入html片段，获取公共页面片段

2、字面量
文本值: `‘one text’ , ‘Another one!’ ,…数字: 0 , 34 , 3.0 , 12.3 ,…布尔值: true , false
空值: null
变量： one，two，… 变量不能有空格

3、文本操作
字符串拼接: +
变量替换: |The name is ${name}|

4、数学运算
运算符: + , - , * , / , %

5、布尔运算
运算符: and , or
一元运算: ! , not

6、比较运算
比较: > , < , >= , <= ( gt , lt , ge , le )等式: == , != ( eq , ne )

7、条件运算
If-then: (if) ? (then)
If-then-else: (if) ? (then) : (else)
Default: (value) ?: (defaultvalue)

8、特殊操作
无操作： _

9、设置属性值: th:attr
设置单个值

设置多个值

以上两个的代替写法 th:xxxx

所有h5标签属性的兼容写法：（基本h5标签属性都能使用th：xxx代替）
https://www.thymeleaf.org/doc/tutorials/3.0/usingthymeleaf.html#setting-value-to-specific-attributes

10、循环遍历
https://www.thymeleaf.org/doc/tutorials/3.0/usingthymeleaf.html#iteration

        Onions
        2.41
        yes

  Onions
  2.41
  yes

11、条件运算
https://www.thymeleaf.org/doc/tutorials/3.0/usingthymeleaf.html#conditional-evaluation

view

  
User is an administrator
  
User is a manager
  
User is some other thing

12、属性优先级
https://www.thymeleaf.org/doc/tutorials/3.0/usingthymeleaf.html#attribute-precedence

3.使用Thymeleaf

Thymeleaf官网使用文档：https://www.thymeleaf.org/doc/tutorials/3.0/usingthymeleaf.html#standard-expression-syntax

1、pom.xml中引入Thymeleaf模板引擎启动器依赖：

    org.springframework.boot
    spring-boot-starter-thymeleaf

或者在构建项目是，勾选Thymeleaf模板引擎，它会自动导入Thymeleaf模板引擎启动器

2、编写一个HelloController

@Controller
public class HelloController {

    @GetMapping("/hello")
    public String hello(){
        return "hello"; //classpath:/templates/test.html
    }
}

3、编写一个测试页面 hello.html 放在 templates 目录下

    
    


    
hello,Thymeleaf!

4、启动项目请求测试：

4.Thymeleaf自动配置原理

前面呢，我们已经引入了Thymeleaf，并成功通过controller方法跳转页面，其原理是什么？
按照SpringBoot的自动配置原理特点，肯定有个ThymeleafAutoConfiguration自动配置类来进行Thymeleaf模板引擎的自动配置。有一个ThymeleafProperties类绑定了配置文件，用于简单的自定义Thymeleaf配置修改

ThymeleafAutoConfiguration：

@Configuration(proxyBeanMethods = false)
@EnableConfigurationProperties(ThymeleafProperties.class)
@ConditionalOnClass({ TemplateMode.class, SpringTemplateEngine.class })
@AutoConfigureAfter({ WebMvcAutoConfiguration.class, WebFluxAutoConfiguration.class })
public class ThymeleafAutoConfiguration {

ThymeleafProperties：

@ConfigurationProperties(prefix = "spring.thymeleaf")
public class ThymeleafProperties {
	private static final Charset DEFAULT_ENCODING = StandardCharsets.UTF_8;
	public static final String DEFAULT_PREFIX = "classpath:/templates/";
	public static final String DEFAULT_SUFFIX = ".html";

我们可以在其中看到默认的前缀DEFAULT_PREFIX和后缀DEFAULT_SUFFIX
上面就说明了为什么只要导入Thymeleaf启动器，然后在resources/templates/下写html页面，thymeleaf就可以自动渲染，就可以通过controller方法转发/重定向到指定页面

总的来说：

• 所有thymeleaf的配置值都在 ThymeleafProperties
• 自动配置类配置好了SpringTemplateEngine、ThymeleafViewResolver
• 我们只需要直接开发页面

5.练习

1、修改测试请求，增加数据传输；

@GetMapping("/t1")
    public String test1(Model model){
        //存入数据
        model.addAttribute("msg","test,Thymeleaf!");
        model.addAttribute("users", Arrays.asList("唐三","小舞","胖子"));

        return "test";  //classpath:/templates/test.html
    }

2、我们要使用thymeleaf，需要在html文件中导入命名空间的约束，方便提示。

我们可以去官方文档的中看一下命名空间拿来过来：

 xmlns:th="http://www.thymeleaf.org"

3、我们去编写下前端页面test.html

    
    


    
    
[[${msg}]]
    
    


    
    

    
[[${user}]]
    

4、启动测试！

我们看完语法，很多样式，我们即使现在学习了，也会忘记。所以我们在学习过程中，需要使用什么，根据官方文档来查询，才是最重要的，要熟练使用官方文档！

八.拦截器 1.实现

1、实现 HandlerInterceptor 接口
LoginInterceptor类：自定义用来拦截登录认证的拦截器

public class LoginInterceptor implements HandlerInterceptor {

	//目标方法执行之前
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {

        String requestURI = request.getRequestURI();
        System.out.println("preHandle执行了");

        //登录检查逻辑
        HttpSession session = request.getSession();
        Object loginUser = session.getAttribute("loginUser");

        if(loginUser != null){
            //放行
            return true;
        }

        //拦截住。未登录。跳转到登录页
        request.setAttribute("msg","请先登录");
//        re.sendRedirect("/");
        request.getRequestDispatcher("/").forward(request,response);
        return false;
    }

	//目标方法执行完成以后
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("postHandle执行了");
    }

	//页面渲染以后
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("afterCompletion执行了");
    }
}

2、在自定义的配置类中添加配置好的LoginInterceptor拦截器

• 自定义的配置类必须实现WebMvcConfigurer接口
• @Configuration注解该类，表示为一个配置类，会注册到spring容器中
• 在自定义配置类重写addInterceptors方法
• addInterceptor方法：添加自定义的LoginInterceptor拦截器
• addPathPatterns方法：添加拦截的路径
• excludePathPatterns方法：添加不拦截的路径

@Configuration
public class AdminWebConfig implements WebMvcConfigurer {

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new LoginInterceptor())
                .addPathPatterns("*.xml
        
        true
    

4、创建service业务层接口及实现类（这一步可以不要，mybatis整合就可以用了，只是为了规范mvc思想）

public interface BooksService {

    List getBooks();
}

@Service
public class BooksServiceImpl implements BooksService{

    @Autowired
    BooksMapper booksMapper;

    @Override
    public List getBooks() {
        return booksMapper.getBooks();
    }
}

5、测试（使用springboot test类模拟controller），能访问数据库OK

	@Autowired
    BooksServiceImpl booksService;

    @Test
    void contextLoads() throws SQLException {
        List books = booksService.getBooks();
        for (Books book : books) {
            System.out.println(book);
        }
    }

整个过程我们都没有使用mybatis的核心配置文件mybatis.xml，只用到了mapper接口的sql映射xxxmapper.xml文件
如果第3步mapper（dao）层接口和对应的xxxmapper.xml sql映射文件不在同一个包下，那我们又没有核心配置文件mybatis.xml去映射该xxxmapper.xml，怎么做？（比如下图这样，放在resources的mybatis目录下了）

mybatis的核心配置文件mybatis.xml全部功能都被整合到了application.properties（yml）配置文件中
所以上图解决办法，可以在配置文件中配置如下：

mybatis:
  mapper-locations: classpath:mybatis/*.xml

如果我们想开启驼峰命名映射和开启日志功能（选择标准日志输出），可以这样做（这就相当于mybatis的核心配置文件mybatis.xml中开启驼峰命名映射和开启日志功能）

mybatis:
  configuration:
    map-underscore-to-camel-case: true #开启驼峰命名映射功能
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl #开启控制台打印日志功能

比如给pojo包下所有类取别名：（这样在sql中指定类型不用写全类名了）

mybatis:
  type-aliases-package: com.example.pojo

2.原理

• 只要导入了MyBatis启动器，里面有个MybatisAutoConfiguration自动配置类，它会将SqlSessionFactory、SqlSessionTemplate（也就是SqlSession）自动配置好并注册为bean组件
• MybatisAutoConfiguration自动配置类有个@import(AutoConfiguredMapperScannerRegistrar.class）
  它将AutoConfiguredMapperScannerRegistrar类注册到spring容器，并且该类功能：只要我们定义的mapper接口使用了@Mapper注解，就会被自动扫描进来
• MybatisProperties.class： MyBatis绑定配置文件的类（可以在配置文件中修改以mybatis开始的所有属性）

@ConfigurationProperties(prefix = "mybatis")
public class MybatisProperties {

十三.JUnit5单元测试

SpringBoot 2.2.0 版本开始引入 JUnit 5 作为单元测试默认库作为最新版本的JUnit框架，集成在了spring-boot-starter-test启动器，JUnit5与之前版本的Junit框架有很大的不同，由三个不同子项目的几个不同模块组成。
JUnit 5 = JUnit Platform + JUnit Jupiter + JUnit VintageJUnit Platform

• Junit Platform:是在JVM上启动测试框架的基础，不仅支持Junit自制的测试引擎，其他测试引擎也都可以接入。
• JUnit Jupiter: JUnit Jupiter提供了JUnit5的新的编程模型，是JUnit5新特性的核心。内部包含了一个测试引擎，用于在Junit Platform上运行。
• JUnit Vintage: 由于JUint已经发展多年，为了照顾老的项目，JUnit Vintage提供了兼容JUnit4.x,Junit3.x的测试引擎。

注意：SpringBoot 2.4 以上版本移除了默认对 JUnit Vintage 的依赖。如果需要兼容junit4需要自行引入（不能使用junit4的功能 @Test）
JUnit 5的s JUnit Vintage:依赖是从spring-boot-starter-test移除的，如果需要继续兼容junit4需要自行引入JUnit Vintage

    org.junit.vintage
    junit-vintage-engine
    test
    
        
            org.hamcrest
            hamcrest-core
        
    

现在springboot项目创建自带的一个测试类。以前版本是@SpringBootTest + @RunWith(SpringTest.class)

@SpringBootTest
class Boot05WebAdminApplicationTests {

    @Test
    void contextLoads() {

    }
}

@Transactional 标注测试方法，测试完成后自动回滚

1.JUnit5常用注解

• @Test: 表示方法是测试方法。但是与JUnit4的@Test不同，他的职责非常单一不能声明任何属性，拓展的测试将会由Jupiter提供额外测试
• @ParameterizedTest : 表示方法是参数化测试，下方会有详细介绍
• @RepeatedTest : 表示方法可重复执行，下方会有详细介绍
• @DisplayName : 为测试类或者测试方法设置展示名称
• @BeforeEach : 表示在每个单元测试之前执行
• @AfterEach : 表示在每个单元测试之后执行
• @BeforeAll : 表示在所有单元测试之前执行
• @AfterAll : 表示在所有单元测试之后执行
• @Tag : 表示单元测试类别，类似于JUnit4中的@Categories
• @Disabled : 表示测试类或测试方法不执行，类似于JUnit4中的@Ignore
• @Timeout : 表示测试方法运行如果超过了指定时间将会返回错误
• @ExtendWith : 为测试类或测试方法提供扩展类引用

	@Test
    @Disabled
    void disabled(){
        System.out.println("在执行MyTest总测试时会跳过这个测试方法");
    }

2.断言

断言（assertions）是测试方法中的核心部分，用来对测试需要满足的条件进行验证。这些断言方法都是 org.junit.jupiter.api.Assertions 的静态方法。
JUnit 5 内置的断言可以分成如下几个类别：1.检查业务逻辑返回的数据是否合理；2.所有的测试运行结束以后，会有一个详细的测试报告；

1、简单断言（用来对单个值进行简单的验证）

方法	功能
assertEquals	判断两个对象或两个原始类型是否相等
assertNotEquals	判断两个对象或两个原始类型是否不相等
assertSame	判断两个对象引用是否指向同一个对象
assertNotSame	判断两个对象引用是否指向不同的对象
assertTrue	判断给定的布尔值是否为 true
assertFalse	判断给定的布尔值是否为 false
assertNull	判断给定的对象引用是否为 null
assertNotNull	判断给定的对象引用是否不为 null

测试以下：

	@Test
    @DisplayName("simple assertion")
    public void simple() {
        Assertions.assertEquals(3, 1 + 2, "simple math");
        Assertions.assertNotEquals(3, 1 + 1);

        Assertions.assertNotSame(new Object(), new Object());
        Object obj = new Object();
        Assertions.assertSame(obj, obj);

        Assertions.assertFalse(1 > 2);
        Assertions.assertTrue(1 < 2);

        Assertions.assertNull(null);
        Assertions.assertNotNull(new Object());
    }

2、数组断言
通过 assertArrayEquals 方法来判断两个对象或原始类型的数组是否相等

	@Test
    @DisplayName("array assertion")
    public void array() {
        Assertions.assertArrayEquals(new int[]{1, 2}, new int[] {1, 2});
    }
}

3、组合断言
assertAll 方法接受多个 org.junit.jupiter.api.Executable 函数式接口的实例作为要验证的断言，可以通过 lambda 表达式很容易的提供这些断言

 	@Test
    @DisplayName("assert all")
    public void all() {
        Assertions.assertAll("Math",
                () -> Assertions.assertEquals(2, 1 + 1),
                () -> Assertions.assertTrue(1 > 0)
        );
    }

4、异常断言
在JUnit4时期，想要测试方法的异常情况时，需要用@Rule注解的ExpectedException变量还是比较麻烦的。而JUnit5提供了一种新的断言方式Assertions.assertThrows() ,配合函数式编程就可以进行使用

	@Test
    @DisplayName("异常测试")
    public void exceptionTest() {
        ArithmeticException exception = Assertions.assertThrows(
                //扔出断言异常
                ArithmeticException.class, () -> System.out.println(2%0));
    }

5、超时断言
Junit5还提供了Assertions.assertTimeout() 为测试方法设置了超时时间

	@Test
	@DisplayName("超时测试")
	public void timeoutTest() {
	    //如果测试方法时间超过1s将会异常
	    Assertions.assertTimeout(Duration.ofMillis(1000), () -> Thread.sleep(500));
	}

6、快速失败
通过 fail 方法直接使得测试失败

	@Test
    @DisplayName("fail")
    public void shouldFail() {
        Assertions.fail("This should fail");
    }

3.前置条件（assumptions）

JUnit 5 中的前置条件（assumptions【假设】）类似于断言，不同之处在于不满足的断言会使得测试方法失败，而不满足的前置条件只会使得测试方法的执行终止。前置条件可以看成是测试方法执行的前提，当该前提不满足时，就没有继续执行的必要。

@DisplayName("前置条件")
public class AssumptionsTest {
	 private final String environment = "DEV";
	 
	 @Test
	 @DisplayName("simple")
	 public void simpleAssume() {
	    assumeTrue(Objects.equals(this.environment, "DEV"));
	    assumeFalse(() -> Objects.equals(this.environment, "PROD"));
	 }
	 
	 @Test
	 @DisplayName("assume then do")
	 public void assumeThenDo() {
	    assumingThat(
	       Objects.equals(this.environment, "DEV"),
	       () -> System.out.println("In DEV")
	    );
	 }
}

assumeTrue 和 assumFalse 确保给定的条件为 true 或 false，不满足条件会使得测试执行终止。assumingThat 的参数是表示条件的布尔值和对应的 Executable 接口的实现对象。只有条件满足时，Executable 对象才会被执行；当条件不满足时，测试执行并不会终止。

4.嵌套测试

JUnit 5 可以通过 Java 中的内部类和@Nested 注解实现嵌套测试，从而可以更好的把相关的测试方法组织在一起。在内部类中可以使用@BeforeEach 和@AfterEach 注解，而且嵌套的层次没有限制。

@DisplayName("A stack")
class TestingAStackDemo {

    Stack