有史以来最完整包 SpringBoot 学习笔记整合,该有的应有尽有
![有史以来最完整包SpringBoot学习笔记整合,该有的应有尽有](https://static001.geekbang.org/infoq/17/17998751be325234b8ac0277a73d1fb7.jpeg)
}1.1.1.3 启动服务器直接运行引导类即可
1.1.2 开发内容对比坐标 Spring 程序中的坐标需要自己编写,而且坐标非常多 SpringBoot 程序中的坐标是我们在创建工程时进行勾选自动生成的 web3.0 配置类 Spring 程序需要自己编写这个配置类。这个配置类大家之前编写过,肯定感觉很复杂 SpringBoot 程序不需要我们自己书写配置类注意:基于 Idea 的 Spring Initializr 快速构建 SpringBoot 工程时需要联网。Spring/SpringMVC 程序的配置类需要自己书写。而 SpringBoot 程序则不需要书写。1.1.3 官网构建工程 SpringBoot 官网:https://spring.io/projects/spring-boot
点击下方的 Quickstart 中的 Spring Initializr,开始快速创建项目,如下图所示
1.1.4 SpringBoot 工程快速启动 1.1.4.1 问题引入 SpringBoot 程序服务器运行在本机当进行前后端联调时,按理说前端需要连接后端开发的机器,比较麻烦是否有更好的方式?
后端可以将 SpringBoot 工程打成 jar 包该 jar 包运行不依赖于 Tomcat 和 Idea 也可以正常运行这个 jar 包在运行过程中连接和我们自己程序相同的 Mysql 数据库即可 1.1.4.2 打包首先必须在 pom.xml 中配置如下插件<plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin>使用 Maven 的 package 指令打包就会在 target 目录下生成对应的 Jar 包注意:在运行 package 指令之前,最好先运行一次 clean 指令,防止出现问题如果配置文件中包含中文,最好在设置中设置编码为 UTF-8 并重新检查配置文件中的中文,避免出现乱码问题导致配置文件无法使用,具体操作如下
1.1.4.3 启动进入 jar 包所在目录,使用 cmd 输入命令 java -jar springboot_01_quickstart-0.0.1-SNAPSHOT.jar1.2 SpringBoot 概述原始 Spring 环境搭建和开发存在以下问题:配置繁琐依赖设置繁琐
SpringBoot 程序优点恰巧就是针对 Spring 的缺点自动配置。这个是用来解决 Spring 程序配置繁琐的问题起步依赖。这个是用来解决 Spring 程序依赖设置繁琐的问题辅助功能(内置服务器,...)。在启动 SpringBoot 程序时既没有使用本地的 tomcat 也没有使用 tomcat 插件,而是使用 SpringBoot 内置的服务器。
1.2.1 起步依赖 —— 核心:Maven 继承以后需要使用技术,只需要引入该技术对应的起步依赖即可
application.propertiesserver.port=80application.yml(常用)server: port: 81application.yamlserver: port: 822.2 yaml 格式 2.2.1 概述特点 YAML(YAML Ain't Markup Language),一种数据序列化格式。相比于 xml 和 properties 而言重数据,轻格式优点容易阅读 yaml 类型的配置文件比 xml 类型的配置文件更容易阅读,结构更加清晰容易与脚本语言交互以数据为核心,重数据轻格式 yaml 更注重数据,而 xml 更注重格式扩展名.yml (主流).yaml2.2.2 语法规则规则大小写敏感属性层级关系使用多行描述,每行结尾使用冒号结束使用缩进表示层级关系,同层级左侧对齐,只允许使用空格(不允许使用 Tab 键),空格的个数并不重要,只要保证同层级的左侧对齐即可。属性值前面添加空格(属性名与属性值之间使用冒号+空格作为分隔)
表示注释
示例
层级关系 enterprise: name: dandelion age: 16 tel: 12345456767 # 数组格式 subject: - Java - C++ - 算法
2.3 yaml 配置文件数据读取 2.3.1 环境准备准配配置文件 application.yamllesson: SpringBoot server: port: 80 enterprise: name: dandelion age: 16 tel: 12345456767 subject: - Java - C++ - 算法 2.3.2 读取配置数据 2.3.2.1 使用 @Value 注解直接使用 @Value("{ }包裹的数据名称的字符串
Controller 示例 @RestController @RequestMapping("/books") public class BookController { // 读取数据 @Value("{server.port}") private Integer port; // 数组元素 @Value("${enterprise.subject[0]}") private String subject_00; @GetMapping("/{id}") public String getById(@PathVariable Integer id) { System.out.println(lesson); System.out.println(port); System.out.println(subject_00); return "hello boot!"; } }2.3.2.2 Environment 对象用于获取全部数据,使用时对 Environment 类型的属性进行自动装配,使用其 getProperty()方法来获取数据
Controller 示例 import org.springframework.core.env.Environment; // import ... @RestController @RequestMapping("/books") public class BookController { // 获取全部数据,注入到 Environment 类型中 @Autowired private Environment environment; @GetMapping("/{id}") public String getById(@PathVariable Integer id) { // System.out.println(environment.getProperty("lesson")); System.out.println(environment.getProperty("server.port")); System.out.println(environment.getProperty("enterprise.age")); System.out.println(environment.getProperty("enterprise.subject[1]")); return "hello boot!"; } }2.3.2.3 自定义对象该方式用于读取任意数据,将其封装为实体类,使用注解绑定获取数据的范围,在获取时,通过自动注入获取该实体类对象并进行操作
定义数据的实体类,和配置文件中保持一致,并实现其 Getter 和 Setter 后续要使用自动装配,故要添加 @Component 注解,将这个类交给 Spring 管理使用 @ConfigurationProperties(prefix = "enterprise")注解,prefix 属性值表示读取配置文件的哪一部分数据,此处代表读取 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) + '}'; } }Controller 示例 @RestController @RequestMapping("/books") public class BookController { @Autowired private Enterprise enterprise; @GetMapping("/{id}") public String getById(@PathVariable Integer id) { System.out.println(enterprise); return "hello boot!"; } }2.4 多环境配置 2.4.1 yaml 文件简单书写使用 spring.profiles 设定环境的名称使用---将不同的环境进行分隔使用 spring.profiles.active 设置启动项目时使用的环境公用的配置可以写在第一部分中 #设置启用的环境 spring: profiles: active: test --- #开发环境 spring: profiles: dev server: port: 80 --- #测试环境 spring: profiles: test server: port: 81 --- #生产环境 spring: profiles: pro server: port: 82 标注书写简单书写部分中,设定环境的名称的 spring.profiles 的书写格式并不规范,规范的书写格式如下 #开发环境 spring: config: activate: on-profile: dev server: port: 802.4.2 properties 文件与 yaml 文件不同,properties 的多环境配置写在不同的文件中,并在主配置文件中指定使用的环境多个环境使用文件名进行区分和定义,application-环境名.properties 公用的配置可以写 application.properties 中
主配置文件 application.properties#设置启用的环境 spring.profiles.active=dev 开发环境和测试环境开发环境 application-dev.propertiesserver.port=80 测试环境 application-test.propertiesserver.port=812.4.3 命令行启动参数配置命令行临时配置可以在启动指令后添加参数来临时覆盖配置文件中的内容,参数可以有多个,每一个参数的格式为-- 空格 使用.连接的配置属性名称=属性值,如下 java -jar springboot_01_quickstart-0.0.1-SNAPSHOT.jar -- spring.profiles.active=test -- server.port=88 配置的优先级如上,命令中添加参数的优先级大于原本配置文件的优先级 SpringBoot 官网对于优先级已经进行了说明,参见:官方文档:Externalized Configuration 中文手册:外化配置 2.5 配置文件分类命令行启动参数配置存在问题由于测试环境和开发环境的很多配置都不相同,所以测试人员在运行我们的工程时需要临时修改很多配置,可能参数过多,过于复杂解决方案:额外的配置类 SpringBoot 配置文件中 4 级配置文件位置及其优先级(优先级逐级提升):1 级:classpath:application.yml 【最低】2 级:classpath:config/application.yml3 级:file :application.yml4 级:file :config/application.yml 【最高】说明 classpath 指的是项目的 resources 目录下,file 指的是打好的 jar 包所在的目录下 file 中的配置文件一般用于系统打包后临时设置通用属性,classpath 中的配置文件一般用于开发阶段设置通用属性 file 中的配置文件的优先级高于 classpath 中的配置文件同一分类的配置中,config 文件夹中的配置文件的优先级高于 config 文件夹外的配置文件 3、SpringBoot 整合 JunitSpring 整合 Junit 回顾
3.1 环境准备创建新的模块,不需要依赖 Service 实现类(接口不表)@Service public class BookServiceImpl implements BookService { @Override public void save() { System.out.println("book save!"); } }3.2 测试类编写测试类中(@SpringBootTest 修饰),将 BookService 注入如果测试类和引导类的包名不一致,需要为 @SpringBootTest 的 class 属性手动指定引导类的字节码对象,如 @SpringBootTest(classes = Springboot02TestApplication.class)@SpringBootTest class Springboot02TestApplicationTests { @Autowired private BookService bookService; @Test void contextLoads() { bookService.save(); } }4、SpringBoot 整合 Mybatis4.1 回顾 Spring 整合 MybatisSpring 整合 MyBatis 整合思路整合步骤 4.2 SpringBoot 整合 Mybatis4.2.1 创建模块依赖 MyBatis FrameworkMySQL Driver4.2.2 定义实体类 public class Book {private Integer id;private String name;private String type;private String description;
}4.2.3 定义 dao 数据库 SQL 见前置内容,tbl_book 表 SQL,此处不再赘述
dao (报错)public interface BookDao { @Select("select * from tbl_book where id = #{id}") public Book getById(Integer id); }存在问题及解决方案报错:No qualifying bean of type 'priv.dandelion.dao.BookDao' available 错误信息显示在 Spring 容器中没有 BookDao 类型的 beanCaused by: org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type 'priv.dandelion.dao.BookDao' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)} at org.springframework.beans.factory.support.DefaultListableBeanFactory.raiseNoMatchingBeanFound(DefaultListableBeanFactory.java:1801) ~[spring-beans-5.3.25.jar:5.3.25] at org.springframework.beans.factory.support.DefaultListableBeanFactory.doResolveDependency(DefaultListableBeanFactory.java:1357) ~[spring-beans-5.3.25.jar:5.3.25] at org.springframework.beans.factory.support.DefaultListableBeanFactory.resolveDependency(DefaultListableBeanFactory.java:1311) ~[spring-beans-5.3.25.jar:5.3.25] at org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor$AutowiredFieldElement.resolveFieldValue(AutowiredAnnotationBeanPostProcessor.java:657) ~[spring-beans-5.3.25.jar:5.3.25] ... 74 common frames omitted 原因 Mybatis 会扫描接口并创建接口的代码对象交给 Spring 管理,但是现在并没有告诉 Mybatis 哪个是 dao 接口注意:Mysql 驱动版本大于 8.0 时,需要在 url 连接串中配置时区 jdbc:mysql://localhost:3306/ssm_db?serverTimezone=UTC,或在 MySQL 数据库端配置时区解决此问题解决方案:在 BookDao 接口上使用 @Mapper@Mapper public interface BookDao { @Select("select * from tbl_book where id = #{id}") public Book getById(Integer id); }4.2.4 定义测试类 @SpringBootTestclass Springboot03MybatisApplicationTests {
}4.2.5 编写配置 spring:datasource:driver-class-name: com.mysql.jdbc.Driverurl: jdbc:mysql://localhost:3306/ssm_dbusername: rootpassword: 1234564.2.6 使用 Druid 数据源添加依赖<dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.1.16</version> </dependency>添加配置,指定使用 Druid 数据源 spring: datasource: driver-class-name: com.mysql.jdbc.Driver url: jdbc:mysql://localhost:3306/ssm_db username: root password: 123456 type: com.alibaba.druid.pool.DruidDataSource5、基于 SpringBoot 的 SSM 整合案例本节内容是对上一篇 SSM 整合案例的改进,可参见 SpingMVC 学习笔记 - 第二章 -SSM 整合案例开发步骤 pom.xml:配置起步依赖,必要的资源坐标(druid)application.yml:设置数据源、端口等配置类:现在不需要了 dao:设置 @Mapper 测试类页面:放置在 resources 目录下的 static 目录中
server:port: 80
![](https://static001.geekbang.org/infoq/fa/fa815adc423b6241ec6ce3ea31bc8c64.png)
5.6 其他问题若再未加入前端代码时启动过服务器,加入前端代码后无法正常访问到页面时执行 Maven 的 clean 指令,再重新启动服务器(重新打包)即可 SpringBoot 版本问题、MySQL 时区问题、项目无法构建、配置文件打包乱码等问题,本节笔记中均有提及,可向上查阅原文链接:https://www.cnblogs.com/dandelion-000-blog/p/17084667.html
评论