MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,简单的Java对象)映射成数据库中的记录。
一、MyBatis 简介
1.1 发展背景
在Java中,与数据库交互通常需要使用 JDBC 来手动管理连接、预处理语句、结果集等。这种方式的缺点是代码冗余,易出错,维护困难。MyBatis 旨在解决这个问题,它提供了一套完整的解决方案,通过半自动的方式简化了数据库操作。
1.2 核心特点
- 半自动化处理:MyBatis 只对 SQL 映射进行预处理和执行,其他数据库交互仍需程序员手动处理。
- 支持定制化 SQL:MyBatis 支持编写复杂的 SQL,并提供了丰富的动态 SQL 构建能力。
- 灵活的数据处理:MyBatis 支持多种数据类型,包括基本类型、对象、集合等。
- 易于扩展:MyBatis 提供了插件机制,方便开发者进行扩展。
二、快速上手
2.1 环境搭建
- 下载 MyBatis 和相关依赖:从 MyBatis 官网下载最新版本的 MyBatis 以及相关的依赖,如 JDBC、log4j 等。
- 配置 Maven 依赖:在项目的
pom.xml文件中添加 MyBatis 和相关依赖的 Maven 依赖。
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.23</version>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
</dependencies>
- 创建 MyBatis 配置文件:在项目根目录下创建
mybatis-config.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>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/mybatis/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
- 创建实体类:创建实体类
User.java,用于映射数据库中的用户表。
package com.mybatis.example.entity;
public class User {
private Integer id;
private String username;
private String password;
// getter 和 setter 方法
}
- 创建 Mapper 接口:创建
UserMapper.java接口,定义数据访问层的操作。
package com.mybatis.example.mapper;
import com.mybatis.example.entity.User;
import org.apache.ibatis.annotations.*;
public interface UserMapper {
@Select("SELECT * FROM user WHERE id = #{id}")
User findUserById(@Param("id") Integer id);
@Insert("INSERT INTO user(username, password) VALUES(#{username}, #{password})")
int insertUser(@Param("username") String username, @Param("password") String password);
@Update("UPDATE user SET username = #{username}, password = #{password} WHERE id = #{id}")
int updateUser(@Param("id") Integer id, @Param("username") String username, @Param("password") String password);
@Delete("DELETE FROM user WHERE id = #{id}")
int deleteUser(@Param("id") Integer id);
}
- 创建 Mapper XML 文件:创建
UserMapper.xml文件,定义 SQL 映射。
<?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.mybatis.example.mapper.UserMapper">
<resultMap id="userMap" type="com.mybatis.example.entity.User">
<result property="id" column="id"/>
<result property="username" column="username"/>
<result property="password" column="password"/>
</resultMap>
<select id="findUserById" resultMap="userMap">
SELECT * FROM user WHERE id = #{id}
</select>
<insert id="insertUser">
INSERT INTO user(username, password) VALUES(#{username}, #{password})
</insert>
<update id="updateUser">
UPDATE user SET username = #{username}, password = #{password} WHERE id = #{id}
</update>
<delete id="deleteUser">
DELETE FROM user WHERE id = #{id}
</delete>
</mapper>
2.2 编写 Java 代码
package com.mybatis.example.mapper;
import com.mybatis.example.entity.User;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
public class UserMapperTest {
public static void main(String[] args) {
try {
// 创建 SqlSessionFactory
SqlSessionFactory sqlSessionFactory = MyBatisUtil.getSqlSessionFactory();
// 创建 SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
// 获取 UserMapper
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 测试插入数据
User user = new User();
user.setUsername("admin");
user.setPassword("admin123");
userMapper.insertUser(user);
// 测试查询数据
User findUser = userMapper.findUserById(user.getId());
System.out.println(findUser.getUsername());
// 提交事务
sqlSession.commit();
// 关闭 SqlSession
sqlSession.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
三、实战技巧
3.1 使用注解
MyBatis 支持使用注解代替 XML 文件进行 SQL 映射,提高开发效率。
package com.mybatis.example.mapper;
import com.mybatis.example.entity.User;
import org.apache.ibatis.annotations.*;
public interface UserMapper {
@Select("SELECT * FROM user WHERE id = #{id}")
User findUserById(@Param("id") Integer id);
@Insert("INSERT INTO user(username, password) VALUES(#{username}, #{password})")
int insertUser(@Param("username") String username, @Param("password") String password);
@Update("UPDATE user SET username = #{username}, password = #{password} WHERE id = #{id}")
int updateUser(@Param("id") Integer id, @Param("username") String username, @Param("password") String password);
@Delete("DELETE FROM user WHERE id = #{id}")
int deleteUser(@Param("id") Integer id);
}
3.2 动态 SQL
MyBatis 提供了丰富的动态 SQL 功能,可以方便地构建复杂的 SQL 语句。
<select id="findUserByName" resultMap="userMap">
SELECT * FROM user
<where>
<if test="username != null">
AND username = #{username}
</if>
</where>
</select>
3.3 批量操作
MyBatis 支持批量插入、批量更新、批量删除等操作,提高数据库操作效率。
@Insert({
"<script>",
"INSERT INTO user(username, password) VALUES ",
"<foreach collection='users' item='user' separator=','>",
"(#{user.username}, #{user.password})",
"</foreach>",
"</script>"
})
int insertUsers(List<User> users);
四、总结
MyBatis 是一款功能强大、易于上手的持久层框架。通过本文的介绍,相信你已经对 MyBatis 有了一定的了解。在实际开发中,结合实际需求选择合适的持久层解决方案,能够提高开发效率和项目质量。希望本文对你有所帮助!
