MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 遵循约定优于配置( Convention Over Configuration)的原则,通过 XML 或注解的方式配置 SQL 语句,将 Java 对象和数据库表进行映射,从而实现数据的增删改查等操作。
MyBatis 的优势
- 简单易用:MyBatis 遵循简单的约定,减少了配置和代码量。
- 灵活强大:支持自定义 SQL、存储过程和高级映射。
- 支持多种数据库:支持 MySQL、Oracle、SQL Server、PostgreSQL 等多种数据库。
- 易于扩展:可以通过插件扩展 MyBatis 的功能。
环境搭建
- Java 环境:确保你的系统中已安装 Java 运行环境。
- Maven 环境:Maven 是一个项目管理工具,可以方便地管理项目依赖。
- IDE:推荐使用 IntelliJ IDEA 或 Eclipse 作为开发工具。
步骤一:创建 Maven 项目
- 打开 Maven,创建一个新的项目。
- 在项目中添加以下依赖:
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</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.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/test?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
步骤三:编写 Mapper 接口和 XML 映射文件
- 在项目中创建
com.example.mapper包。 - 在该包下创建
UserMapper.java接口,定义 SQL 语句。
package com.example.mapper;
import com.example.entity.User;
import org.apache.ibatis.annotations.Select;
public interface UserMapper {
@Select("SELECT * FROM user WHERE id = #{id}")
User getUserById(Integer id);
}
- 在项目中创建
src/main/resources/com/example/mapper/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">
<resultMap id="userResultMap" type="com.example.entity.User">
<id property="id" column="id"/>
<result property="name" column="name"/>
<result property="age" column="age"/>
</resultMap>
<select id="getUserById" resultMap="userResultMap">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
步骤四:使用 MyBatis
- 在项目中创建
com.example.service包,定义业务逻辑。 - 在该包下创建
UserService.java接口和UserServiceImpl.java实现类。
package com.example.service;
import com.example.entity.User;
public interface UserService {
User getUserById(Integer id);
}
package com.example.service.impl;
import com.example.entity.User;
import com.example.mapper.UserMapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
public class UserServiceImpl implements UserService {
private final SqlSessionFactory sqlSessionFactory;
public UserServiceImpl(SqlSessionFactory sqlSessionFactory) {
this.sqlSessionFactory = sqlSessionFactory;
}
@Override
public User getUserById(Integer id) {
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
return mapper.getUserById(id);
}
}
}
- 在项目中创建
com.example.Main类,启动应用程序。
package com.example;
import com.example.service.UserService;
import com.example.service.impl.UserServiceImpl;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class Main {
public static void main(String[] args) {
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build();
UserService userService = new UserServiceImpl(sqlSessionFactory);
User user = userService.getUserById(1);
System.out.println(user);
}
}
运行 Main 类,输出结果为:
User(id=1, name=root, age=18)
恭喜你,你已经成功入门 MyBatis!接下来,你可以根据需要学习 MyBatis 的更多高级功能,如动态 SQL、插件等。
