SpringBoot是由Pivotal团队提供的全新框架,其设计目的是用来简化
Spring应用的初始搭建
以及开发过程
。
使用了Spring框架后已经简化了我们的开发,而SpringBoot又是对Spring开发进行简化的,可想而知SpringBoot使用的简单及广泛性。
既然SpringBoot是用来简化Spring开发的,那我们就先回顾一下,以SpringMVC开发为例
创建一个maven工程,并在pom.xml中导入所需依赖的坐标
<dependencies>
<dependency>
<groupId>org.springframeworkgroupId>
<artifactId>spring-webmvcartifactId>
<version>5.2.10.RELEASEversion>
dependency>
<dependency>
<groupId>org.springframeworkgroupId>
<artifactId>spring-jdbcartifactId>
<version>5.2.10.RELEASEversion>
dependency>
<dependency>
<groupId>org.springframeworkgroupId>
<artifactId>spring-testartifactId>
<version>5.2.10.RELEASEversion>
dependency>
<dependency>
<groupId>org.mybatisgroupId>
<artifactId>mybatisartifactId>
<version>3.5.6version>
dependency>
<dependency>
<groupId>org.mybatisgroupId>
<artifactId>mybatis-springartifactId>
<version>1.3.0version>
dependency>
<dependency>
<groupId>mysqlgroupId>
<artifactId>mysql-connector-javaartifactId>
<version>5.1.46version>
dependency>
<dependency>
<groupId>com.alibabagroupId>
<artifactId>druidartifactId>
<version>1.1.16version>
dependency>
<dependency>
<groupId>junitgroupId>
<artifactId>junitartifactId>
<version>4.12version>
<scope>testscope>
dependency>
<dependency>
<groupId>javax.servletgroupId>
<artifactId>javax.servlet-apiartifactId>
<version>3.1.0version>
<scope>providedscope>
dependency>
<dependency>
<groupId>com.fasterxml.jackson.coregroupId>
<artifactId>jackson-databindartifactId>
<version>2.9.0version>
dependency>
dependencies>
编写web3.0的配置类
public class ServletContainersInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {
protected Class<?>[] getRootConfigClasses() {
return new Class[]{SpringConfig.class};
}
protected Class<?>[] getServletConfigClasses() {
return new Class[]{SpringMvcConfig.class};
}
protected String[] getServletMappings() {
return new String[]{"/"};
}
@Override
protected Filter[] getServletFilters() {
CharacterEncodingFilter filter = new CharacterEncodingFilter();
filter.setEncoding("utf-8");
return new Filter[]{filter};
}
}
编写SpringMvc配置类
@Configuration
@ComponentScan("com.itheima.controller")
@EnableWebMvc
public class SpringMvcConfig implements WebMvcConfigurer {
}
编写Controller类
@RestController
@RequestMapping("/books")
public class BookController {
@Autowired
private BookService bookService;
@PostMapping
public boolean save(@RequestBody Book book) {
return bookService.save(book);
}
@PutMapping
public boolean update(@RequestBody Book book) {
return bookService.update(book);
}
@DeleteMapping("/{id}")
public boolean delete(@PathVariable Integer id) {
return bookService.delete(id);
}
@GetMapping("/{id}")
public Book getById(@PathVariable Integer id) {
return bookService.getById(id);
}
@GetMapping
public List<Book> getAll() {
return bookService.getAll();
}
}
从上面的 SpringMVC
程序开发可以看到,前三步都是在搭建环境,而且这三步基本都是固定的。SpringBoot
就是对这三步进行简化了。接下来我们通过一个入门案例来体现 SpingBoot
简化 Spring
开发。
SpringBoot 开发起来特别简单,分为如下几步:
知道了 SpringBoot 的开发步骤后,下面我们进行具体的操作:
创建一个springboot2.0的项目,本地安装的是1.8,但是在使用Spring Initializr创建项目时,发现版本只有17和21。在JDK为1.8的情况下,无论选择Java17版本或者21版本时,都会报错。要么选择更低的Java版本或者更换更高的SDK版本即跟换JDK版本
步骤一:创建新模块
在IDEA下创建一个新模块,选择Spring Initializr
,用来创建SpringBoot工程
https://start.aliyun.com/
选中 Web
,然后勾选 Spring Web
,由于我们需要开发一个 web
程序,使用到了 SpringMVC
技术,所以按照下图红框进行勾选
最后点击创建,就大功告成了,经过以上步骤后就创建了如下结构的模块,它会帮我们自动生成一个 Application
类,而该类一会再启动服务器时会用到
注意:
- 在创建好的工程中不需要创建配置类
- 创建好的项目会自动生成其他的一些文件,而这些文件目前对我们来说没有任何作用,所以可以将这些文件删除。
- 可以删除的目录和文件如下:
- .mvn
- .gitignore
- HELP.md
- mvnw
- mvnw.cmd
步骤二:创建Controller
在com.itheima.controller包下创建BookController,代码如下:
@RestController
@RequestMapping("/books")
public class BookController {
@GetMapping("/{id}")
public String getById(@PathVariable Integer id){
System.out.println("id="+id);
return "hello world";
}
}
步骤三:启动服务器
运行 SpringBoot 工程不需要使用本地的 Tomcat 和 插件,只运行项目 com.itheima 包下的 Application 类,我们就可以在控制台看出如下信息
步骤四:进行测试
依旧是使用PostMan来测试,发送GET请求访问localhost:8080/books/1
可以看到响应回来的结果hello world!
同时控制台也输出了get id = 1
通过上面的入门案例我们可以看到使用 SpringBoot 进行开发,使整个开发变得很简单,那它是如何做到的呢?
要研究这个问题,我们需要看看 Application 类和 pom.xml 都书写了什么。先看看 Applicaion 类,该类内容如下:
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
这个类中的东西很简单,就在类上添加了一个 @SpringBootApplication
注解,而在主方法中就一行代码。我们在启动服务器时就是执行的该类中的主方法。
<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.0modelVersion>
<parent>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-parentartifactId>
<version>2.7.3version>
<relativePath/>
parent>
<groupId>com.bloggroupId>
<artifactId>springboot_01_quickstartartifactId>
<version>0.0.1-SNAPSHOTversion>
<properties>
<java.version>1.8java.version>
properties>
<dependencies>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-webartifactId>
dependency>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-testartifactId>
<scope>testscope>
dependency>
dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-maven-pluginartifactId>
plugin>
plugins>
build>
project>
我们代码之所以能简化,就是因为指定的父工程和 Spring Web 依赖实现的
Spring
程序中的坐标需要自己编写,而且坐标非常多SpringBoot
程序中的坐标是我们在创建工程时进行勾选自动生成的Spring
程序需要自己编写这个配置类。这个配置类我们之前编写过,肯定感觉很复杂SpringBoot
程序不需要我们自己书写Spring/SpringMVC
程序的配置类需要自己书写。而 SpringBoot
程序则不需要书写。注意:基于Idea的 Spring Initializr 快速构建 SpringBoot 工程时需要联网。
在入门案例中之所以能快速构建 SpringBoot 工程,是因为 Idea 使用了官网提供了快速构建 SpringBoot 工程的组件实现的。
首先进入SpringBoot官网 ,拉到页面最下方,会有一个Quickstart your project
然后点击Spring Initializr超链接,就会跳转到如下页面,构建工程的步骤与我们在IDEA中几乎没什么区别
点击GENERATE,就可以生成工程并下载到本地了,打开下载好的压缩包,可以看到工程的内容与IDEA生成的一模一样。
通过上面官网的操作,我们知道 Idea 中快速构建 SpringBoot 工程其实就是使用的官网的快速构建组件,那以后即使没有 Idea 也可以使用官网的方式构建 SpringBoot 工程。
问题引入
以后我们和前端开发人员协同开发,而前端开发人员需要测试前端程序就需要后端开启服务器,这就受制于后端开发人员。为了摆脱这个受制,前端开发人员尝试着在自己电脑上安装 Tomcat
和 Idea
,在自己电脑上启动后端程序,这显然不现实。
我们后端可以将 SpringBoot
工程打成 jar
包,该 jar
包运行不依赖于 Tomcat
和 Idea
这些工具也可以正常运行,只是这个 jar 包在运行过程中连接和我们自己程序相同的 Mysql
数据库即可,这样就可以解决这个问题。
那现在问题就是如何打包
由于我们在构建 SpringBoot
工程时已经在 pom.xml
中配置了如下插件
<plugin>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-maven-pluginartifactId>
plugin>
所以我们只需要使用 Maven 的 package 指令打包就会在 target 目录下生成对应的 Jar 包。
注意:该插件必须配置,不然打好的 jar 包也是有问题的。
java -jar springboot_01_quickstart-0.0.1-SNAPSHOT.jar
执行上述命令就可以看到 SpringBoot 运行的日志信息,同时使用PostMan发送GET请求访问localhost:8080/books/9527,也可以正常输出get id ==> 9527
SpringBoot 是由Pivotal团队提供的全新框架,其设计目的是用来简化Spring应用的初始搭建以及开发过程。
原始 Spring 环境搭建和开发存在以下问题:
- 配置繁琐
- 依赖设置繁琐
SpringBoot
程序优点恰巧就是针对Spring
的缺点
springBoot程序优点:
- 自动配置。这个是用来解决
Spring
程序配置繁琐的问题- 起步依赖。这个是用来解决
Spring
程序依赖设置繁琐的问题- 辅助功能(内置服务器,…)。我们在启动
SpringBoot
程序时既没有使用本地的tomcat
也没有使用tomcat
插件,而是使用SpringBoot
内置的服务器。
接下来我们来说一下 SpringBoot
的起步依赖
我们使用 Spring Initializr 方式创建的 Maven 工程的的 pom.xml 配置文件中自动生成了很多包含 starter 的依赖
<parent>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-parentartifactId>
<version>2.7.3version>
<relativePath/>
parent>
<groupId>com.bloggroupId>
<artifactId>springboot_01_quickstartartifactId>
<version>0.0.1-SNAPSHOTversion>
<properties>
<java.version>1.8java.version>
properties>
<dependencies>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-webartifactId>
dependency>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-testartifactId>
<scope>testscope>
dependency>
dependencies>
这些依赖就是启动依赖,接下来探究一下它是如何实现的。
从上面的文件中可以看到指定了一个父工程
<parent>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-parentartifactId>
<version>2.7.3version>
<relativePath/>
parent>
我们进入到父工程,发现父工程中又指定了一个父工程
<parent>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-dependenciesartifactId>
<version>2.7.3version>
parent>
再进入到该父工程中,在该工程中我们可以看到配置内容结构如下:
properties
properties 标签中定义了各个技术软件依赖的版本,避免了我们在使用不同软件技术时考虑版本的兼容问题。|dependencyManagement 标签是进行依赖版本锁定,但是并没有导入对应的依赖;如果我们工程需要那个依赖只需要引入依赖的 groupid 和 artifactId 不需要定义 version。|而 build 标签中也对插件的版本进行了锁定
<activemq.version>5.16.5activemq.version>
<antlr2.version>2.7.7antlr2.version>
<appengine-sdk.version>1.9.98appengine-sdk.version>
<artemis.version>2.19.1artemis.version>
<aspectj.version>1.9.7aspectj.version>
<assertj.version>3.22.0assertj.version>
<atomikos.version>4.0.6atomikos.version>
<awaitility.version>4.2.0awaitility.version>
<build-helper-maven-plugin.version>3.3.0build-helper-maven-plugin.version>
<byte-buddy.version>1.12.13byte-buddy.version>
···
dependencManagement
dependencyManagement 标签是进行依赖版本锁定,但是并没有导入对应的依赖;如果我们工程需要那个依赖只需要引入依赖的 groupid 和 artifactId 不需要定义 version。
<dependency>
<groupId>org.apache.activemqgroupId>
<artifactId>activemq-amqpartifactId>
<version>${activemq.version}version>
dependency>
<dependency>
<groupId>org.apache.activemqgroupId>
<artifactId>activemq-blueprintartifactId>
<version>${activemq.version}version>
dependency>
<dependency>
<groupId>org.apache.activemqgroupId>
<artifactId>activemq-brokerartifactId>
<version>${activemq.version}version>
dependency>
···
pluginManagement
而 build 标签中也对插件的版本进行了锁定
<plugin>
<groupId>org.codehaus.mojogroupId>
<artifactId>build-helper-maven-pluginartifactId>
<version>${build-helper-maven-plugin.version} version>
plugin>
<plugin>
<groupId>org.flywaydbgroupId>
<artifactId>flyway-maven-pluginartifactId>
<version>${flyway.version}version>
plugin>
<plugin>
<groupId>pl.project13.mavengroupId>
<artifactId>git-commit-id-pluginartifactId>
<version>${git-commit-id-plugin.version} version>
plugin>
···
看完了父工程中 pom.xml 的配置后不难理解我们工程的的依赖为什么都没有配置 version。
在创建的工程中的pom.xml中配置了如下依赖:
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-webartifactId>
dependency>
进入到该依赖,查看pom.xml的依赖,会发现它引入了如下依赖
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-tomcatartifactId>
<version>2.7.3version>
<scope>compilescope>
dependency>
<dependency>
<groupId>org.springframeworkgroupId>
<artifactId>spring-webartifactId>
<version>5.3.22version>
<scope>compilescope>
dependency>
<dependency>
<groupId>org.springframeworkgroupId>
<artifactId>spring-webmvcartifactId>
<version>5.3.22version>
<scope>compilescope>
dependency>
里面的引入了 spring-web 和 spring-webmvc 的依赖,这就是为什么我们的工程中没有依赖这两个包还能正常使用 springMVC 中的注解的原因。
而依赖 spring-boot-starter-tomcat ,从名字基本能确认内部依赖了 tomcat,所以我们的工程才能正常启动。
结论:以后需要使用技术,只需要引入该技术对应的起步依赖即可
starter
parent
所有 SpringBoot
项目要继承的项目,定义了若干个坐标版本号(依赖管理,而非依赖),以达到减少依赖冲突的目的实际开发
创建的每一个 SpringBoot 程序时都包含一个类似于下面的类,我们将这个类称作引导类
@SpringBootApplication
public class Springboot01QuickstartApplication {
public static void main(String[] args) {
SpringApplication.run(Springboot01QuickstartApplication.class, args);
}
}
注意:
- SpringBoot 在创建项目时,采用jar的打包方式
- SpringBoot 的引导类是项目的入口,运行 main 方法就可以启动项目 因为我们在 pom.xml 中配置了 spring-boot-starter-web 依赖,而该依赖通过前面的学习知道它依赖 tomcat ,所以运行 main 方法就可以使用
tomcat 启动咱们的工程。
现在我们启动工程使用的是 tomcat 服务器,那能不能不使用 tomcat 而使用 jetty 服务器。而要切换 web 服务器就需要将默认的 tomcat 服务器给排除掉,怎么排除呢?需要用到我们前面学的知识排除依赖,使用 exclusion 标签
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-webartifactId>
<exclusions>
<exclusion>
<artifactId>spring-boot-starter-tomcatartifactId>
<groupId>org.springframework.bootgroupId>
exclusion>
exclusions>
dependency>
然后还要引入 jetty 服务器。
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-jettyartifactId>
dependency>
接下来再次运行引导类,在日志信息中就可以看到使用的是jetty服务器
小结:通过切换服务器,我们不难发现在使用 SpringBoot
换技术时只需要导入该技术的起步依赖
即可。
我们现在启动服务器默认的端口号是 8080,访问路径可以书写为
http://localhost:8080/books/1
在线上环境我们还是希望将端口号改为 80,这样在访问的时候就可以不写端口号了,如下
而 SpringBoot 程序如何修改呢?SpringBoot 提供了多种属性配置方式
server.port=80
server:
port: 81
server:
port: 82
注意:SpringBoot 程序的配置文件名必须是 application ,只是后缀名不同而已。
application.properties
配置文件
配置文件必须放在 resources
目录下,而该目录下有一个名为 application.properties
的配置文件(SpringBoot已经为我们提供好了),我们就可以在该配置文件中修改端口号,在该配置文件中书写 port
,Idea
就会补全提示
application.properties
配置文件内容如下:
server.port=80
启动服务,会在控制台打印出日志信息,从日志信息中可以看到绑定的端口号已经修改了
Tomcat initialized with port(s): 80 (http)
application.yml配置文件
删除 application.properties 配置文件中的内容。在 resources 下创建一个名为 application.yml 的配置文件,在该文件中书写端口号的配置项,格式如下:
server:
port: 81
注意: 在:后,数据前一定要加空格。
启动服务,可以在控制台看到绑定的端口号是 81
Tomcat initialized with port(s): 81 (http)
application.yaml配置文件
删除 application.yml 配置文件和 application.properties 配置文件内容,然后在 resources 下创建名为 application.yaml 的配置文件,配置内容和后缀名为 yml 的配置文件中的内容相同,只是使用了不同的后缀名而已
application.yaml 配置文件内容如下:
server:
port: 82
启动服务,在控制台可以看到绑定的端口号
Tomcat initialized with port(s): 82 (http)
在三种配合文件中分别配置不同的端口号,启动服务查看绑定的端口号。用这种方式就可以看到哪个配置文件的优先级更高一些
application.properties 文件内容如下:
server.port=80
application.yml 文件内容如下:
server:
port: 81
application.yaml 文件内容如下:
server:
port: 82
properties
> application.yml
> application.yaml
以后开发主写:yml格式的
注意:
- SpringBoot 核心配置文件名为 application
- SpringBoot 内置属性过多,且所有属性集中在一起修改,在使用时,通过代码补全+关键字修改属性
例如要设置日志的级别时,可以在配置文件中书写 logging,就会提示出来。配置内容如下
logging:
level:
root: info
上面讲了三种不同类型的配置文件,而 properties 类型的配合文件之前我们学习过,接下来我们重点学习 yaml 类型的配置文件。
YAML(YAML Ain’t Markup Language),一种数据序列化格式。这种格式的配置文件在近些年已经占有主导地位,那么这种配置文件和前期使用的配置文件是有一些优势的,我们先看之前使用的配置文件。
最开始我们使用的是 xml ,格式如下:
<enterprise>
<name>Helsingname>
<age>16age>
<tel>400-957-241tel>
enterprise>
而 properties 类型的配置文件如下
enterprise.name=Helsing
enterprise.age=16
enterprise.tel=400-957-241
yaml 类型的配置文件内容如下
enterprise:
name: Helsing
age: 16
tel: 400-957-241
通过对比,我们得出yaml的优点有:
- 容易阅读
yaml
类型的配置文件比xml
类型的配置文件更容易阅读,结构更加清晰- 容易与脚本语言交互(暂时还体会不到,后面会了解)
- 以数据为核心,重数据轻格式
yaml
更注重数据,而xml
更注重格式
YAML 文件扩展名:
.yml
(主流).yaml
上面两种后缀名都可以,以后使用更多的还是 yml 的。
yml语法规则
##
表示注释核心规则:数据前面要加空格与冒号隔开
enterprise:
name: itcast
age: 16
tel: 400-957-241
subject:
- Java
- Python
- C#
基本语法
#
表示注释数组表示方式:在属性名书写位置的下方使用减号作为数据开始符号,每行书写一个数据,减号与数据间空格分隔
修改resource目录下的application.yml配置文件:
lesson: SpringBoot
server:
port: 8080
enterprise:
name: itcast
age: 16
tel: 400-957-241
subject:
- Java
- Python
- C#
在com.itheima.domain包下新建一个Enterprise类,用来封装数据
package com.itheima.domain;
import java.util.Arrays;
public class Enterprise {
private String name;
private int age;
private String tel;
private String[] subject;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public String getTel() {
return tel;
}
public void setTel(String tel) {
this.tel = tel;
}
public String[] getSubject() {
return subject;
}
public void setSubject(String[] subject) {
this.subject = subject;
}
@Override
public String toString() {
return "Enterprise{" +
"name='" + name + '\'' +
", age=" + age +
", tel='" + tel + '\'' +
", subject=" + Arrays.toString(subject) +
'}';
}
}
@RestController
@RequestMapping("/books")
public class BookController {
@Value("${lesson}")
private String lesson;
@Value("${server.port}")
private Integer port;
@Value("${enterprise.subject[0]}")
private String subject_0;
@GetMapping("/{id}")
public String getById(@PathVariable Integer id) {
System.out.println(lesson);
System.out.println(port);
System.out.println(subject_0);
return "hello , spring boot!";
}
}
SpringBoot
8080
Java
上面方式读取到的数据特别零散,SpringBoot
还可以使用 @Autowired
注解注入 Environment
对象的方式读取数据。这种方式 SpringBoot
会将配置文件中所有的数据封装到 Environment
对象中,如果需要使用哪个数据只需要通过调用 Environment
对象的 getProperty(String name)
方法获取。具体代码如下:
@RestController
@RequestMapping("/books")
public class BookController {
@Autowired
private Environment environment;
@GetMapping("/{id}")
public String getById(@PathVariable Integer id) {
System.out.println(environment.getProperty("lesson"));
System.out.println(environment.getProperty("enterprise.name"));
System.out.println(environment.getProperty("enterprise.subject[1]"));
return "hello , spring boot!";
}
}
使用PostMan发送请求,控制台输出如下,成功获取到了数据
SpringBoot
itcast
Python
注意:这种方式在开发中很少用,因为框架内含大量数据
SpringBoot
还提供了将配置文件中的数据封装到我们自定义的实体类对象中的方式。具体操作如下:bean
的创建交给 Spring
管理。
@Component
注解@ConfigurationProperties
注解表示加载配置文件
prefix
属性指定只加载指定前缀的数据BookController
中进行注入具体代码如下
Enterprise 实体类内容如下:
@Component
@ConfigurationProperties(prefix = "enterprise")
public class Enterprise {
private String name;
private int age;
private String tel;
private String[] subject;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public String getTel() {
return tel;
}
public void setTel(String tel) {
this.tel = tel;
}
public String[] getSubject() {
return subject;
}
public void setSubject(String[] subject) {
this.subject = subject;
}
@Override
public String toString() {
return "Enterprise{" +
"name='" + name + '\'' +
", age=" + age +
", tel='" + tel + '\'' +
", subject=" + Arrays.toString(subject) +
'}';
}
}
BooKController内容如下
@RestController
@RequestMapping("/books")
public class BookController {
@Autowired
private Enterprise enterprise;
@GetMapping("/{id}")
public String getById(@PathVariable Integer id) {
System.out.println(enterprise);
System.out.println(enterprise.getAge());
System.out.println(enterprise.getName());
System.out.println(enterprise.getTel());
return "hello , spring boot!";
}
}
使用PostMan发送请求,控制台输出如下,成功获取到了数据
Enterprise{name='Helsing', age=16, tel='400-957-241', subject=[Java, Python, C#]}
16
itcast
400-957-241
自定义对象封装数据警告可能遇到的问题:
- 在Enterprise实体类上遇到Spring Boot Configuration Annotation Processor not configured警告提示
解决方案
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-configuration-processorartifactId>
<optional>trueoptional>
dependency>
以后在工作中,对于开发环境、测试环境、生产环境的配置肯定都不相同,比如我们开发阶段会在自己的电脑上安装 mysql
,连接自己电脑上的 mysql
即可,但是项目开发完毕后要上线就需要该配置,将环境的配置改为线上环境的。
来回的修改配置会很麻烦,而 SpringBoot
给开发者提供了多环境的快捷配置,需要切换环境时只需要改一个配置即可。不同类型的配置文件多环境开发的配置都不相同,接下来对不同类型的配置文件进行说明
在 application.yml
中使用 ---
来分割不同的配置,内容如下:
## 开发环境
spring:
profiles: dev ## 给开发环境取的名
server:
port: 80
---
## 生产环境
spring:
profiles: pro ## 给生产环境取的名
server:
port: 81
---
## 测试环境
spring:
profiles: test ## 给测试环境起的名
server:
port: 82
上面配置中 spring.profiles
是用来给不同的配置起名字的。而如何告知 SpringBoot
使用哪段配置呢?可以使用如下配置来启用都一段配置
## 设置启用的环境
spring:
profiles:
active: dev ## 表示使用的是开发环境的配置
综上所述,application.yml 配置文件内容如下
spring:
profiles:
active: dev
---
## 开发环境
spring:
profiles: dev ## 给开发环境取的名
server:
port: 80
---
## 生产环境
spring:
profiles: pro ## 给生产环境取的名
server:
port: 81
---
## 测试环境
spring:
profiles: test ## 给测试环境起的名
server:
port: 82
注意:在上面配置中给不同配置起名字的 spring.profiles 配置项已经过时。最新用来起名字的配置项是
## 开发环境
spring:
config:
activate:
on-profile: dev ## 给开发环境取的名
那现在我们就可以尝试启用不同的环境,来观察启用端口号,证明是否真的启用了不同的环境
properties 类型的配置文件配置多环境需要定义不同的配置文件
application-dev.properties
是开发环境的配置文件。我们在该文件中配置端口号为 80
server.port=80
application-dev.properties
是测试环境的配置文件。我们在该文件中配置端口号为 81
server.port=81
application-pro.properties
是生产环境的配置文件。我们在该文件中配置端口号为 82
server.port=82
SpringBoot
只会默认加载名为 application.properties
的配置文件,所以需要在 application.properties
配置文件中设置启用哪个配置文件,配置如下:
server.port=82
使用 SpringBoot
开发的程序以后都是打成 jar 包
,通过 java -jar xxx.jar
的方式启动服务的。那么就存在一个问题,如何切换环境呢?因为配置文件打到的jar包中了。
我们知道 jar
包其实就是一个压缩包,可以解压缩,然后修改配置,最后再打成jar包就可以了。这种方式显然有点麻烦,而 SpringBoot
提供了在运行 jar
时设置开启指定的环境的方式,如下:
java -jar xxx.jar --spring.profiles.active=test
那么这种方式能不能临时修改端口号呢?也是可以的,可以通过如下方式:
java -jar xxx.jar --server.port=9421
当然也可以同时设置多个配置,比如即指定启用哪个环境配置,又临时指定端口,如下:
java -jar xxx.jar -server.port=9421 --spring.profiles.active=pro
那现在命令行配置的端口号是9421,配置文件中的端口号为82,那么结果将会是多少呢?
测试后就会发现命令行设置的端口号优先级高(也就是使用的是命令行设置的端口号),配置的优先级其实 SpringBoot 官网已经进行了说明,详情参见
如果使用了多种方式配合同一个配置项,优先级高的生效。
有这样的场景,我们开发完毕后需要测试人员进行测试,由于测试环境和开发环境的很多配置都不相同,所以测试人员在运行我们的工程时需要临时修改很多配置,如下:
java –jar springboot.jar –-spring.profiles.active=test --server.port=85 --server.servlet.context-path=/heima --server.tomcat.connection-timeout=-1 …… …… …… …… ……
针对这种情况,SpringBoot 定义了配置文件不同的放置的位置;而放在不同位置的优先级时不同的
。
springBoot 中4级配置文件放置位置:
说明:级别越高的优先级越高
1级和2级
1级就是resource目录下的application.yml
server:
port: 80
2级是在resource目录下新建一个config文件,在其中新建application.yml
server:
port: 81
启动引导类,控制台输出的为81端口
Tomcat initialized with port(s): 81 (http)
先将工程打成一个jar包,进入到jar包的目录下,创建application.yml 配置文件,而在该配合文件中将端口号设置为 82
server:
port: 82
在 jar 包所在位置创建 config 文件夹,在该文件夹下创建 application.yml 配置文件,而在该配合文件中将端口号设置为 83
server:
port: 82
在命令行使用以下命令运行程序
java -jar springboot_06_config_file-0.0.1-SNAPSHOT.jar
运行后日志信息如下,端口为83
Tomcat initialized with port(s): 83 (http)
通过这个结果可以得出一个结论 config
下的配置文件优先于类路径下的配置文件。
IDEA的类路径下的文件,是最低级的
先来回顾一下 Spring 整合 junit
使用 @RunWith 注解指定运行器,使用 @ContextConfiguration 注解来指定配置类或者配置文件。
而 SpringBoot 整合 junit 特别简单,分为以下三步完成
建一个新的SpringBoot工程
在com.itheima.service包下创建BookService接口
public interface BookService {
void save();
}
在com.itheima.service.impl包下创建BookService接口的实现类,并重写其方法
@Service
public class BookServiceImpl implements BookService {
@Override
public void save() {
System.out.println("book service is running ..");
}
}
在 test/java
下创建 com.itheima
包,在该包下创建测试类,将 BookService
注入到该测试类中
@SpringBootTest
class Springboot02JunitApplicationTests {
@Autowired
private BookService bookService;
@Test
void contextLoads() {
bookService.save();
}
}
注意:这里的引导类所在包必须是测试类所在包及其子包。
例如:
- 引导类所在包是 com.itheima
- 测试类所在包是 com.itheima
如果不满足这个要求的话,就需要在使用
@SpringBootTest
注解时,使用classes
属性指定引导类的字节码对象。如
@SpringBootTest(classes = XxxApplication.class)
创建一个新的模块
注意选择技术集的时候,要勾选MyBatis Framework和MySQL Driver
建库建表
CREATE DATABASE springboot_db;
USE spring_db;
CREATE TABLE tb1_book
(
id INT PRIMARY KEY AUTO_INCREMENT,
`type` VARCHAR(20),
`name` VARCHAR(50),
description VARCHAR(255)
);
INSERT INTO `tb1_book`(`id`, `type`, `name`, `description`)
VALUES (1, '计算机理论', 'Spring实战 第五版', 'Spring入门经典教程,深入理解Spring原理技术内幕'),
(2, '计算机理论', 'Spring 5核心原理与30个类手写实践', '十年沉淀之作,手写Spring精华思想'),
(3, '计算机理论', 'Spring 5设计模式', '深入Spring源码刨析Spring源码中蕴含的10大设计模式'),
(4, '计算机理论', 'Spring MVC+Mybatis开发从入门到项目实战',
'全方位解析面向Web应用的轻量级框架,带你成为Spring MVC开发高手'),
(5, '计算机理论', '轻量级Java Web企业应用实战', '源码级刨析Spring框架,适合已掌握Java基础的读者'),
(6, '计算机理论', 'Java核心技术 卷Ⅰ 基础知识(原书第11版)',
'Core Java第11版,Jolt大奖获奖作品,针对Java SE9、10、11全面更新'),
(7, '计算机理论', '深入理解Java虚拟机', '5个纬度全面刨析JVM,大厂面试知识点全覆盖'),
(8, '计算机理论', 'Java编程思想(第4版)', 'Java学习必读经典,殿堂级著作!赢得了全球程序员的广泛赞誉'),
(9, '计算机理论', '零基础学Java(全彩版)', '零基础自学编程的入门图书,由浅入深,详解Java语言的编程思想和核心技术'),
(10, '市场营销', '直播就这么做:主播高效沟通实战指南', '李子柒、李佳奇、薇娅成长为网红的秘密都在书中'),
(11, '市场营销', '直播销讲实战一本通', '和秋叶一起学系列网络营销书籍'),
(12, '市场营销', '直播带货:淘宝、天猫直播从 新手到高手', '一本教你如何玩转直播的书,10堂 课轻松实现带货月入3W+');
定义实体类
public class Book {
private Integer id;
private String type;
private String name;
private String description;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getType() {
return type;
}
public void setType(String type) {
this.type = type;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getDescription() {
return description;
}
public void setDescription(String description) {
this.description = description;
}
@Override
public String toString() {
return "Book{" +
"id=" + id +
", type='" + type + '\'' +
", name='" + name + '\'' +
", description='" + description + '\'' +
'}';
}
}
定义dao接口
在com.itheima.dao包下定义BookDao接口
public interface BookDao {
@Select("select * from tb1_book where id = #{id}")
Book getById(Integer id);
}
定义测试类
@SpringBootTest
class Springboot03MybatisApplicationTests {
@Autowired
private BookDao bookDao;
@Test
void contextLoads() {
Book book = bookDao.getById(1);
System.out.println(book);
}
}
编写配置
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/springboot_db?serverTimezone=UTC
username: root
password: root
测试
运行测试方法,会报错No qualifying bean of type ‘com.itheima.dao.BookDao’,没有类型为“com.itheima.dao.BookDao”的限定bean
为什么会出现这种情况呢?之前我们在配置MyBatis时,配置了如下内容
@Bean
public MapperScannerConfigurer mapperScannerConfigurer() {
MapperScannerConfigurer msc = new MapperScannerConfigurer();
msc.setBasePackage("com.blog.dao");
return msc;
}
Mybatis 会扫描接口并创建接口的代码对象交给 Spring 管理,但是现在并没有告诉 Mybatis 哪个是 dao 接口。
而我们要解决这个问题需要在BookDao 接口上使用 @Mapper
,BookDao 接口修改为
@Mapper
public interface BookDao {
@Select("select * from tb1_book where id = #{id}")
Book getById(Integer id);
}
注意: SpringBoot 版本低于2.4.3(不含),Mysql驱动版本大于8.0时,需要在url连接串中配置时区
jdbc:mysql://localhost:3306/springboot_db?serverTimezone=UTC
,或在MySQL数据库端配置时区解决此问题
使用Druid数据源
现在我们并没有指定数据源,SpringBoot 有默认的数据源,我们也可以指定使用 Druid 数据源,按照以下步骤实现
<dependency>
<groupId>com.alibabagroupId>
<artifactId>druidartifactId>
<version>1.1.12version>
dependency>
在 application.yml 修改配置文件配置
可以通过 spring.datasource.type 来配置使用什么数据源。配置文件内容可以改进为
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/springboot_db?serverTimezone=UTC
username: root
password: PASSWORD.
type: com.alibaba.druid.pool.DruidDataSource
接下来将学习 SSM 时做的三大框架整合的案例用 SpringBoot 来实现一下。先将之前做的SSM整合的代码拷贝过来,修改成SpringBoot的,之后再自己手动敲一遍SpringBoot的全流程,就当复盘了。
创建一个新的SpringBoot工程,注意要勾选Spring Web,MyBatis Framework和MySQL Driver
由于我们工程中使用到了 Druid ,所以需要导入 Druid 的坐标
<dependency>
<groupId>com.alibabagroupId>
<artifactId>druidartifactId>
<version>1.1.12version>
dependency>
将之前的ssm整合工程的代码拷贝过来,将com.itheima包下的所有内容拷贝过来,放在对应的位置即可。
需要修改的内容如下:
将com.itheima.config
包直接删掉,SpringBoot并不需要这些配置类
在dao包下的接口上,加上@Mapper
注解
@Mapper
public interface BookDao {
@Insert("insert into tb1_book values (null, #{type}, #{name}, #{description})")
int save(Book book);
@Update("update tb1_book set type=#{type}, `name`=#{name}, `description`=#{description} where id=#{id}")
int update(Book book);
@Delete("delete from tb1_book where id=#{id}")
int delete(Integer id);
@Select("select * from tb1_book where id=#{id}")
Book getById(Integer id);
@Select("select * from tb1_book")
List<Book> getAll();
}
将测试类也修改为SpringBoot的
@SpringBootTest
public class BookServiceTest {
@Autowired
private BookService bookService;
@Test
public void testGetById() {
Book book = bookService.getById(1);
System.out.println(book);
}
@Test
public void testGetAll() {
for (Book book : bookService.getAll()) {
System.out.println(book);
}
}
}
在application.yml配置文件中配置如下内容
server:
port: 80
spring:
datasource:
type: com.alibaba.druid.pool.DruidDataSource
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/springboot_db?serverTimezone=UTC
username: root
password: root.
在 SpringBoot 程序中是没有 webapp 目录的,那么在 SpringBoot 程序中静态资源需要放在什么位置呢?
静态资源需要放在 resources 下的 static 下
那我们再配置一个默认页面,跳转到我们的增删改页面,新建index.html,写入以下内容
<script>
document.location.href="/pages/books.html"
script>
这样当我们在浏览器输入localhost,然后直接按回车,就能直接跳转到增删改的页面了,如果以后我们需要频繁测试某一个页面,也可以将上述代码中的地址换为我们要测试的地址,这样就不用老手敲地址了
那么至此,将之前的ssm整合,改为springboot的工作,就完成了
Spring Web
,MyBatis
Framework
和MySQL Driverapplication.yml
),配置数据库连接四要素@Mapper
注解Junit
@SpringBootTest
注解Dao层
完成数据库的增删改Service层
(Service接口+实现类)Controller层
@RequestMapping
、@GetMapping
、@PostMapping
、@PutMapping
、@DeleteMapping
@RequestParam
@PathVariable
@RequestBody
@Autowired
自动装配@ResponseBody
com.itheima.controller
编写Controller类com.itheima.dao
存放的是Dao层的接口,注意要使用@Mapper
注解com.itheima.service
存放的是Service层接口,com.itheima.service.impl
存放的是Service的实现类com.itheima.domain
存放的是pojo类resources/static
存放静态资源HTML,CSS,JS等test/java
存放测试类server:
port: 80
spring:
datasource:
type: com.alibaba.druid.pool.DruidDataSource
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/spring_db?serverTimezone=UTC
username: root
password: root.
步骤一:创建数据库和表
create database spring_db;
use spring_db;
create table tb1_book
(
id int primary key auto_increment,
type varchar(20),
`name` varchar(50),
description varchar(255)
);
insert into `tb1_book`(`id`, `type`, `name`, `description`)
values (1, '计算机理论', 'Spring实战 第五版', 'Spring入门经典教程,深入理解Spring原理技术内幕'),
(2, '计算机理论', 'Spring 5核心原理与30个类手写实践', '十年沉淀之作,手写Spring精华思想'),
(3, '计算机理论', 'Spring 5设计模式', '深入Spring源码刨析Spring源码中蕴含的10大设计模式'),
(4, '计算机理论', 'Spring MVC+Mybatis开发从入门到项目实战',
'全方位解析面向Web应用的轻量级框架,带你成为Spring MVC开发高手'),
(5, '计算机理论', '轻量级Java Web企业应用实战', '源码级刨析Spring框架,适合已掌握Java基础的读者'),
(6, '计算机理论', 'Java核心技术 卷Ⅰ 基础知识(原书第11版)',
'Core Java第11版,Jolt大奖获奖作品,针对Java SE9、10、11全面更新'),
(7, '计算机理论', '深入理解Java虚拟机', '5个纬度全面刨析JVM,大厂面试知识点全覆盖'),
(8, '计算机理论', 'Java编程思想(第4版)', 'Java学习必读经典,殿堂级著作!赢得了全球程序员的广泛赞誉'),
(9, '计算机理论', '零基础学Java(全彩版)', '零基础自学编程的入门图书,由浅入深,详解Java语言的编程思想和核心技术'),
(10, '市场营销', '直播就这么做:主播高效沟通实战指南', '李子柒、李佳奇、薇娅成长为网红的秘密都在书中'),
(11, '市场营销', '直播销讲实战一本通', '和秋叶一起学系列网络营销书籍'),
(12, '市场营销', '直播带货:淘宝、天猫直播从新手到高手', '一本教你如何玩转直播的书,10堂课轻松实现带货月入3W+');
步骤二:编写实体类
public class Book {
private Integer id;
private String type;
private String name;
private String description;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getType() {
return type;
}
public void setType(String type) {
this.type = type;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getDescription() {
return description;
}
public void setDescription(String description) {
this.description = description;
}
@Override
public String toString() {
return "Book{" +
"id=" + id +
", type='" + type + '\'' +
", name='" + name + '\'' +
", description='" + description + '\'' +
'}';
}
}
步骤三:编写dao接口
注意使用@Mapper注解
@Mapper
public interface BookDao {
@Select("select * from tbl_book where id=#{id}")
Book getById(Integer id);
@Select("select * from tbl_book")
List<Book> getAll();
@Update("update tbl_book set type=#{type}, `name`=#{name}, `description`=#{description} where id=#{id}")
int update(Book book);
@Delete("delete from tbl_book where id=#{id}")
int delete(Integer id);
@Insert("insert into tbl_book values (null, #{type}, #{name}, #{description})")
int save(Book book);
}
步骤四:编写service接口
及其实现类
public interface BookService {
boolean save(Book book);
boolean update(Book book);
boolean delete(Integer id);
Book getById(Integer id);
List<Book> getAll();
}
@Service
public class BookServiceImpl implements BookService {
@Autowired
private BookDao bookDao;
@Override
public boolean save( Book book) {
int cnt = bookDao.save(book);
return cnt > 0;
}
@Override
public boolean update(Book book) {
int cnt = bookDao.update(book);
return cnt>0;
}
@Override
public boolean delete(Integer id) {
return bookDao.delete(id) > 0;
}
@Override
public Book getById(Integer id) {
return bookDao.getById(id);
}
@Override
public List<Book> getAll() {
return bookDao.getAll();
}
}
步骤五:编写Controller类
注意响应pojo类型
要加@RequestBody
注解
@RestController
@RequestMapping("/books")
public class BookController {
@Autowired
private BookService bookService;
@GetMapping("/{id}")
public Book getById(@PathVariable Integer id) {
return bookService.getById(id);
}
@GetMapping
public List<Book> getAll() {
return bookService.getAll();
}
@PostMapping
public boolean save(@RequestBody Book book) {
return bookService.save(book);
}
@PutMapping
public boolean update(@RequestBody Book book) {
return bookService.update(book);
}
@DeleteMapping("/{id}")
public boolean delete(@PathVariable Integer id) {
return bookService.delete(id);
}
}
步骤六:使用PostMan进行测试
将增删改查全部测试完毕之后,就可以继续往下做了
创建一个返回结果类
我这里暂时只需要返回的结果,状态码和异常信息,如果还有别的需求,可以自行删改
public class Result {
private Object data;
private Integer code;
private String msg;
public Object getData() {
return data;
}
public void setData(Object data) {
this.data = data;
}
public Integer getCode() {
return code;
}
public void setCode(Integer code) {
this.code = code;
}
public String getMsg() {
return msg;
}
public void setMsg(String msg) {
this.msg = msg;
}
@Override
public String toString() {
return "Result{" +
"data=" + data +
", code=" + code +
", msg='" + msg + '\'' +
'}';
}
}
定义状态码Code类
状态码也可以根据自己的需求来自定义
public class Code {
public static final Integer SAVE_OK = 20011;
public static final Integer SAVE_ERR = 20010;
public static final Integer UPDATE_OK = 20021;
public static final Integer UPDATE_ERR = 20020;
public static final Integer DELETE_OK = 20031;
public static final Integer DELETE_ERR = 20030;
public static final Integer GET_OK = 20041;
public static final Integer GET_ERR = 20040;
public static final Integer SYSTEM_ERR = 50001;
public static final Integer SYSTEM_TIMEOUT_ERR = 50002;
public static final Integer SYSTEM_UNKNOW_ERR = 59999;
public static final Integer BUSINESS_ERR = 60001;
}
修改Controller类的返回值
@RestController
@RequestMapping("/books")
public class BookController {
@Autowired
private BookService bookService;
@GetMapping("/{id}")
public Result getById(@PathVariable Integer id) {
Book book = bookService.getById(id);
Integer code = book == null ? Code.GET_ERR : Code.GET_OK;
String msg = book == null ? "数据查询失败,请重试!" : "";
return new Result(code, book, msg);
}
@GetMapping
public Result getAll() {
List<Book> books = bookService.getAll();
Integer code = books == null ? Code.GET_ERR : Code.GET_OK;
String msg = books == null ? "数据查询失败,请重试!" : "";
return new Result(code, books, msg);
}
@PostMapping
public Result save(@RequestBody Book book) {
boolean flag = bookService.save(book);
return new Result(flag ? Code.SAVE_OK : Code.SAVE_ERR, flag);
}
@PutMapping
public Result update(@RequestBody Book book) {
boolean flag = bookService.update(book);
return new Result(flag ? Code.UPDATE_OK : Code.UPDATE_ERR, flag);
}
@DeleteMapping("/{id}")
public Result delete(@PathVariable Integer id) {
boolean flag = bookService.delete(id);
return new Result(flag ? Code.DELETE_OK : Code.DELETE_ERR, flag);
}
}
将异常进行分类
这里只将其划分为了业务异常和系统异常
在com.itheima.exception包下新建两个异常类
public class BusinessException extends RuntimeException {
private Integer code;
public Integer getCode() {
return code;
}
public void setCode(Integer code) {
this.code = code;
}
public BusinessException(Integer code) {
super();
this.code = code;
}
public BusinessException(Integer code, String message) {
super(message);
this.code = code;
}
public BusinessException(Integer code, String message, Throwable cause) {
super(message, cause);
this.code = code;
}
}
public class SystemException extends RuntimeException {
private Integer code;
public Integer getCode() {
return code;
}
public void setCode(Integer code) {
this.code = code;
}
public SystemException(Integer code) {
this.code = code;
}
public SystemException(Integer code, String message) {
super(message);
this.code = code;
}
public SystemException(Integer code, String message, Throwable cause) {
super(message, cause);
this.code = code;
}
}
同时再增加几个状态码
public static final Integer SYSTEM_ERR = 50001;
public static final Integer SYSTEM_TIMEOUT_ERR = 50002;
public static final Integer SYSTEM_UNKNOW_ERR = 59999;
public static final Integer BUSINESS_ERR = 60001;
测试异常
可以getById方法中来进行测试,当id为1时,错误码为BUSINESS_ERR
,当查询其他id时,均为SYSTEM_UNKNOW_ERR
,错误提示信息为服务器访问超时,请稍后再试
@Service
public class BookServiceImpl implements BookService {
@Autowired
private BookDao bookDao;
@Override
public boolean save(Book book) {
int cnt = bookDao.save(book);
return cnt > 0;
}
@Override
public boolean update(Book book) {
int cnt = bookDao.update(book);
return cnt > 0;
}
@Override
public boolean delete(Integer id) {
return bookDao.delete(id) > 0;
}
@Override
public Book getById(Integer id) {
if (id == 1){
throw new BusinessException(Code.BUSINESS_ERR,"不让你瞅");
}
try {
int a = 1 / 0;
} catch (Exception e) {
throw new SystemException(Code.SYSTEM_UNKNOW_ERR, "服务器访问超时,请稍后再试");
}
return bookDao.getById(id);
}
@Override
public List<Book> getAll() {
return bookDao.getAll();
}
}
前端内容同上一章的一样,没有变