Springboot整合Mybatis
在项目的技术选型中,持久层框架常用的有Hibernate/JPA,Mybatis,JDBC等等,虽然特别喜欢JPA的简洁强大,不过在一些项目上还是必须得使用Mybatis这个小巧,面向SQL的持久层框架,结合Springboot,将之前的技术融合到新技术中,所以写了这个测试demo,该测试只单独写了持久层代码,不包含web和业务,即整合了springboot和mybatis后,再加一个单元测试。
测试一 「完全注解形式」
1.pom.xml 配置文件中引入 mybatis-spring-boot-starter ,支持mybatis相关类库
<dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>1.3.1</version> </dependency>
2.项目的父工程为 spring-boot-starter-parent , 这是springboot项目必须的。
<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>1.5.8.RELEASE</version> <relativePath/> </parent>
3.该测试数据库使用Mysql,因此也需要引入mysql驱动jar包。
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency>
4.创建Mapper接口,使用注解配置SQL和方法之间的关系,接口如下:
public interface UserMapper { /** * 查找全部用户信息 * @return all users */ @Select("select * from user") @Results({ @Result(property = "uid",column = "id"), @Result(property = "username",column = "name") }) public List<User> findAll(); /** * 添加用户信息 * @param user user obj */ @Insert("insert into user values (null,#{username},#{age})") public void inser(User user); /** * 根据 id 删除用户信息 * @param uid 用户id */ @Delete("delete from user where id = #{value}") public void delete(Integer uid); }
说明:
4.1 @Result : 为了测试使用,我的实体类User与数据库user表列不一样,即当属性和列名不一致时,需要指明property和 column之间的映射关系,根据业务需要还可以配置所对应的javaType,jdbcType(数据库对应类型),多对一和一对 一等其他复杂映射,具体可参见XML配置中的ResultMap,它们其实本质相同。
4.2 其他配置项可根据XML配置等推测该注解的所能表示的功能,不细述。
5.编写单元测试
@RunWith(SpringRunner.class) @SpringBootTest @MapperScan("cn.myxinge.mapper") //这里是在Spring初始化是提供Mapper所在包,该注解放在程序入口即可 public class BootDemoMybatisApplicationTests { //注入mapper @Autowired private UserMapper userMapper; /** * 测试mybatis配置是否完成 */ @Test public void contextLoads() { List<User> users = userMapper.findAll(); System.out.println(users); //---------------------------- User user = new User(); user.setUsername("这是测试数据 Name"); user.setAge(100); // userMapper.inser(user); //------------ userMapper.delete(10); } }
6.测试结束,此时可以进行简单增删改查。
测试二 「XML配置文件形式」
1.使用XML配置文件形式整合Mybatis和Springboot,思路和注解方式基本一致,结合之前Spring+Mybatis配置的方式,我们需要思考的点在于:
a. 告诉spring mybatis的config配置文件位置;
b. 告诉spring mybatis的mappper配置文件位置;
c. 写接口mapper
d. 注入,使用。
现在开始相关配置
2.在 application.propertis 中添加配置
mybatis.config-location=classpath:mybatis/sqlMapConfig.xml mybatis.mapper-locations=classpath:mapper/*.xml
3.编写 sqlMapConfig.xml
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> </configuration>
4.编写Mapper接口
/** * * 使用xml配置的Mapper */ public interface UserMapperByXML { /** * 查找全部用户信息 * * @return all users */ public List<User> findAll(); /** * 添加用户信息 * * @param user user obj */ public void inser(User user); /** * 根据 id 删除用户信息 * * @param uid 用户id */ public void delete(Integer uid); }
5.编写UserMapper.xml
<?xml version="1.0" encoding="utf8"?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="cn.myxinge.mapper.UserMapperByXML"> <resultMap id="userMap" type="cn.myxinge.pojo.User"> <id property="uid" column="id" jdbcType="BIGINT"></id> <result property="username" column="name" jdbcType="VARCHAR"></result> <result property="age" column="age" jdbcType="BIGINT"></result> </resultMap> <select id="findAll" resultMap="userMap"> SELECT * FROM user </select> <insert id="inser" parameterType="cn.myxinge.pojo.User"> insert into user values (null,#{username},#{age}) </insert> <delete id="delete" parameterType="java.lang.Integer"> delete from user where id = #{value} </delete> </mapper>
6.开始测试,测试代码和上述的注解形式开发无多少区别,这里就不贴出来了,如需源码,下面会有该项目的GitHub地址。
总结:
该demo结合了Springboot和Mybatis,使用注解形式和xml配置形式搭建了最简易的持久层代码实现,出于本人也在 学习中,该测试也是自己做的笔记,所以将很多东西都简单化,没有包含太多东西,比如Mybatis的一些配置细节,数据库连接池的配置,缓存等等,如果哪里有错误或需要修改地方,可以留言给我,感谢。
09:21:36 2017-11-23