MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
MyBatis 简介
什么是MyBatis?
MyBatis 是一个半自动的持久层框架,它将 SQL 语句与 Java 代码分离,使得数据库操作更加简单和灵活。它通过映射文件或注解来定义 SQL 语句,从而避免在 Java 代码中直接编写 SQL,降低了代码的复杂性。
MyBatis 的优势
- 简化开发:减少数据库操作代码,提高开发效率。
- 灵活配置:通过 XML 或注解配置 SQL 语句,方便修改和扩展。
- 支持自定义映射:可以自定义 SQL 映射,实现复杂的数据库操作。
- 支持多种数据库:可以轻松切换数据库类型。
MyBatis 快速入门
环境搭建
- Java 环境:确保您的计算机上已安装 Java 开发环境。
- Maven 环境:Maven 是一个项目管理工具,用于构建和管理 Java 项目。
- MyBatis 版本:选择合适的 MyBatis 版本,例如 3.5.6。
创建 Maven 项目
- 打开 Maven 安装目录下的
bin文件夹,执行mvn archetype:generate命令。 - 选择
maven-archetype-quickstart模板,并输入项目名称和 Group ID。 - 生成项目结构,并进入项目目录。
添加依赖
在 pom.xml 文件中添加以下依赖:
<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>5.1.47</version>
</dependency>
</dependencies>
配置 MyBatis
在 src/main/resources 目录下创建 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.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mydb"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
创建 Mapper 接口
在 com.example.mapper 包下创建 UserMapper.java 接口:
package com.example.mapper;
import com.example.entity.User;
public interface UserMapper {
User getUserById(int id);
}
创建 Mapper 映射文件
在 src/main/resources/com/example/mapper 目录下创建 UserMapper.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.mapper.UserMapper">
<select id="getUserById" resultType="com.example.entity.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
编写测试代码
在 com.example.mapper 包下创建 UserMapperTest.java 文件:
package com.example.mapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import com.example.entity.User;
public class UserMapperTest {
public static void main(String[] args) throws Exception {
// 创建 SqlSessionFactory
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(
Resources.getResourceAsStream("mybatis-config.xml"));
// 创建 SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
// 创建 UserMapper 接口
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 获取用户信息
User user = userMapper.getUserById(1);
System.out.println(user.getName());
// 关闭 SqlSession
sqlSession.close();
}
}
运行测试代码
执行 UserMapperTest.java 文件中的 main 方法,查看控制台输出结果。
总结
通过以上步骤,您已经成功入门 MyBatis,并掌握了基本的使用方法。接下来,您可以继续深入学习 MyBatis 的高级特性,如动态 SQL、类型处理器、插件等,以更好地发挥 MyBatis 的优势。
