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>