Mybatis入门教程：从零开始学习Mybatis

"这篇文档是关于Mybatis的学习笔记，涵盖了Mybatis的基本依赖配置以及如何创建第一个Mybatis程序的步骤。" 在Java开发中，Mybatis是一个广泛应用的持久层框架，它简化了数据库操作，提供了SQL映射功能，使得开发者可以直接编写SQL语句，将结果映射到Java对象上。下面我们将详细探讨Mybatis的核心概念和基本使用。 ### Mybatis入门 #### 1. Mybatis依赖 Mybatis的Maven依赖如下所示： ```xml <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.6</version> </dependency> ``` 这个依赖包含了Mybatis的主要库，允许你在项目中使用Mybatis的各种功能。 #### 2. Maven配置 在Maven的`pom.xml`文件中，为了确保项目的编码统一和避免资源处理错误，可以添加以下配置： ```xml <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <maven.compiler.source>1.8</maven.compiler.source> <maven.compiler.target>1.8</maven.compiler.target> </properties> <build> <resources> <resource> <directory>src/main/resources</directory> <includes> <include>/*.properties</include> <include>/*.xml</include> </includes> <filtering>true</filtering> </resource> <resource> <directory>src/main/java</directory> <includes> <include>/*.properties</include> <include>/*.xml</include> </includes> <filtering>true</filtering> </resource> </resources> </build> ``` 这段配置定义了项目编码为UTF-8，并指定了Java编译版本为1.8。同时，它还配置了资源目录，包括`src/main/resources`下的`.properties`和`.xml`文件，确保它们在构建过程中被正确处理。 ### 3. 创建第一个Mybatis程序 #### 2.1. 搭建环境 在创建第一个Mybatis程序之前，你需要先搭建一个数据库环境。这通常包括创建数据库、表以及插入一些初始数据。例如，你可以创建一个名为`users`的表，包含`id`、`username`和`password`等字段。 #### 2.2. 配置Mybatis Mybatis的核心配置文件是`mybatis-config.xml`，其中定义了数据源、事务管理器等信息。这是一个基础的配置示例： ```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/your_database?useSSL=false&amp;serverTimezone=UTC"/> <property name="username" value="your_username"/> <property name="password" value="your_password"/> </dataSource> </environment> </environments> <mappers> <mapper resource="com/example/mapper/UserMapper.xml"/> </mappers> </configuration> ``` 这里，你需要替换`your_database`、`your_username`和`your_password`为你的实际数据库信息。 #### 2.3. 编写Mapper接口和XML配置 Mapper接口是Java代码中定义SQL操作的地方，而XML配置文件则存放具体的SQL语句。例如，创建一个`UserMapper`接口： ```java public interface UserMapper { User getUserById(int id); } ``` 然后，在`src/main/resources/com/example/mapper`目录下创建对应的`UserMapper.xml`文件： ```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.model.User"> SELECT * FROM users WHERE id = #{id} </select> </mapper> ``` 这里的`namespace`属性应与Mapper接口的全限定名一致，`id`属性对应于接口方法名。 #### 2.4. 使用SqlSessionFactory 在Java代码中，通过`SqlSessionFactory`和`SqlSession`来与数据库进行交互。首先，创建一个`SqlSessionFactory`实例： ```java String resource = "mybatis-config.xml"; InputStream inputStream = Resources.getResourceAsStream(resource); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); ``` 然后，每次需要执行数据库操作时，获取一个`SqlSession`： ```java try (SqlSession session = sqlSessionFactory.openSession()) { UserMapper mapper = session.getMapper(UserMapper.class); User user = mapper.getUserById(1); System.out.println(user); } ``` 这样，你就成功地通过Mybatis执行了一个SQL查询并获取了结果。 Mybatis的学习和使用是一个不断深入的过程，它支持动态SQL、级联操作、缓存等高级特性，能帮助你更好地管理数据库操作。通过不断地实践和探索，你将能够更熟练地运用Mybatis解决实际问题。