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

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 快速构建

image

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

image

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

image

3.4 项目目录结构以及说明

image

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类

image

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

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

image

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

image

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

配置成功后重新启动

image

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

image

2. .yml文件格式

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

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

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

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

image

3.9.2 多环境配置

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

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

image

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，在浏览器中进行测试

image

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，在浏览器中进行测试

image

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>