引言
MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。本文将带领你轻松入门 MyBatis,从基础概念到实际应用,一步步掌握这个强大的 Java 开源框架。
MyBatis 基础概念
1. MyBatis 的核心组件
- SqlSessionFactory:MyBatis 的核心接口,负责创建 SqlSession。
- SqlSession:MyBatis 的会话接口,它包含执行 SQL 命令所需的所有方法。
- Executor:MyBatis 的执行器,负责执行查询、更新等操作。
- MappedStatement:MyBatis 的映射语句,包含了 SQL 语句和参数映射等。
- SqlSource:MyBatis 的 SQL 源,用于生成 MappedStatement。
2. MyBatis 的映射文件
MyBatis 使用 XML 文件来配置 SQL 语句和映射关系。一个典型的 MyBatis 映射文件包含以下元素:
:定义了 MyBatis 的命名空间和一系列的 SQL 映射语句。 - :分别用于定义查询、插入、更新、删除的 SQL 语句。
:定义了结果集的映射关系。
MyBatis 实践步骤
1. 添加依赖
在项目的 pom.xml 文件中添加 MyBatis 的依赖:
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
2. 配置 MyBatis
创建 mybatis-config.xml 文件,配置数据源、事务管理器等:
<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/myapp/mapper/UserMapper.xml"/>
</mappers>
</configuration>
3. 创建实体类和接口
创建实体类和接口,用于表示数据库表和操作:
public class User {
private Integer id;
private String name;
private String email;
// 省略getter和setter方法
}
public interface UserMapper {
User getUserById(Integer id);
}
4. 创建映射文件
创建 UserMapper.xml 文件,定义 SQL 语句和映射关系:
<mapper namespace="com.myapp.mapper.UserMapper">
<resultMap id="userResultMap" type="User">
<id property="id" column="id"/>
<result property="name" column="name"/>
<result property="email" column="email"/>
</resultMap>
<select id="getUserById" resultMap="userResultMap">
SELECT id, name, email FROM user WHERE id = #{id}
</select>
</mapper>
5. 使用 MyBatis
创建 SqlSessionFactory 和 SqlSession,执行查询:
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(new InputStream() {
@Override
public int read(byte[] b) throws IOException {
return new FileInputStream("mybatis-config.xml").read(b);
}
@Override
public int read(byte[] b, int off, int len) throws IOException {
return new FileInputStream("mybatis-config.xml").read(b, off, len);
}
@Override
public long skip(long n) throws IOException {
return new FileInputStream("mybatis-config.xml").skip(n);
}
@Override
public int available() throws IOException {
return new FileInputStream("mybatis-config.xml").available();
}
@Override
public void close() throws IOException {
new FileInputStream("mybatis-config.xml").close();
}
});
SqlSession sqlSession = sqlSessionFactory.openSession();
User user = sqlSession.selectOne("com.myapp.mapper.UserMapper.getUserById", 1);
System.out.println(user.getName());
sqlSession.close();
总结
通过本文的学习,相信你已经对 MyBatis 有了一定的了解。MyBatis 是一个简单易用、功能强大的 Java 开源框架,可以帮助开发者快速实现数据库持久层操作。在实际项目中,你可以根据需求灵活运用 MyBatis,提高开发效率。
