MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,简单的Java对象)映射成数据库中的记录。
入门准备
在开始学习 MyBatis 之前,你需要以下基础:
- Java 基础:熟悉 Java 基础知识,特别是面向对象编程。
- 数据库知识:了解 SQL 语言和数据库的基本操作。
- Maven 或 Gradle:用于依赖管理。
第一步:环境搭建
首先,我们需要创建一个 Java 项目,并使用 Maven 添加 MyBatis 和数据库连接的依赖。
<dependencies>
<!-- MyBatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<!-- MySQL 驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.22</version>
</dependency>
<!-- log4j 日志 -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
</dependencies>
第二步:编写 MyBatis 配置
在 src/main/resources 目录下创建 mybatis-config.xml 文件,配置 MyBatis 的运行环境。
<?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/your_database?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="your_password"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
第三步:编写 Mapper 文件
在 src/main/resources 目录下创建 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.example.mapper.UserMapper">
<select id="selectById" resultType="com.example.model.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
第四步:编写 Mapper 接口
在 com.example.mapper 包下创建 UserMapper.java 接口。
package com.example.mapper;
public interface UserMapper {
User selectById(Integer id);
}
第五步:运行测试
在 src/main/java 目录下创建 com.example/App.java 文件,编写测试代码。
package com.example;
import com.example.mapper.UserMapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class App {
public static void main(String[] args) {
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build();
SqlSession sqlSession = sqlSessionFactory.openSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.selectById(1);
System.out.println(user);
sqlSession.close();
}
}
实战案例
下面我们以一个简单的用户信息查询为例,展示 MyBatis 的实际应用。
1. 创建 User 类
在 com.example.model 包下创建 User.java 文件。
package com.example.model;
public class User {
private Integer id;
private String name;
private String email;
// getters and setters
}
2. 创建 Mapper 接口
在 com.example.mapper 包下创建 UserMapper.java 接口。
package com.example.mapper;
public interface UserMapper {
User selectById(Integer id);
}
3. 创建 Mapper XML
在 src/main/resources 目录下创建 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="selectById" resultType="com.example.model.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
4. 运行测试
在 com.example 包下创建 App.java 文件,编写测试代码。
package com.example;
import com.example.mapper.UserMapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class App {
public static void main(String[] args) {
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build();
SqlSession sqlSession = sqlSessionFactory.openSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.selectById(1);
System.out.println(user);
sqlSession.close();
}
}
运行测试代码,你将看到查询到的用户信息被打印出来。
总结
通过以上步骤,你就可以开始使用 MyBatis 进行数据库操作了。MyBatis 提供了强大的功能,可以帮助你更轻松地实现数据库操作。随着你深入学习和实践,你将发现 MyBatis 的更多优点。
