零基础学SpringBoot(一)--初识SpringBoot

这是我参与更文挑战的第1天，活动详情查看：更文挑战

1. SpringBoot简介

SpringBoot 是Spring家族中的一个全新的框架，它用来简化Spring应用程序的创建和开发过程，也可以说Spring Boot能简化我们之前采用SSM(SpringMVC + Spring + MyBatis)框架进行开发的过程。

以前我们采用SSM框架进行开发的时候，搭建和整合三大框架，我们需要做很多工作，例如配置web.xml，配置Spring，配置MyBatis，并将它们整合在一起等，而Spring Boot框架对此开发过程进行了革命性的颠覆，完全抛弃了繁琐的xml配置过程，采用大量的默认配置简化开发过程。

所以采用Spring Boot可以非常容易和快速地创建基于Spring框架的应用程序，它让编码变得简单了，部署变简单了，监控变简单了。

2. SpringBoot的特性

能够快速创建基于Spring的应程序
能够直接使用Java main方法启动内嵌的Tomcat服务器运行Spring Boot程序，不需要部署war包文件
提供约定的starter POM来简化Maven配置，让Maven的配置变得简单
自动化配置，根据项目的Maven依赖配置，SpringBoot 自动配置Spring、SpringMVC等
提供了程序的健康检查等功能
基本可以不使用XML配置文件，采用注解配置

3. 我的第一个SpringBoot项目

3.1 创建一个Project, 选择类型为 Spring Initializr 快速构建

3.2 选择Spring Boot版本及依赖，创建Spring Web工程

3.3 点击Finish，如果是第一次创建，在右下角会提示正在下载相关依赖，项目创建完毕：

3.4 项目目录结构以及说明

main.java.com.xxx: 存放Java代码
main.resources
- static: 存放静态资源，如图片、CSS、JavaScript等
- templates: 存放Web页面的模版文件
- application.properties/application.yml：用于存放程序的各种依赖模块的配置信息，比如服务端口、数据库连接配置等

3.4.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>
    <!--继承 SpringBoot 框架的一个父项目，所有自己开发的 Spring Boot 都必须的继承-->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.5.1</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <!--当前项目的 GAV 坐标-->
    <groupId>com.mufeng</groupId>
    <artifactId>springboot-001</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <!--maven 项目名称，可以删除-->
    <name>springboot-001</name>
    <!--maven 项目描述，可以删除-->
    <description>Demo project for Spring Boot</description>

    <!--maven 属性配置，可以在其它地方通过${}方式进行引用-->
    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>

        <!--SpringBoot 框架 web 项目起步依赖，通过该依赖自动关联其它依赖-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!--SpringBoot 框架的测试起步依赖，例如：junit 测试，如果不需要的话可以删除-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <!--SpringBoot 提供的打包编译等插件-->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

3.4.2 项目结构说明

.mvn|mvnw|mvnw.cmd：使用脚本操作执行Maven相关命令
.gitignore：使用版本控制工具 git 的时候，设置一些忽略提交的内容
static|templates：页面模板存放文件的目录
application.properties：SpringBoot 的配置文件，很多集成的配置都可以在该文件中

进行配置，例如：Spring、springMVC、Mybatis、Redis 等。
Application.java：SpringBoot 程序执行的入口，执行该程序中的 main 方法，SpringBoot

就启动了

3.5 创建一个Spring MVC 的Spring Boot Controller

创建SpringBootController.java

package com.mufeng.springboot;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class SpringBootController {

    @RequestMapping(value = "/springBoot/index")
    @ResponseBody
    public String index(){
        return "Hello World!";
    }

}

注意：先创建的类一定要位于Application同级目录或下级目录，否则SpringBoot加载不到

3.6 运行Application类

或者在Application类中右键，运行main方法。

通过在控制台的输出，可以看到启动SpringBoot框架，会启动一个内嵌的tomcat，端口号默认为8080，上下文根为空：

3.7 在浏览器输入 http://localhost:8080/springBoot/index 访问，显示以下内容，说明配置成功了

3.8 项目分析

spring-boot-starter-parent是一个SpringBoot的父级依赖，开发SpringBoot程序需要继承该父级项目，它用来提供相关的Maven默认依赖
要知道Spring Boot提供了哪些默认jar包的依赖，可查看该父级依赖的pom文件
如果不想使用某个默认的依赖版本，可以通过 pom.xml 文件的属性配置覆盖各个

依赖项，比如覆盖 Spring 版本
```
<properties>
    <spring-framework.version>5.0.0.RELEASE</ spring-framework.version >
</properties>
```
@SpringBootApplication 注解是SpringBoot项目的核心注解，主要作用是开启Spring自动配置，如果在Application类上去掉该注解，那么不会启动SpringBoot程序
main方法作为项目启动运行的入口
@Controller 以及 @ResponseBody依然是之前的SpringMVC，SpringBoot的里面依然是使用的SSM等框架

3.9 Spring Boot 的核心配置文件

3.9.1 核心配置格式

1. .properties文件(默认采用该文件)

通过修改application.properties配置文件，在修改默认tomcat端口号以及项目上下文根

键值对的properties属性文件配置方式

# 设置内嵌Tomcat端口号
server.port=8888

# 配置项目上下文根
server.servlet.context-path=/app

配置成功后重新启动

更改页面访问路径，重新访问

2. .yml文件格式

yml是一种yaml格式的配置文件，主要采用一定的空格、换行等格式排版进行配置。

yaml是一种直观的能够被计算机识别的数据序列化格式，容易被人阅读，yaml类似于xml，但是语法比xml简介很多，值与前面的冒号配置必须要有一个空格，yml后缀也可以使用yaml后缀

# 设置内嵌Tomcat端口号
server:
  port: 8888
  servlet:
    # 设置上下文根
    context-path: /app

注意：当两种格式配置文件同时存在，使用的是.properties配置文件，为了演示yml，可以将其改名，并重新运行Application查看端口和上下文根

3.9.2 多环境配置

在实际开发中，项目会经历很多的阶段(开发-测试-上线)，每个阶段的配置也会不同，例如端口、上下文根、数据库等，那么这个时候为了方便在不同的环境之间切换，SpringBoot提供了多环境配置

1. 为每个环境创建一个配置文件命名必须以application-环境标识.properties|yml

application-dev.properties

# 开发环境

# 设置内嵌Tomcat端口号
server.port=8081

# 配置项目上下文根
server.servlet.context-path=/dev

application-test.properties

# 测试环境

# 设置内嵌Tomcat端口号
server.port=8082

# 配置项目上下文根
server.servlet.context-path=/test

application-product.properties

# 生产环境

# 设置内嵌Tomcat端口号
server.port=8888

# 配置项目上下文根
server.servlet.context-path=/product

在总配置文件 application.properties 进行环境的激活

#SpringBoot 的总配置文件#激活开发环境
spring.profiles.active=dev
#激活测试环境
#spring.profiles.active=test
#激活生产环境
#spring.profiles.active=product

等号右边的值和配置文件的环境标识名一致，可以更改总配置文件的配置，重新运行 Application，查看启动的端口及上下文根

yml格式也是同样的写法

3.9.3 SpringBoot 自定义配置读取

在 SpringBoot 的核心配置文件中，除了使用内置的配置项之外，我们还可以在自定义配置，然后采用如下注解去读取配置的属性值

1. @Value注解

此注解用于逐个读取application.properties中的配置

在核心配置文件application.properties中，添加两个自定义配置项user.name和user.url。在IDEA中可以看到这两个属性不能被SpringBoot识别

# 设置内嵌Tomcat端口号
server.port=8081
# 配置项目上下文根
server.servlet.context-path=/dev

user.nickName=MuFeng
user.url=www.baidu.com

在SpringBootController中定义属性，并使用@Value注解获得自定义配置值，并测试

package com.mufeng.springboot;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controllerpublic 
class SpringBootController {   
    @Value("${user.nickName}")    
    private String userName;    
    
    @Value("${user.url}")   
    private String userUrl;   
    
    @RequestMapping(value = "/springBoot/index")    
    @ResponseBody    
    public String index() {        
        return "userName= " + userName + "-------userUrl= " + userUrl; 
    }
}

重新运行Application，在浏览器中进行测试

2. @ConfigurationProperties

将整个文件映射成一个对象，用于自定义配置项比较多的情况

创建UserInfo类，并未该类加上Component和ConfigurationProperties注解，并在ConfigurationProperties注解中添加属性prefix，作用可以区分同名配置

package com.mufeng.springboot;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "user")
public class UserInfo {    
    private String nickName;    
    
    private String url;    
    
    public String getNickName() {        
        return nickName;    
    }    
    
    public void setNickName(String nickName) {  
        this.nickName = nickName;  
    }   
    
    public String getUrl() {      
        return url;  
    }   
    
    public void setUrl(String url) {   
        this.url = url;   
    }
    
}

在SpringBootController中注入UserInfo配置类

    @Autowired    
    private UserInfo userInfo;

修改SpringBootController类中的测试方法

  @RequestMapping(value = "/springBoot/index") 
  @ResponseBody    
  public String index() {   
      return "userName= " + userInfo.getNickName() + "-------userUrl= " + userInfo.getUrl();  
  }

重新运行Application，在浏览器中进行测试

3.10 SpringBoot 前端使用JSP

3.10.1 在pom.xml文件配置以下依赖项

        <!--引入 Spring Boot 内嵌的 Tomcat 对 JSP 的解析包，不加解析不了 jsp 页面-->  
        <!--如果只是使用 JSP 页面，可以只添加该依赖-->        
        <dependency>           
            <groupId>org.apache.tomcat.embed</groupId>  
            <artifactId>tomcat-embed-jasper</artifactId>  
        </dependency>

3.10.2 在pom.xml的build标签中要配置以下信息

SpringBoot 要求 jsp 文件必须编译到指定的 META-INF/resources 目录下才能访问，否则访问不到。其实官方已经更建议使用模板技术

        <!--SpringBoot 要求 jsp 文件必须编译到指定的 META-INF/resources 目录下才能访问，否则访问不到。其它官方已经建议使用模版技术-->       
        <resources>           
            <resource>               
                <!--源文件位置-->              
                <directory>src/main/webapp</directory>     
                <!--指定编译到 META-INF/resources，该目录不能随便写-->   
                <targetPath>META-INF/resources</targetPath>            
                <!--指定要把哪些文件编译进去，**表示 webapp 目录及子目录，*.*表示所有文件-->   
                <includes>                   
                    <include>**/*.*</include>     
                </includes>           
            </resource>          
        
            <resource>              
                <directory>src/main/resources</directory>  
                <includes>                  
                    <include>**/*.*</include>    
                </includes>           
            </resource>        
        </resources>

3.10.3 在application.properties文件配置SpringMVC的视图展示为jsp，这里相当于SpringMVC的配置

# 配置SpringMVC视图解析器
# 其中: /表示目录为src/main/webapp

spring.mvc.view.prefix=/
spring.mvc.view.suffix=.jsp

3.10.4 创建JspController类并编写代码

package com.mufeng.springboot;

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

@Controllerpublic 
class JspController {   
    @RequestMapping(value = "/springBoot/jsp") 
    public String jsp(Model model){  
        model.addAttribute("data", "SpringBoot 使用JSP页面");    
        return "index";  
    }
}

3.10.5 在src/main 下创建一个webapp目录，然后在该目录下新建index.jsp页面

<%--  Created by IntelliJ IDEA. 
User: a  
Date: 2021/6/15  Time: 4:23 下午  
To change this template use File | Settings | File Templates.--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
    <head>   
        <title>Title</title>
    </head>
    <body>
    </body>
</html>

3.10.6 在jsp页面中获取Controller传递过来的数据

<%--  Created by IntelliJ IDEA.  User: a  Date: 2021/6/15  Time: 4:23 下午  To change this template use File | Settings | File Templates.--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
    <head>  
        <title>Title</title>
    </head>
    <body>  
        ${data}
    </body>
</html>