spring-boot 集成 MyBatis
1. 前言
spring-boot 可谓是 Java 领域中最火的框架之一, 也是目前 Java 应用开发的事实标准,如果不会使用未免有些 out。本小节,我们将一起学习如何使用 spring-boot 来集成 MyBatis。
- 项目初始化
对于拥有 IDEA 专业版的人来说,新建 spring-boot 项目是十分方便的,当然如果你没有也没关系,Spring 官方给我们提供了一个快速新建项目的网站。
2. 项目初始化
对于拥有 IDEA 专业版的人来说,新建 spring-boot 项目是十分方便的,当然如果你没有也没关系,Spring 官方给我们提供了一个快速新建项目的网站。
给项目输入合适的 groupId 和 artifactId 然后点击生成按钮,浏览器会自动下载一个压缩包 springboot-mybatis-exmaple.zip。
解压该包,并通过 IDE 打开这个项目
3. 启动器
在项目的 pom 文件中添加如下 3 个依赖:
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.1.1</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.18</version>
</dependency>
mybatis-spring-boot-starter 是 MyBatis 为 spring-boot 提供的启动器,添加后就可以以少量的配置来快速的使用 MyBatis;spring-boot-starter-web 是 spring-boot 提供的 Web 启动器,会给我们提供一个 Web 应用环境;mysql-connector-java 是 MySQL 数据库驱动依赖。
4. 配置
在 src/main/resources 有 spring-boot 提供的默认配置文件 application.properties。在该配置文件下,我们需要添加上对于的数据源配置。
# 数据源配置,请修改为你项目的实际配置 spring.datasource.url=jdbc:mysql://localhost:3306/imooc spring.datasource.username=root spring.datasource.password=123456 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Drive
5. 实践
5.1 模型层
在项目的 com.imooc.mybatis.springbootmybatisexample 的包下新建 model 包,并在该包下新建 User 类。如下:
public class User implements Serializable {
private Long id;
private String username;
private Integer age;
private Integer score;
// 省略 getter 和 setter 方法
}
User 类与数据表 imooc_user 对应。
5.2 数据访问层
在 com.imooc.mybatis.springbootmybatisexample 包下新建 mapper 包,并新建 UserMapper 类。如下:
import org.apache.ibatis.annotations.Mapper;
@Mapper
public interface UserMapper {
5.3 控制层
在 com.imooc.mybatis.springbootmybatisexample 包下新建 controller 包,并新建 UserController 类。如下:
import org.springframework.web.bind.annotation.RestController;
@RestController
public class UserController {
}
使用 RestController 注解将 UserController 标记为控制器。
5.4 完善
有了雏形后,我们再为这些类添加上具体的业务,比如查询所有 imooc_user 用户。
在 UserMapper 中,我们添加上 getUsers 接口方法,并通过 Select 注解来映射相应的 SQL 语句。
@Mapper
@Repository
public interface UserMapper {
@Select("SELECT * FROM imooc_user")
List<User> getUsers();
}
在 UserController 中,我们添加上对应的 getUsers API,该 API 对外暴露所有用户数据。
@RestController
@RequestMapping("/user")
public class UserController {
@Autowired
private UserMapper userMapper;
@GetMapping
public List<User> getUsers() {
return userMapper.getUsers();
}
}
5.5 测试
运行项目,如果你使用 IDE,可直接通过按钮来运行,如果没有也可使用终端来运行程序:
mvn spring-boot:run
运行成功后,我们测试一下:
curl 127.0.0.1:8080/user/
[{"id":1,"username":"peter","age":18,"score":100}, {"id":2,"username":"pedro","age":24,"score":200}, {"id":3,"username":"jerry","age":28,"score":500}]