MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
环境搭建
1. 安装Java开发环境
在开始之前,确保你的计算机上安装了Java开发环境,包括JDK和Java环境变量配置。
2. 安装IDE
推荐使用IntelliJ IDEA或Eclipse等IDE来开发Java项目,它们提供了良好的代码编辑、调试和运行环境。
3. 创建Maven项目
Maven是一个项目管理和构建自动化工具,可以帮助你快速搭建项目结构,管理依赖。
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>mybatis-example</artifactId>
<version>1.0-SNAPSHOT</version>
<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.26</version>
</dependency>
<!-- 数据库连接池 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.2.6</version>
</dependency>
</dependencies>
</project>
4. 配置数据库
创建一个MySQL数据库,并创建一个表用于演示。
CREATE TABLE user (
id INT PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(50),
password VARCHAR(50)
);
MyBatis入门
1. 创建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/mybatis_example?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>
2. 创建Mapper接口
在项目的src/main/java/com/example/mapper目录下创建一个名为UserMapper.java的接口。
package com.example.mapper;
public interface UserMapper {
int insert(User user);
User selectById(int id);
}
3. 创建Mapper XML
在项目的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">
<insert id="insert" parameterType="User">
INSERT INTO user(username, password) VALUES (#{username}, #{password})
</insert>
<select id="selectById" resultType="User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
4. 测试MyBatis
在项目的src/main/java/com/example目录下创建一个名为MyBatisTest.java的文件,用于测试MyBatis。
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 MyBatisTest {
public static void main(String[] args) {
try {
// 创建SqlSessionFactory
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(MyBatisTest.class.getClassLoader().getResourceAsStream("mybatis-config.xml"));
// 获取SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
// 获取UserMapper
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 插入数据
User user = new User();
user.setUsername("admin");
user.setPassword("admin");
userMapper.insert(user);
sqlSession.commit();
// 查询数据
User userById = userMapper.selectById(1);
System.out.println(userById.getUsername() + " " + userById.getPassword());
sqlSession.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
总结
通过以上步骤,你已经成功入门MyBatis,并掌握了基本的操作。在实际项目中,你可以根据自己的需求进行扩展,例如添加分页、动态SQL等高级功能。希望这篇指南能帮助你快速上手MyBatis,祝你学习愉快!
