1. 数据库准备
假设目前存在以下数据库表。
CREATE TABLE `t_emp`(emp_id INT AUTO_INCREMENT,emp_name CHAR(100),emp_salary DOUBLE(10,5),PRIMARY KEY(emp_id)
);
2. 依赖导入
pom.xml
<dependencies><!-- mybatis依赖 --><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.11</version></dependency><!-- MySQL驱动 mybatis底层依赖jdbc驱动实现,本次不需要导入连接池,mybatis自带! --><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.25</version></dependency><!--junit5测试--><dependency><groupId>org.junit.jupiter</groupId><artifactId>junit-jupiter-api</artifactId><version>5.3.1</version></dependency>
</dependencies>
3. 实体类准备
public class Employee {private Integer empId;private String empName;private Double empSalary;//getter | setter
}
4. 准备Mapper接口和MapperXML文件
MyBatis 框架下，SQL语句编写位置发生改变，从原来的Java类，改成XML或者注解定义！
推荐在XML文件中编写SQL语句，让用户能更专注于 SQL 代码，不用关注其他的JDBC代码。
一般编写SQL语句的文件命名：XxxMapper.xml 。其中 Xxx一般取表名。
Mybatis 中的 Mapper 接口相当于以前的 Dao。但是区别在于，Mapper 仅仅只是建接口即可，我们不需要提供实现类，具体的SQL写到对应的Mapper文件，该用法的思路如下图所示：
4.1 准备Mapper接口
/*** t_emp表对应数据库SQL语句映射接口!* 接口只规定方法,参数和返回值!* mapper.xml中编写具体SQL语句!*/
public interface EmployeeMapper {/*** 根据员工id查询员工数据方法* @param empId 员工id* @return 员工实体对象*/Employee selectEmployee(Integer empId);}
4.2 准备mapper.xml
位置： resources/mappers/EmployeeMapper.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!-- namespace等于mapper接口类的全限定名,这样实现对应 -->
<mapper namespace="org.kkk.mapper.EmployeeMapper"><!-- 查询使用 select标签id = 方法名resultType = 返回值类型标签内编写SQL语句--><select id="selectEmployee" resultType="org.kkk.pojo.Employee"><!-- #{empId}代表动态传入的参数,并且进行赋值 -->select emp_id empId,emp_name empName, emp_salary empSalary from t_emp where emp_id = #{empId}</select>
</mapper>
注意：
- 接口定义的方法名和SQL的id一致
- 方法返回值和resultType一致
- 方法的参数和SQL的参数一致
- 接口的全类名和映射配置文件的名称空间一致
5. 准备MyBatis配置文件
mybatis框架配置文件： 数据库连接信息，性能配置，mapper.xml配置等。
习惯上命名为 mybatis-config.xml，这个文件名仅仅只是建议，并非强制要求。将来整合 Spring 之后，这个配置文件可以省略。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration><!-- environments表示配置Mybatis的开发环境，可以配置多个环境，在众多具体环境中，使用default属性指定实际运行时使用的环境。default属性的取值是environment标签的id属性的值。 --><environments default="development"><!-- environment表示配置Mybatis的一个具体的环境 --><environment id="development"><!-- Mybatis的内置的事务管理器 --><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"/><property name="username" value="root"/><property name="password" value="root"/></dataSource></environment></environments><mappers><!-- Mapper注册：指定Mybatis映射文件的具体位置 --><!-- mapper标签：配置一个具体的Mapper映射文件 --><!-- resource属性：指定Mapper映射文件的实际存储位置，这里需要使用一个以类路径根目录为基准的相对路径 --><!-- 对Maven工程的目录结构来说，resources目录下的内容会直接放入类路径，所以这里我们可以以resources目录为基准 --><mapper resource="mappers/EmployeeMapper.xml"/></mappers></configuration>
到此，MyBatis我们就操作完成了，接下来可以运行测试代码进行测试了。测试代码要使用MyBatis提供的API，过程较为复杂，在之后的spring boot会对其进行封装，便于我们开发者进一步的使用。因此，测试代码在这里就不展示了。
6.总结
- 在实际应用场景中，数据库及数据是现成的，不需要我们进行准备。
- 我们只需要准备实体类、Mapper接口、MapperXML文件以及MyBatis的配置文件。
- 实体类的作用是可以让MyBatis将查询结果自动映射为一个实体类对象，便于我们操作。
- 在mapper接口中，我们只需要定义操作方法，不需要编写实现类，MyBatis会自动完成实现类。
- MapperXML文件是我们书写sql语句的地方。
- 命名空间赋值为接口的全类名，方便MyBatis定位到该接口。
- sql的id要与接口中的方法名相同，MyBatis才可以知道该方法执行的是哪条sql语句。
