快速上手
SpringBoot是由Pivotal团队提高的全新框架,其设计目的是用来简化Spring应用的初始化搭建以及开发过程
入门案例
在Idea创建
创建时要选择Spring Initializr。
Server URL为要连接的网站,默认为官网start.spring.io(访问速度慢,可能会经常失败),可以使用阿里云的start/aliyun.com
name为项目名,Language选择Java,Type选择Maven,JDK版本要与Java版本相对应(java >= JDK),打包方式选择jar包
Spring Boot为使用的版本,创建后还可以更改,可以直接选择所要加入的依赖。现在创建一个最简单的案例,只需要勾选Spring Web即可
创建后工程只需要创建一个Controller类,加上注解即可直接运行
@RestController
@RequestMapping("/hero")
public class HeroController {@RequestMapping("/index")public String index(){return "index";}}
在网站创建
工程除了可以在Idea创建,还可以在网站创建。访问Spring Boot官网https://start.spring.io(访问速度可能会比较慢)或访问阿里云的https://start.aliyun.com
Java版本可以在高级选项里选择。获取代码后将其解压后即可使用Idea打开
创建工程后导入
导入坐标
<?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><groupId>com.GLATY</groupId><artifactId>StudySpringBoot</artifactId><version>0.0.1-SNAPSHOT</version><properties><java.version>1.8</java.version><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding><spring-boot.version>2.6.13</spring-boot.version></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency></dependencies><dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>${spring-boot.version}</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement></project>
写引导类
类上要加@SpringBootApplication注解
@SpringBootApplication
public class StudySpringBootApplication {public static void main(String[] args) {SpringApplication.run(StudySpringBootApplication.class, args);}}
入门案例解析
parent
开发SpringBoot程序要继承spring-boot-starter-parent
spring-boot-starter-parent中定义了若干个依赖管理
继承parent模块可以避免多个依赖使用相同技术时出现依赖版本冲突
继承parent的形式也可以采用引入依赖的形式实现效果
parent是SpringBoot中常见项目名称,定义了当前项目使用的所有依赖坐标,以达到减少依赖配置的目的。也就是配置好版本,可以直接使用
spring-boot-starter-parent各版本间存在着诸多坐标版本不同,如发生坐标错误,再指定Version(要小心版本冲突)
starter
使用starter可以实现快速配置的效果,达到简化配置的目的
starter是所有SpringBoot项目要继承的项目,定义了若干个坐标版本号(依赖管理,而非依赖),以达到减少依赖冲突的目的。也就是在导入坐标时会帮你调用parent中的版本
使用任意坐标时,仅书写GAV中的G和A,V由SpringBoot提供,除非SpringBoot未提供对应版本V
引导类
SpringBoot的引导类是Boot工程的执行入口,运行main方法就可以启动项目
SpringBoot工程运行后初始化Spring容器,扫描引导类所在包加载bean
内嵌Tomcat
内嵌Tomcat服务器是SpringBoot辅助功能之一
在Spring中内嵌了Tomcat,其运行原理是将Tomcat服务器作为对象运行,并将该对象交给Spring容器管理。同时也方便更改服务器。
<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><exclusions><!--排除Tomcat服务器--><exclusion><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-tomcat</artifactId></exclusion></exclusions></dependency><!--添加Jetty起步依赖,版本由SpringBoot的starter控制--><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-jetty</artifactId></dependency>
</dependencies>
内置服务器除了tomcat还有jetty和undertow
tomcat:apache出品,应用面广,负载了若干较重的组件
jetty:更轻量级、负载性能远不及tomcat
undertow:undertow,负载性能勉强跑赢tomcat
基础配置
属性配置
SpringBoot默认配置文件application.properties,通过键值对配置对应属性
server.port=80
关闭运行日志图标(banner)
spring.main.banner-mode=off
设置日志相关
logging.level.root=debug
SpringBoot中导入对应starter后,提供对应配置属性
书写SpringBoot配置采用关键字+提示形式书写
配置文件分类
SpringBoot提供了多种属性配置方式
1.application.properties(传统格式/默认格式):
server.port=80
2.application.yml(主流格式):
server:
port: 81
3.application.yaml:
server:
port: 82
yaml文件
yaml
YAML(YAML Ain't Markup Language),一种数据序列化格式
优点:
容易阅读
容易与脚本语言交互
以数据为核心,重数据轻格式
YAML文件扩展名
.yml(主流)
.yaml
yaml语法规则
大小写敏感
属性层级关系使用多行描述,每行结尾使用冒号结束
使用缩进表示层级关系,同层级左侧对齐,只允许使用空格(不允许使用Tab键)
属性值前面添加空格(属性名与属性值之间使用冒号+空格作为分隔)
# 表示注释
核心规则:数据前面要加空格与冒号隔开
字面值表示方式
boolean: TRUE #TRUE,true,True,FALSE,false,False均可
float: 3.14 #6.8523015e+5 #支持科学计数法
int: 123 #0b1010_0111_0100_1010_1110 #支持二进制、八进制、十六进制
null: ~ #使用~表示null
string: HelloWorld #字符串可以直接书写
string2: "Hello World" #可以使用双引号包裹特殊字符
date: 2018-02-17 #日期必须使用yyyy-MM-dd格式
datetime: 2018-02-17T15:02:31+08:00 #时间和日期之间使用T连接,最后使用+代表时区
数组表示方式:在属性名书写位置的下方使用减号作为数据开始符号,每行书写一个数据,减号与数据间空格分隔
subject:- Java- 前端- 大数据
enterprise:name: itcastage: 16subject:- Java- 前端- 大数据
# 数组书写缩略格式
likes: [ 永劫无间,植物大战僵尸 ]# 对象数组格式
user1:- name: Tomage: 4- name: Jerryage: 5
# 对象数组格式二
user2:-name: Tomage: 4-name: Jerryage: 5
# 对象数组缩略格式
users: [ { name:Tom , age:4 } , { name:Jerry , age:5 } ]
yaml数据读取
使用@Value配合SpEL读取单个数据,属性名引用方式:${一级属性名.二级属性名……}
@Value("${user1.name}")
int name;@Value("${like[1]}")
String like;
在配置文件中可以使用属性名引用方式引用属性
baseDir: /usr/local/fire
center:dataDir: ${baseDir}/datatmpDir: ${baseDir}/tmplogDir: ${baseDir}/logmsgDir: ${baseDir}/msgDir
属性值中如果出现转移字符,需要使用双引号包裹
lesson: "Spring\tboot\nlesson"
//作用自动装配将所有数据封装到一个对象中
@Autowired
Environment environment;@RequestMapping("/index")
public String index(){System.out.println(environment.getProperty("server.port"));return "index";
}
@Component //将对象交给bean管理
@ConfigurationProperties(prefix = "datasource") //指定加载的数据
public class UseDataSource {private String drive;private String url;private String username;private String password;// ......
}
整合第三方技术
通用方式:先导入对应的starter,然后根据提供的配置格式配置非默认值对应的配置项
整合JUnit
1.导入测试对应的starter
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope>
</dependency>
2.测试类使用@SpringBootTest修饰
@SpringBootTest(classes = StudySpringBootApplication.class)
class StudySpringBootApplicationTests {@Testvoid contextLoads() {}}
*创建项目时就将junit到入的话测试类会自动创建好
*如果测试类在SpringBoot启动类的包或子包中,可以省略启动类的设置,也就是省略classes的设定
整合MyBatis
1.导坐标(如果在创建工程的时候勾选后SpringBoot会将坐标自动导入)
<dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId><version>2.2.2</version>
</dependency>
<dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId>
</dependency>
2.配置application文件
spring:datasource:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306/secondtable?serverTimezone=UTCusername: rootpassword: 123456
3.在mapper接口上加上@Mapper注解
@Mapper
public interface HeroMapper {public Hero selectById(@Param("id") Integer id);}
整合MyBatis-Plus
MyBatis-Plus简称mp,在中国人自己制造的技术。
MyBatis-Plus与MyBatis的区别:导入坐标不同、数据层实现简化
SpringBoot中未收录MyBatis-Plus的坐标版本,需要指定对应的Version
1.导入坐标
<dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-boot-starter</artifactId><version>3.4.3</version>
</dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId>
</dependency>
2. 定义数据层接口与映射配置,继承BaseMapper(源码注释是汉语)
@Mapper
public interface HeroMapper extends BaseMapper<Hero> {}
其他同SpringBoot整合MyBatis
MyBatis-Plus相关配置可以在application设置
#设置MyBatis-Plus相关配置
mybatis-plus:global-config:db-config:table-prefix:
整合Druid
导入坐标
<dependency><groupId>com.alibaba</groupId><artifactId>druid-spring-boot-starter</artifactId><version>1.2.6</version>
</dependency>
配置application文件
#数据源通用配法
#spring:
# datasource:
# driver-class-name: com.mysql.cj.jdbc.Driver
# url: jdbc:mysql://localhost:3306/secondtable?serverTimezone=UTC
# username: root
# password: 123456
# type: com.alibaba.druid.pool.DruidDataSource#专用配发,建议使用
spring:datasource:druid:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306/secondtable?serverTimezone=UTCusername: rootpassword: 123456
SSMP整合
实体类快速开发(lombok)
使用lombok可以快速开发实体类
导入lombok坐标(lombok版本由SpringBoot提供,无需指定版本)
<!--lombok坐标,用于快速创建实体类-->
<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId>
</dependency>
创建实体类,加注解
@Data //@Data注解为实体类在编译时期设置对应的get方法,set方法,toString方法,hashCode方法,equals方法等
@AllArgsConstructor
@NoArgsConstructor
public class Hero {private String name;private Integer id;private String codeName;private Integer ability;
}
数据层标准开发(基于CRUD)
搭建环境
导入MyBatisPlus与Druid对应的starter
<dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-boot-starter</artifactId><version>3.4.3</version>
</dependency>
<dependency><groupId>com.alibaba</groupId><artifactId>druid-spring-boot-starter</artifactId><version>1.2.6</version>
</dependency>
配置数据源与MyBatisPlus对应的基础配置(id生成策略使用数据库自增策略)
spring:datasource:druid:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306/secondtable?serverTimezone=UTCusername: rootpassword: 123456mybatis-plus:global-config:db-config:id-type: auto
mapper接口继承BaseMapper并指定泛型
@Mapper
public interface HeroMapper extends BaseMapper<Hero> {}
*开启MP日志
mybatis-plus:global-config:db-config:id-type: autoconfiguration:log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
分页查询
分页操作是在MyBatisPlus的常规操作基础上增强得到,内部是动态的拼写SQL语句,因此需要增强对应的功能,使用MyBatisPlus拦截器实现
创建类编辑连接器
@Configuration
public class MPConfig {@Beanpublic MybatisPlusInterceptor mpInterceptor() {//1.定义Mp拦截器MybatisPlusInterceptor mpInterceptor = new MybatisPlusInterceptor();//2.添加具体的拦截器mpInterceptor.addInnerInterceptor(new PaginationInnerInterceptor());return mpInterceptor;}
}
测试分页
@Test
void Testpage() {IPage page = new Page(1, 5);heroMapper.selectPage(page, null);System.out.println(page.getRecords());page.setCurrent(2);heroMapper.selectPage(page, null);System.out.println(page.getRecords());
}
条件查询
使用QueryWrapper对象封装查询条件,推荐使用LambdaQueryWrapper对象,所有查询操作封装成方法调用
@Test
void Test2() {String name = "天";QueryWrapper<Hero> queryWrapper = new QueryWrapper<>();queryWrapper.like(name != null,"name", name);System.out.println(heroMapper.selectList(queryWrapper));
}
@Test
void Test3() {String name = "天";LambdaQueryWrapper<Hero> queryWrapper = new LambdaQueryWrapper<>();queryWrapper.like(name != null,Hero::getName, name);System.out.println(heroMapper.selectList(queryWrapper));
}
业务层标准开发
基础CRUD
Service层接口定义与数据层接口定义具有较大区别,不要混用
定义接口
public interface HeroService {public boolean save(Hero hero);public boolean update(Hero hero);public boolean deleteById(Integer id);public Hero searchById(Integer id);public List<Hero> searchAllHero();public IPage<Hero> searchByPage(int currentPage, int pageSide);
}
实现类定义
import java.util.List;@Service
public class HeroServiceImpl implements HeroService {@Autowiredprivate HeroMapper mapper;@Overridepublic boolean save(Hero hero) {return mapper.insert(hero) > 0;}@Overridepublic boolean update(Hero hero) {return mapper.updateById(hero) > 0;}@Overridepublic boolean deleteById(Integer id) {return mapper.deleteById(id) > 0;}@Overridepublic Hero searchById(Integer id) {return mapper.selectById(id);}@Overridepublic List<Hero> searchAllHero() {return mapper.selectList(null);}@Overridepublic IPage<Hero> searchByPage(int currentPage, int pageSide) {return mapper.selectPage(new Page<>(currentPage, pageSide), null);}}
基于MyBatisPuls构建
使用MyBatisPlus提供有业务层通用接口(ISerivce<T>)与业务层通用实现类(ServiceImpl<M,T>)
在通用类基础上做功能重载或功能追加
注意重载时不要覆盖原始操作,避免原始提供的功能丢失
定义接口
public interface IHeroService extends IService<Hero> {}
定义实现类
public class HeroServiceImplMp extends ServiceImpl<HeroMapper, Hero> implements IHeroService {}
表现层标准开发
表现层接口开发
@RestController
@RequestMapping("/hero")
public class HeroController {@AutowiredHeroServiceImpl heroServiceImpl;@GetMapping("/{id}")public Hero getById(@PathVariable Integer id) {return heroServiceImpl.searchById(id);}@GetMapping("/")public List<Hero> getAllHero() {return heroServiceImpl.searchAllHero();}@PostMapping("/")public void saveHero(@RequestBody Hero hero) {heroServiceImpl.save(hero);}@DeleteMapping("/{id}")public void deleteById(@PathVariable Integer id) {heroServiceImpl.deleteById(id);}@PutMapping("/")public void update(@RequestBody Hero hero) {heroServiceImpl.update(hero);}@GetMapping("/{currentPage}/{pageSide}")public List<Hero> searchByPage(@PathVariable Integer currentPage,@PathVariable Integer pageSide) {return heroServiceImpl.searchByPage(currentPage, pageSide).getRecords();}
}
消息一致性处理
设计表现层返回结果的模型类,用于后端与前端进行数据格式统一,也称为前后端数据协议。表现层接口统一返回值类型结果
@Data
@Component
public class Res {private int code;//类似于状态码private Object data;//储存前端所需要的数据private String msg;//信息说明public Res() {}public Res(int code, Object data, String msg) {this.code = code;this.data = data;this.msg = msg;}
}
异常消息处理
如果服务器出现异常,返回给前端的数据将时默认的,需要添加异常处理器来处理异常。
//作为SpringMVC的异常处理器
//@ControllerAdvice
@RestControllerAdvice
public class ProjectExceptionAdvice {@ExceptionHandlerpublic Res doException1(Exception e) {// 记录日志// 通知运维// 通知开发e.printStackTrace();return new Res(500, null, "error");}// 还可以处理指定异常类型@ExceptionHandler(Exception.class)public Res doException2(Exception e) {// 记录日志// 通知运维// 通知开发e.printStackTrace();return new Res(500, null, "error");}
}