MyBatis关系映射之一对一

我们首先绘制一个简化的 E-R 图来表示三种关联关系。

上图表示的三种关系：

一对一：一个班主任只属于一个班级，一个班级也只能有一个班主任
一对多：一个班级有多个学生，一个学生只属于一个班级
多对多：一个学生可以选多门课，一门课可以有多个学生选
本节实验用 MyBatis 实现一对一关联映射：一个班主任只属于一个班级，一个班级也只能有一个班主任。

4.2 数据库准备

本次课程使用 MySQL 数据库。首先启动 mysql ：

$ sudo service mysql start

然后在终端下输入以下命令，进入到 MySQL 数据库（-u 表示用户名，比如这里的 root，-p 表示密码，这里没有密码就省略了）：

$ mysql -u root

为了实验方便，我们在这里新建一个数据库并取名 mybatis 用作实验。

创建班主任表 tb_head_teacher 并插入一条数据：

mysql> create table tb_head_teacher(
    -> ht_id int primary key auto_increment,
    -> ht_name varchar(20),
    -> ht_age int);

insert into tb_head_teacher(ht_name,ht_age) values('ZhangSan',40);

创建班级表 tb_class 并插入一条数据：

mysql> create table tb_class(
    -> c_id int primary key auto_increment,
    -> c_name varchar(20),
    -> c_ht_id int unique,
    -> foreign key(c_ht_id) references tb_head_teacher(ht_id));

insert into tb_class(c_name,c_ht_id) values('Class One',1);

检测数据插入情况：

4.3 新建项目

按照第二节中的方法新建动态 Web 工程，命名为 OneToOne。

4.4 导入所需 jar 包

所需 jar 包：

• MyBatis jar 包： mybatis-3.3.0.jar
• MySQL 驱动 jar 包： mysql-connector-java-5.1.35.jar
• 日志记录 jar 包： log4j-1.2.17.jar

将上述的三个 jar 包拷贝到项目的 /WebContent/WEB-INF/lib/ 目录下。

4.5 实体类

在Java Resources/src 的包 shiyanlou.mybatis.onetoone.model 下新建类 HeadTeacher.java，一个班主任具有 id、name、age 属性。

HeadTeacher.java 的代码如下：

package shiyanlou.mybatis.onetoone.model;

public class HeadTeacher {
    private Integer id;
    private String name;
    private Integer age;

    public HeadTeacher() {

    }

    public HeadTeacher(Integer id, String name, Integer age) {
        this.id = id;
        this.name = name;
        this.age = age;
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

}

再在包 shiyanlou.mybatis.onetoone.model 下新建类 Classes.java，一个班级有 id，name，teacher（HeadTeacher teacher）属性。teacher 属性用来映射一对一的关联关系，表示这个班级的班主任。

Classes.java 的代码如下：

package shiyanlou.mybatis.onetoone.model;

public class Classes {
    private Integer id;
    private String name;
    private HeadTeacher teacher;

    public Classes() {

    }

    public Classes(Integer id, String name, HeadTeacher teacher) {
        this.id = id;
        this.name = name;
        this.teacher = teacher;
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public HeadTeacher getTeacher() {
        return teacher;
    }

    public void setTeacher(HeadTeacher teacher) {
        this.teacher = teacher;
    }

}

4.6 创建方法接口和定义映射文件

新建包 shiyanlou.mybatis.onetoone.mapper ，并在包下新建方法接口 ClassesMapper.java。

ClassesMapper 接口的代码如下：

package shiyanlou.mybatis.onetoone.mapper;

import shiyanlou.mybatis.onetoone.model.Classes;

public interface ClassesMapper {

    /*
     * 根据 id 查询班级 Classes
     * @param id
     * @return
     * @throws Exception
     */
    public Classes selectClassById(Integer id) throws Exception;

}

在包 shiyanlou.mybatis.onetoone.mapper 下新建映射文件 ClassesMapper.xml ，映射文件与接口名相同。

ClassesMapper.xml 的配置如下：

<mapper namespace="shiyanlou.mybatis.onetoone.mapper.ClassesMapper">

    <select id="selectClassById" parameterType="int" resultMap="classmap">
        select * from tb_class c, tb_head_teacher t  where c.c_ht_id = t.ht_id and c.c_id=#{id}
    select>

    
    <resultMap id="classmap" type="Classes">
        <id property="id" column="c_id" />
        <result property="name" column="c_name" />
        
        <association property="teacher" javaType="HeadTeacher">
            <id property="id" column="ht_id" />
            <result property="name" column="ht_name" />
            <result property="age" column="ht_age" />
        association>
    resultMap>
mapper>

在这里，采用的是关联的嵌套结果映射的方式，使用了 元素映射一对一的关联关系。

如果想要 HeadTeacher 的结果映射可以重用，我们可以采用下面的方式，先定义 HeadTeacher 的 resultMap：

<resultMap id="teachermap" type="HeadTeacher">
    <id property="id" column="ht_id"/>
    <result property="name" column="ht_name" />
    <result property="age" column="ht_age" />
resultMap>

<resultMap id="classmap" type="Classes">
    <id property="id" column="c_id" />
    <result property="name" column="c_name" />
    
    <association property="teacher" column="c_ht_id" javaType="HeadTeacher" resultMap="teachermap" />
resultMap>

4.7 配置文件 mybatis.cfg.xml

在项目目录 /Java Resources/src 下新建 MyBatis 配置文件 mybatis.cfg.xml ，用来配置 Mybatis 的运行环境、数据源、事务等。

mybatis.cfg.xml 的配置如下，具体解释注释已经给出：

<configuration>   
    
    <typeAliases>
        
        <package name="shiyanlou.mybatis.onetoone.model" />
    typeAliases>  
       
    <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/mybatis" />
                <property name="username" value="root" />
                <property name="password" value="" />
            dataSource>
        environment>
    environments> 
    <mappers>
        
        <package name="shiyanlou/mybatis/onetoone/mapper" />
mappers>
configuration>

4.8 日志记录 log4j.properties

使用日志文件是为了查看控制台输出的 SQL 语句。

在项目目录 /Java Resources/src 下新建 MyBatis 日志记录文件

log4j.properties ，在里面添加如下内容：

 # Global logging configuration
log4j.rootLogger=DEBUG, stdout
 # Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

4.9 测试类 Test

在包 shiyanlou.mybatis.onetoone.test 下新建测试类 Test.java ，代码如下：

package shiyanlou.mybatis.onetoone.test;

import java.io.IOException;
import java.io.InputStream;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import shiyanlou.mybatis.onetoone.mapper.ClassesMapper;
import shiyanlou.mybatis.onetoone.model.Classes;

public class Test {
    private static SqlSessionFactory sqlSessionFactory;

    public static void main(String[] args) {
        // Mybatis 配置文件
        String resource = "mybatis.cfg.xml";

        // 得到配置文件流
        InputStream inputStream = null;
        try {
            inputStream = Resources.getResourceAsStream(resource);
        } catch (IOException e) {
            e.printStackTrace();
        }

        // 创建会话工厂，传入 MyBatis 的配置文件信息
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

        // 通过工厂得到 SqlSession
        SqlSession session = sqlSessionFactory.openSession();

        ClassesMapper mapper = session.getMapper(ClassesMapper.class);
        try {
            Classes classes = mapper.selectClassById(1);
            session.commit();
            System.out.println(classes.getId() + "," + classes.getName() + ",["
                    + classes.getTeacher().getId() + ","
                    + classes.getTeacher().getName() + ","
                    + classes.getTeacher().getAge()+"]");

        } catch (Exception e) {
            e.printStackTrace();
            session.rollback();
        }

        // 释放资源
        session.close();

    }
}

4.10 运行测试

运行测试类 Test.java，查询 id 为1的班级的所有信息及其班主任的信息。

输出信息与数据库中的数据一致