SpringBoot可以通过添加相应的starter来很方便地整合第三方技术,例如Mybatis、Junit、Redis等。
1.SpringBoot整合Mybatis
MyBatis 是一款优秀的持久层框架,它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录。
接下来我们就在SpringBoot项目中整合Mybatis框架,来让我们的项目与数据库完成交互。
1.1引入Mybatis依赖
先在项目的pom文件中添加Mybatis的starter:
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.3.0</version>
</dependency>
1.2添加数据库驱动坐标
在pom文件中添加MySQL的驱动依赖,mysql-connector-java 是MySQL提供的JDBC驱动包,用JDBC连接MySQL数据库时必须使用该jar包。
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.6</version>
</dependency>
1.3添加数据库参数
接下来需要在application.properties中添加数据源参数,即数据库连接的4个参数:
server.port=8080
spring.datasource.driverClassName=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=root
spring.datasource.password=root
1.4准备数据
在数据库test中创建student表:
CREATE TABLE `student` (
`s_id` varchar(20) NOT NULL,
`s_name` varchar(20) NOT NULL DEFAULT ' ',
`s_birth` varchar(20) NOT NULL DEFAULT ' ',
`s_sex` varchar(10) NOT NULL DEFAULT ' ',
PRIMARY KEY (`s_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8
并插入数据:
insert into `student` (`s_id`, `s_name`, `s_birth`, `s_sex`) values('01','赵雷','1990-01-01','男');
insert into `student` (`s_id`, `s_name`, `s_birth`, `s_sex`) values('02','钱电','1990-12-21','男');
insert into `student` (`s_id`, `s_name`, `s_birth`, `s_sex`) values('03','孙风','1990-05-20','男');
insert into `student` (`s_id`, `s_name`, `s_birth`, `s_sex`) values('04','李云','1990-08-06','男');
insert into `student` (`s_id`, `s_name`, `s_birth`, `s_sex`) values('05','周梅','1991-12-01','女');
insert into `student` (`s_id`, `s_name`, `s_birth`, `s_sex`) values('06','吴兰','1992-03-01','女');
insert into `student` (`s_id`, `s_name`, `s_birth`, `s_sex`) values('07','郑竹','1989-07-01','女');
insert into `student` (`s_id`, `s_name`, `s_birth`, `s_sex`) values('08','王菊','1990-01-20','女');
1.5创建Student实体类
注意:实体类中的属性要与student表里的字段名一致,否则查回来的数据映射不到实体类里。
package com.example.demo.pojo;
import lombok.Data;
@Data
public class Student {
private String s_id;
private String s_name;
private String s_brith;
private String s_sex;
}
1.6创建Mapper
package com.example.demo.mapper;
import com.example.demo.pojo.Student;
import org.apache.ibatis.annotations.Mapper;
import java.util.List;
@Mapper
public interface StudentMapper {
public List<Student> queryStudentList();
}
注意:@Mapper标记该类是一个mybatis的mapper接口,可以被SpringBoot自动扫描到spring上下文中。
1.7配置Mapper映射文件
在src\main\resources\mapper路径下加入StudentMapper.xml配置文件:
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="com.example.demo.mapper.StudentMapper">
<select id="queryStudentList" resultType="com.example.demo.pojo.Student">
select * from student
</select>
</mapper>
1.8在application.properties中添加Mybatis的信息
#pojo别名扫描包
mybatis.type-aliases-package=com.example.demo.pojo
#加载Mybatis映射文件
mybatis.mapper-locations=classpath:mapper/*Mapper.xml
1.9编写测试Controller
package com.example.demo.controller;
import com.example.demo.mapper.StudentMapper;
import com.example.demo.pojo.Student;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import java.util.List;
@Controller
public class StudentController {
@Autowired
private StudentMapper studentMapper;
@RequestMapping("/queryStudent")
@ResponseBody
public List<Student> queryStudent(){
List<Student> result = studentMapper.queryStudentList();
return result;
}
}
**注意:**注入studentMapper报错:
需要把mapper接口的注释@Mapper改为@Repository,再在启动类上添加@MapperScan注解(启动时扫描要注入的mapper),这样Spring就可以把mapper自动注入。
package com.example.demo;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
@MapperScan("com.example.demo.mapper")
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
测试:
2.SpringBoot整合Junit
JUnit 是一个 Java 编程语言的单元测试框架。JUnit 在测试驱动的开发方面有很重要的发展,是起源于 JUnit 的一个统称为 xUnit 的单元测试框架之一。
JUnit 促进了“先测试后编码”的理念,强调建立测试数据的一段代码,可以先测试,然后再应用。这个方法就好比“测试一点,编码一点,测试一点,编码一点……”,增加了程序员的产量和程序的稳定性,可以减少程序员的压力和花费在排错上的时间。
接下来我们就在SpringBoot项目中整合Junit框架,提高代码测试效率。
2.1添加Junit的起步依赖
在项目的pom文件中添加Junit依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<scope>test</scope>
</dependency>
junit依赖也要引入,否则会报错。
2.2编写测试类
1.在StudentController类上按住Ctrl+shift+T,生成它的测试类:
3.编写测试类:
package com.example.demo.controller;
import com.example.demo.DemoApplication;
import com.example.demo.mapper.StudentMapper;
import com.example.demo.pojo.Student;
import org.junit.jupiter.api.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
import java.util.List;
import static org.junit.jupiter.api.Assertions.*;
@RunWith(SpringRunner.class)
@SpringBootTest(classes = DemoApplication.class)
class StudentControllerTest {
@Autowired
private StudentController studentController;
@Test
void queryStudent() {
List<Student> result = studentController.queryStudent();
System.out.println("查询结果:"+result);
}
}
@RunWith(SpringRunner.class)的作用表明测试类要使用注入的类,本例中的StudentController,有了@RunWith(SpringRunner.class)这些类才能实例化到spring容器中,自动注入才能生效,否则会报NullPointerException异常。
@SpringBootTest替代了spring-test中的@ContextConfiguration注解,目的是加载ApplicationContext,启动spring容器,注解后面的括号里可以设置项目的启动类。
3.运行测试类
运行queryStudent():
查询到数据库中的数据,测试类运行正常。
3.SpringBoot整合SpringData JPA
Spring Data JPA是Spring基于ORM框架,JPA规范的基础上封装的一套JPA应用框架,可使开发者能够用极简的代码实现对数据库的访问操作。它提供包括增删查改等在内的常用功能,而且易于扩展。
3.1添加Spring Data JPA的起步依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
数据库驱动依赖已经添加到pom文件中了,不需要再引入。
3.2在application.properties中配置数据库和jpa的相关属性
#JPA Configuration:
spring.jpa.database=MySQL
spring.jpa.show-sql=true
spring.jpa.generate-ddl=true
spring.jpa.hibernate.ddl-auto=update
spring.jpa.hibernate.naming_strategy=org.hibernate.cfg.ImprovedNamingStrategy
3.3创建实体配置实体
@Entity(name = "user")
public class User {
// 主键
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
// 用户名
private String username;
// 密码
private String password;
// 姓名
private String name;
}
@Entity说明这个类是实体类,并且使用默认的orm规则,即类名就是数据库表中表名,也可以在注解后面的括号里输入对应的数据库表明,格式=(name = “user”),类的属性对应表中字段名。
@Id定义属性为数据库的主键,一个实体里面必须有一个。
@GeneratedValue为主键生成策略,有两个属性,分别是strategy和generator。
1.strategy的值有以下四种:
AUTO–主键由程序控制, 是默认选项 ,不设置就是这个;
IDENTITY–主键由数据库生成, 采用数据库自增长, Oracle不支持这种方式;
SEQUENCE–通过数据库的序列产生主键, MYSQL 不支持;
Table–提供特定的数据库产生主键, 该方式更有利于数据库的移植
2.generator的默认值为“”,还可以取JDBC/UUID,分别是自增和雪花算法生成主键。
先解析注解@GeneratedValue 中的generator,如果generator的值不是UUID 和 JDBC时,再判断 strategy的值。
3.4编写UserRepository
UserRepository接口继承JpaRepository接口,就可以使用JpaRepository中的常用增删改查方法。
package com.example.demo.mapper;
import com.example.demo.pojo.User;
import org.springframework.data.jpa.repository.JpaRepository;
import java.util.List;
public interface UserRepository extends JpaRepository<User,Long> {
public List<User> findAll();
}
JpaRepository接口:
3.5编写测试类
package com.example.demo.controller;
import com.example.demo.DemoApplication;
import com.example.demo.mapper.UserRepository;
import com.example.demo.pojo.User;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
import java.util.List;
@RunWith(SpringRunner.class)
@SpringBootTest(classes= DemoApplication.class)
public class JpaTest {
@Autowired
private UserRepository userRepository;
@Test
public void test(){
List<User> users = userRepository.findAll();
System.out.println(users);
}
}
测试:
本节介绍了SpringBoot整合Mybatis、Junit、SpringData Jpa,下节继续介绍其他第三方技术的整合。