1. 关于Spring Boot
Spring Boot是Spring官方的一个产品,其本质上是一个基于Maven的、以Spring框架作为基础的进阶框架,很好的支持了主流的其它框架,并默认完成了许多的配置,其核心思想是“约定大于配置”。
2. 创建Spring Boot工程
在IntelliJ IDEA中,在创建向导中选择Spring Initializer即可开始创建Spring Boot工程,在创建向导的界面中,需要关注的部分有:
- Group Id
- Artifact Id
以上2个值会共同构成一个Package name,如果Artifact Id的名字中有减号,在Package name中会去除,推荐手动添加小数点进行分隔。
由于Spring Boot官方更新版本的频率非常高,在创建项目时,随便选取某个版本均可,当项目创建成功后,推荐打开pom.xml
,将<parent>
中的<version>
(即Spring Boot父项目的版本)改成熟悉的版本,例如:2.5.9
在创建过程中,还可以在创建向导的界面中勾选所需要依赖项,如果创建时没有勾选,也可以在创建工程之后手动在pom.xml
中添加。
3. Spring Boot工程的结构
由于Spring Boot工程本质上就是一个Maven工程,所以,目录结构基本上没有区别。
与普通Maven工程最大的不同在于:Spring Boot工程在src\main\java
和src\test\java
下默认已经存在Package,是创建项目时指定的Package,**需要注意:此Package已经被配置为Spring执行组件扫描的根包,所以,在编写代码时,所有的组件类都必须放在此包或其子孙包中!**通常,推荐将所有的类(及接口)都创建在此包及其子孙包下。
在src\main\java
下的根包下,默认就已经存在某个类,其类名是创建项目时指定的Artifact与Application
单词的组合,例如BootDemoApplication
,此类中有main()
方法,执行此类的main()
就会启动整个项目,如果当前项目是Web项目,还会自动将项目部署到Web服务器并启动服务器,所以,此类通常也称之为“启动类”。
在启动类上,默认添加了@SpringBootApplication
注解,此注解的元注解中包含@SpringBootConfiguration
,而@SpringBootConfiguration
的元注解中包含@Configuration
,所以,启动类本身也是配置类!所以,允许将@Bean
方法写在此类中,或者某些与配置相关的注解也可以添加在此类上!
在src\test\java
下的根包下,默认就已经存在某个类,其类名是在启动类的名称基础上添加了Tests
单词的组合,例如BootDemoApplicationTests
,此类默认没有添加public
权限,甚至其内部的默认的测试方法也是默认权限的,此测试类上添加了@SpringBootTest
注解,其元注解中包含@ExtendWith(SpringExtension.class)
,与使用spring-test
时的@SpringJUnitTest
注解中的元注解相同,所以,@SpringBootTest
注解也会使得当前测试类在执行测试方法之前是加载了Spring环境的,在实际编写测试时,可以通过自动装配得到任何已存在于Spring容器中的对象,在各测试方法中只需要关注被测试的目标即可。
在pom.xml
中,默认已经添加了spring-boot-starter
和spring-boot-starter-test
依赖,分别是Spring Boot的基础依赖和基于Spring Boot的测试的依赖。
另外,如果在创建工程时,勾选依赖项时选中了Web
项,在src\main\resources
下默认就已经创建了static
和templates
文件夹,如果没有勾选Web
则没有这2个文件夹,可以后续自行补充创建。
在src\main\resources
文件夹下,默认就已经存在application.properties
文件,用于编写配置,Spring Boot会自动读取此文件(利用@PropertySource
注解)。
小结:
- 创建项目后默认的Package不要修改,避免出错
- 在编码过程中,自行创建的所有类、接口均放在默认的Package或其子孙包中
- 在
src\main\java
下默认已存在XxxApplication
是启动类,执行此类中的main()
方法就会启动整个项目 - 启动类本身也是配置类
- 配置都应该编写到
src\main\resources
下的application.properties
中,Spring Boot会自动读取 - 测试类也必须放在
src\test\java
下的默认Package或其子孙包中 - 在测试类上添加
@SpringBootTest
注解,则其中的测试方法执行之前会自动加载Spring环境及当前项目的配置,可以在测试类中使用自动装配
4. 在Spring Boot工程中使用Mybatis
需要添加相关依赖项:
mysql-connector-java
mybatis-spring-boot-starter
其依赖的代码为:
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.2.2</version>
</dependency>
说明:在Spring Boot工程,许多依赖项都是不需要显式的指定版本号的,因为在父项目中已经对这些依赖项的版本进行了管理(配置版本号),如果一定需要使用特定的版本,也可以自行添加<version>
节点进行配置
说明:在依赖项的源代码中,当<scope>
的值为runtime
时,表示此依赖项是运行过程中需要的,但是,在编译时并不需要参与编译
需要注意:当添加了以上数据库编程的依赖后,如果启动项目,将失败!
因为添加了数据库编程的依赖项后,Spring Boot就会尝试自动装配数据源(DataSource
)等对象,装配时所需的连接数据库的配置信息(例如URL、登录数据库的用户名和密码)应该是配置在application.properties
中的,但是,如果尚未配置,就会导致失败!
关于连接数据库的配置信息,Spring Boot要求对应的属性名是:
# 连接数据库的URL
spring.datasource.url=???
# 登录数据库的用户名
spring.datasource.username=???
# 登录数据库的密码
spring.datasource.password=???
在配置时,也必须使用以上属性名进行配置,则Spring Boot会自动读取这些属性对应的值,用于创建数据源对象!
例如,配置为:
# 连接数据库的URL
spring.datasource.url=jdbc:mysql://localhost:3306/mall_ams?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
# 登录数据库的用户名
spring.datasource.username=root
# 登录数据库的密码
spring.datasource.password=1234
由于Spring Boot在启动时只是加载以上配置,并不会实际的连接到数据库,所以,当以上配置存在时,启动就不会报错,但是,无法检验以上配置的值是否正确!
可以在测试类中添加测试方法,尝试连接数据库,以检验以上配置值是否正确:
@SpringBootTest
class BootDemoApplicationTests {
@Autowired
DataSource dataSource;
@Test
void testGetConnection() throws Exception {
System.out.println(dataSource.getConnection());
}
}
如果以上测试通过,则表示配置值无误,可以正确连接到数据库,如果测试失败,则表示配置值错误,需检查配置值及本地环境(例如MySQL是否启动、是否已创建对应的数据库等)。
5. 关于Profile配置
在Spring Boot中,对Profile配置有很好的支持,开发人员可以在src\main\resources
下创建更多的配置文件,这些配置文件的名称应该是application-???.properties
(其中的???
是某个名称,是自定义的)。
例如:
- 仅在开发环境中使用的配置值可以写在
application-dev.properties
中 - 仅在测试环境中使用的配置值可以写在
application-test.properties
中 - 仅在生产环境(项目上线的环境)中使用的配置值可以写在
application-prod.properties
中
当把配置写在以上这类文件后,Spring Boot默认并不会应用以上这些文件中的配置,当需要应用某个配置时,需要在application.properties
中激活某个Profile配置,例如:
# 激活Profile配置
spring.profiles.active=dev
提示:以上配置值中的dev
是需要激活的配置文件的文件名后缀,当配置为dev
时,就会激活application-dev.properties
,同理,如果以上配置值为test
,就会激活application-test.properties
。
6. 关于YAML配置
Spring Boot也支持使用YAML配置,在开发实践中,YAML的配置也使用得比较多。
YAML配置就是把原有的.properties
配置的扩展改为yml
。
YAML配置原本并不是Spring系列框架内置的配置语法,如果在项目中需要使用这种语法进行配置,解析这类文件需要添加相关依赖,在Spring Boot中默认已添加此依赖。
在YAML配置中,原本在.properties
的配置表现为使用多个小数点分隔的配置将改为换行并使用2个空格缩进的语法,换行前的部分使用冒号表示结束,最后的属性名与值之间使用冒号和1个空格进行分隔,如果有多条属性在.properties
文件中属性名有重复的前缀,在yml
中不必也不能重复写。
例如,原本在.properties
中配置为:
spring.datasource.username=root
spring.datasource.password=123456
则在yml
文件中配置为:
spring:
datasource:
username: root
password: 123456
提示:在IntelliJ IDEA中编写yml
时,当需要缩进2个空格时,仍可以使用键盘上的TAB键进行缩进,IntelliJ IDEA会自动将其转换为2个空格。
无论是.properties
还是yml
,只是配置文件的扩展名和文件内部的配置语法有区别,对于Spring Boot最终的执行其实没有任何表现上的不同。
7. 使用Druid数据库连接池
Druid数据库连接是阿里巴巴团队研发的,在Spring Boot项目中,如果需要显式的指定使用此连接池,首先,需要在项目中添加依赖:
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.1.20</version>
</dependency>
当添加了此依赖,在项目中需要应用时,需要在配置文件中指定spring.datasource.type
属性,取值为以上依赖项的jar包中的DruidDataSource
类型的全限定名。
例如,在yml
中配置为:
# Spring系列框架的配置
spring:
# 连接数据库的相关配置
datasource:
# 使用的数据库连接池类型
type: com.alibaba.druid.pool.DruidDataSource
8. 编写持久层(数据访问层)代码
数据持久化:在开发领域中,讨论数据时,通常指定是正在执行或处理的数据,这些数据都是在内存中的,而内存(RAM)的特征包含”一旦断电,数据将全部丢失“,为了让数据永久保存下来,通常会将数据存储到能够永久存储数据的介质中,通常是计算机的硬盘,硬盘上的数据都是以文件的形式存在的,所以,当需要永久保存数据时,可以将数据存储到文本文件中,或存储到XML文件中,或存储到数据库中,这些保存的做法就是数据持久化,而文本文件、XML文件都不利于实现增删改查中的所有数据访问操作,而数据库是实现增删改查这4种操作都比较便利的,所以,一般在讨论数据持久化时,默认指的都是使用数据库存储数据。
在项目中,会将代码(各类、接口)划分一些层次,各层用于解决不同的问题,其中,持久层就是用于解决数据持久化问题的,甚至,简单来说,持久层对应的就是数据库编程的相关文件或代码。
目前,使用Mybatis技术实现持久层编程,需要:
- 编写一次性的基础配置
- 使用
@MapperScan
指定接口所在的Base Package - 指定配置SQL语句的XML文件的位置
- 使用
- 编写每个数据访问功能的代码
- 在接口中添加必须的抽象方法
- 可能需要创建相关的POJO类
- 在XML文件中配置抽象方法映射的SQL语句
- 在接口中添加必须的抽象方法
关于一次性的配置,@MapperScan
注解需要添加在配置类上,有2种做法:
- 直接将此注解添加在启动类上,因为启动类本身也是配置类
- 自行创建配置类,在此配置类上添加
@MapperScan
如果采用以上的第2种做法,则应该在src\main\java
的根包下,创建config.MybatisConfig
类,并在此类使用@MapperScan
注解:
package cn.tedu.boot.demo.config;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Configuration;
@Configuration
@MapperScan("cn.tedu.boot.demo.mapper")
public class MybatisConfig {
}
另外,关于指定配置SQL语句的XML文件的位置,需要在application.yml
(或application.properties
)中配置mybatis.mapper-locations
属性,例如:
# Mybatis相关配置
mybatis:
# 用于配置SQL语句的XML文件的位置
mapper-locations: classpath:mapper/*.xml
基于以上的配置值,还应该在src/main/resources
下自行创建名为mapper
的文件夹。
至此,关于使用Mybatis实现数据库编程的一次性配置结束!
接下来,可以使用任何你已知的Mybatis使用方式实现所需的数据访问。
目前,设定目标为:最终实现”添加管理员账号“的功能。则在数据访问层需要做到:
- 插入管理员数据
- 创建
cn.tedu.boot.demo.entity.Admin
类 - 在
cn.tedu.boot.demo.mapper
包(不存在,则创建)下创建AdminMapper
接口,并在接口中声明int insert(Admin admin);
方法 - 在
src/main/resources/mapper
文件夹下通过粘贴得到AdminMapper.xml
文件,在此文件中配置与以上抽象方法映射的SQL语句 - 编写完成后,应该及时测试,测试时,推荐在
src/test/java
的根包下创建mapper.AdminMapperTests
测试类,并在此类中编写测试方法
- 创建
- 根据用户名查询管理员数据
- 后续,在每次插入数据之前,会调用此功能进行查询,以此保证”重复的用户名不会被添加到数据库中“
- 即便在数据表中用户名已经添加了
unique
,但是,不应该让程序执行到此处
- 即便在数据表中用户名已经添加了
- 在
AdminMapper
接口中添加Admin getByUsername(String username);
方法 - 在
AdminMapper.xml
文件中添加与以上抽象方法映射的SQL语句 - 编写完成后,应该及时测试
- 后续,在每次插入数据之前,会调用此功能进行查询,以此保证”重复的用户名不会被添加到数据库中“
- 其它问题暂不考虑,例如在
ams_admin
中,其实phone
和email
也是设置了unique
的,如果完整的实现,则还需要添加根据phone
查询管理员的功能,和根据email
查询管理员的功能,在不实现这2个功能的情况下,后续进行测试和使用时,应该不使用重复的phone
和email
值来测试或执行
9. 关于业务逻辑层(Service层)
业务逻辑层是被Controller直接调用的层(Controller不允许直接调用持久层),通常,在业务逻辑层中编写的代码是为了保证数据的完整性和安全性,使得数据是随着我们设定的规则而产生或发生变化。
通常,在业务逻辑层的代码会由接口和实现类组件,其中,接口被视为是必须的
- 推荐使用基于接口的编程方式
- 部分框架在处理某些功能时,会使用基于接口的代理模式,例如Spring JDBC框架在处理事务时
在接口中,声明抽象方法时,仅以操作成功为前提来设计返回值类型(不考虑失败),如果业务在执行过程可能出现某些失败(不符合所设定的规则),可以通过抛出异常来表示!
关于抛出的异常&