mybatis映射XML文件详解及实例

下面我将为您详细讲解“mybatis映射XML文件详解及实例”的攻略。

前言

在使用MyBatis进行数据库操作时，最重要的是将SQL语句与Java代码进行分离。而映射XML文件就是用于映射Java方法和SQL语句的文件。

映射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">
    <!-- ... -->
</mapper>

其中，mapper元素是根元素，其namespace属性值是Java接口的全限定名，表示这个映射文件与哪个Java接口关联。

具体来看，一个映射XML文件应该包含以下内容：

• parameterType：指定SQL语句的输入参数类型；
• resultType：指定SQL语句的输出结果类型；
• select：用于查询操作；
• insert：用于插入操作；
• update：用于更新操作；
• delete：用于删除操作。

下面我们通过几个示例来详细讲解。

示例一：查询操作

首先定义一个Java类，表示一个用户。

public class User {
    private Long id;
    private String name;
    private Integer age;
    // getters and setters
}

然后定义一个与该Java类关联的映射XML文件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="selectUserById" parameterType="long" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id=#{id}
    </select>
</mapper>

该文件使用select标签定义了一个名为selectUserById的查询操作，它使用一个输入参数long id表示用户的ID，返回一个com.example.entity.User对象。SQL语句中使用#{id}表示参数占位符，这个值会根据传入的参数动态替换。

Java代码中使用MyBatis的SqlSession对象进行操作：

public class UserDao {
    private SqlSessionFactory sqlSessionFactory;

    public UserDao(SqlSessionFactory sqlSessionFactory) {
        this.sqlSessionFactory = sqlSessionFactory;
    }

    public User selectUserById(Long id) {
        try (SqlSession session = sqlSessionFactory.openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);
            return mapper.selectUserById(id);
        }
    }
}

这个方法接收一个用户ID作为参数，并通过SqlSession对象获取映射接口UserMapper的实例，调用其中的方法selectUserById来执行查询操作。

示例二：插入操作

定义一个Java类表示一个订单。

public class Order {
    private Long id;
    private String orderNo;
    private Long userId;
    private Double price;
    // getters and setters
}

然后定义一个与该Java类关联的映射XML文件OrderMapper.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.OrderMapper">
    <insert id="insertOrder" parameterType="com.example.entity.Order">
        INSERT INTO `order` (order_no, user_id, price) VALUES (#{orderNo}, #{userId}, #{price})
    </insert>
</mapper>

该文件使用insert标签定义了一个名为insertOrder的插入操作，它接收一个com.example.entity.Order对象作为输入参数。SQL语句中使用#符号表示参数占位符，这个值会根据传入的参数动态替换。

Java代码中使用MyBatis的SqlSession对象进行操作：

public class OrderDao {
    private SqlSessionFactory sqlSessionFactory;

    public OrderDao(SqlSessionFactory sqlSessionFactory) {
        this.sqlSessionFactory = sqlSessionFactory;
    }

    public void insertOrder(Order order) {
        try (SqlSession session = sqlSessionFactory.openSession()) {
            OrderMapper mapper = session.getMapper(OrderMapper.class);
            mapper.insertOrder(order);
            session.commit();
        }
    }
}

这个方法接收一个Order对象作为参数，并通过SqlSession对象获取映射接口OrderMapper的实例，调用其中的方法insertOrder来执行插入操作。最后记得调用session.commit()提交事务。