以往在使用Spring集成Mybatis都伴随着大量配置文件,而Spring Boot摒弃了繁琐的配置文件,可以快速的整合Mybatis,做到“2分钟”搭建web框架。
Mybatis官方文档:http://www.mybatis.org/spring-boot-starter
GitHub:https://github.com/mybatis/mybatis-spring-boot
Spring Boot整合Mybatis有两种方式,一种是基于注解的;另一种是使用xml,这也是官方推荐的一种,本文使用xml方式完成整合。
在上篇文章中已经使用Spring Boot搭建了一个简单的web项目,整合Mybatis很简单,只需要在pom文件中加入以下依赖即可
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>1.2.0</version>
</dependency>
使用的是mysql数据库,加入依赖。
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.29</version>
</dependency>
本人在整合mysql时候还遇到了一点小问题,因为Spring Boot会选用对应的依赖版本,所以刚开始没有加上版本标签,运行项目时候抛出这样一个异常。
org.springframework.jdbc.CannotGetJdbcConnectionException:
Could not get JDBC Connection; nested exception is java.sql.SQLException: Unknown system variable 'language'
后来发现Spring Boot默认加载的mysql版本是5.1.40的,而本人的是5.1.29版本,加上版本之后完美启动。
可以在命令窗口通过mysql -V查询自己的mysql版本
然后就可以写Mapper接口和对应Mapper.xml文件了,在写Mapper接口和Mapper.xml时尽量保持两者名称一致,以便方便查找,当然不一致完全没有问题。注意两者定义的方法名是需要保持一致的
StudentMapper.java
package com.springboot.mapper;
import org.apache.ibatis.annotations.Mapper;
import com.springboot.enity.Student;
/**
* @Mapper 可以不写,只需要在启动类加上注解@MapperScan 然后指定Mapper接口所在包路径即可
*/
//@Mapper
public interface StudentMapper {
Student getById(Integer id);
}
student.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.springboot.mapper.StudentMapper">
<select id="getById" parameterType="java.lang.Integer" resultType="com.springboot.enity.Student">
select id,name,age from student where id = #{id}
</select>
</mapper>
实体Student.java
public class Student {
private Integer id;
private String name;
private Integer age;
/*
* getter and setter
*/
}
application.yml配置文件
spring:
datasource:
url : jdbc:mysql://127.0.0.1:3306/springboot_mybatis
driver-class-name: com.mysql.jdbc.Driver
username: root
password: root
mybatis:
mapper-locations:
- classpath:mybatis/*.xml #Mapper.xml文件位置
type-aliases-package: com.springboot.enity #实体位置
StudentController.java
package com.springboot.controller;
import javax.annotation.Resource;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import com.springboot.enity.Student;
import com.springboot.service.IStudentService;
@RestController
@RequestMapping("/student")
public class StudentController {
@Resource
private StudentMapper studentMapper;
@RequestMapping("/getById/{id}")
public Student getById(@PathVariable Integer id){
Student s = studentMapper.getById(id);
return s;
}
}
启动类
package com.springboot;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
//指定Mapper.java存放路径
@MapperScan(basePackages = "com.springboot.mapper")
public class MybatisSpringbootApplication {
public static void main(String[] args) {
SpringApplication.run(MybatisSpringbootApplication.class, args);
}
}
数据库表
启动项目,在浏览器访问:http://localhost:8080/student/getById/1显示结果如下
这样一个Spring Boot整合Mybatis项目就完成了,是不是非常简单