【Spring Boot】初体验

我不能停滞不前

前言

• 心心念念的Spring Boot初体验终于要写了；
• Spring Boot项目的具体创建过程不再赘述，因为网上有一堆了。。本文主要介绍我在创建过程中的踩坑，还有填坑
• 本文中用的了一个 ResponseEntity类型，不懂的戳下面链接：
  【Spring】源码浅析 - ResponseEntity.ok
• 各位看官，在读文过程中，若有建议，请不吝赐教

创建Spring Boot项目的三种方法

1. Spring Initializr.
2. Spring Tool Suite (STS)
3. Spring Boot CLI(Command Line Interface)

不论idea，还是eclipse，创建Spring Boot项目都是基于以上三种方法之一

使用idea，基于Spring Initializr创建Spring Boot项目

关于创建Spring Boot项目，网上已有一堆相关资料，不再赘述；
个人觉得这一篇写的不错了，各位看官可以戳这里：Spring Boot【快速入门】；

踩坑

坑一：Failed to configure a DataSource

原因：
我在创建项目的时候，导入了数据库的相关jar包，在创建后，没有配置数据库
* 数据库：MySQL
* ORM框架：MyBatis

解决方案：
方案一：删除pom.xml中数据库jar包的配置

方案二：在application.properties中配置数据库

#MySQL数据库配置
spring.datasource.url=jdbc:mysql://localhost/blog
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.username=root
spring.datasource.password=root

由于只是初体验，用不到数据库，所以我采用方案一；

坑二：addViewControllers无法返回页面

由于我不想在Controller层写返回页面的方法，所以决定自定义一个类实现WebMvcConfigurer接口，重写addViewControllers方法去返回页面；没想到踩坑了┑(￣Д ￣)┍
自定义类实现WebMvcConfigurer接口

import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

/**
 * @author sincH
 */
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        registry.addViewController("/h/test").setViewName("test");
    }
}

结果无法返回页面

原因：
通过控制台的日志输出，分析出InternalResourceView渲染页面失败了

那么深层分析一下，为啥子会失败呢？通过网上冲浪得知：
templates文件夹下的的页面要配置了模板引擎才能访问到；
由此推测一下，因为InternalResourceView无法访问到页面，导致渲染失败，是吗？？

解决方案：
既然知道了原因是没有配置模板引擎，那么配置模板引擎即可，我选择Thymeleaf
1. 修改pom.xml

<!--Thymeleaf模板引擎-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
        <!-->Thymeleaf的非严格HTML格式包-->
        <dependency>
            <groupId>net.sourceforge.nekohtml</groupId>
            <artifactId>nekohtml</artifactId>
            <version>1.9.22</version>
        </dependency>

1. 修改application.properties

#Thymeleaf 配置
spring.thymeleaf.mode=LEGACYHTML5
spring.thymeleaf.encoding=UTF-8
spring.thymeleaf.servlet.content-type=text/html
#缓存设置为false, 这样修改之后马上生效，便于调试；生产环境下可以设置为true
spring.thymeleaf.cache=false

成功解决！！

对比配置Thymeleaf前后的控制台日志输出

发现：
配置Thymeleaf后，是用ThymeleafView去渲染页面，然后就成了，真是。。怎么说，甚是妙啊

填坑

• 关于页面static文件夹与templates文件夹的区别
  
  • static存放静态页面，templates存放动态页面
  • static下的页面，不论是前端，还是后端，都可以用xxx.html 可以访问到（前提是必须在Web应用根目录下）
    例如：我的Web应用根目录是/blog，那么访问static下的test页面，就该这么写/blog/test.html；
    templates下的页面需要配置了模板引擎才能访问到
• 当类上注解@RestController时，该类方法返回值类型不同，则返回结果不同
  当返回值类型是
  
  • String；返回（json）字符串，而不是渲染视图;
  • ResponseEntity；返回（json）字符串
  • ModelAndView；返回页面

后记

真的 写篇技术文章真心不容易；不过这样也挺好；学习知识点后，写技术文章可以加深记忆。嗯。。挺好的。

参考文章

Spring Boot【快速入门】
ViewControllerRegistry的用法
spring boot(4)-html和templates
Spring boot找不到template下面的html文件解决方法
SpringBoot访问不了resources/templates下的页面

下篇预告

【Spring Boot】搭建个人博客 - 需求分析