MyBatis的association示例——MyBatis学习笔记之三

前两篇博文介绍的都是单表映射，而实际上很多时候我们需要用到较复杂的映射。今天学会的association的用法，就是一例，现写出来和大家分享（为简洁起见，ant工程中各文件、目录的布局，以及其它与前面的例子重复的内容，将不再赘述。以后博文亦将如此）。

假设每个学生都有一名指导老师，本示例的任务就是查询出学生的详细信息，这就包括学生的指导教师的信息。为此，应先增加一个教师的实体类。如下所示（和以前一样的原因，读者不要复制本文的配置文件。在文章下方的附件下载处，可下载本示例的完整代码）：

package com.abc.domain;
public class Teacher{
private int id;
private String name;  //姓名
private String gender;//性别
private String researchArea;//研究方向
private String title;//职称
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getGender() {
return gender;
}
public void setGender(String gender) {
this.gender = gender;
}
public String getResearchArea() {
return researchArea;
}
public void setResearchArea(String researchArea) {
this.researchArea = researchArea;
}
public String getTitle() {
return title;
}
public void setTitle(String title) {
this.title = title;
}
}

相应地，在数据库中，应增加教师表。完成此任务的脚本（teacher.sql）如下：

/*数据库编码UTF8，以下命令是为了在脚本和
命令行中支持中文*/
set names gbk;
/*切换到courseman数据库*/
use courseman;
/*创建成绩表*/
drop table if exists teacher;
CREATE TABLE teacher(
id int NOT NULL AUTO_INCREMENT primarykey,
name varchar(10) NOT NULL,/*姓名*/
gender char(1) NOT NULL,/*性别*/
research_area varchar(20) NOT NULL,/*研究方向*/
title varchar(6) NOT NULL/*职称*/
);
/*添加第一条记录，自动生成的ID为1*/
insert into teacher(name,gender,research_area, title)
values('张伟','男','软件工程','讲师');

在命令行下以courseman身份登录MySQL（mysql  –ucourseman  –pabc123），用source命令运行此脚本（若 teacher.sql放在D盘，即d:\ teacher.sql，则运行命令source d:/teacher.sql。注意，这里是“/”，而不 是“\”。以下脚本的运行方式不再赘述）。

接着为学生增加指导教师属性，如下：

private Teacher supervisor; //指导教师

并为此属性编写getter和setter方法，此处略去。

相应地，为学生表增加一个指导教师ID的字段，脚本（supervisor.sql）如下：

/*切换到courseman数据库*/
use courseman;
/*为学生表添加指导老师ID列*/
alter TABLE student add supervisor_id int not null
references teacher(id);
/*把上面新增的教师作为目前学生的指导教师*/
update student set supervisor_id=1;

在MyBatis的核心配置文件configuration.xml中增加教师类型的别名定义，如下：

<typeAliases>
<typeAlias alias="Student" type="com.abc.domain.Student"/>
<!--增加的教师类型别名-->
<typeAlias alias="Teacher" type="com.abc.domain.Teacher"/>
</typeAliases>

然后，我们需要修改StudentMapper.xml中的select语句及要用到的resultMap元素，这是本示例的关键部分。

首先，为了能够同时查询到学生的指导教师的信息，修改select语句如下：

<select id="getById" parameterType="int" resultMap="studentResultMap">
select st.id,st.name,st.gender,
st.major,st.grade,
<!--为教师的id取别名，避免MyBatis向教师实体注入
此属性时与学生id混淆。以下的name和gender等属性
也是如此-->
t.id t_id,t.name t_name,t.gender t_gender,
t.title,t.research_area
from student st, teacher t
where st.supervisor_id = t.id
and st.id=#{id}
</select>

为了实现查询结果与实体的映射，需要修改resultMap元素。此时的学生实体拥有一个指导教师属性（supervisor），而该属性本身就是一个实体。这是一种has-a关系，亦即一个学生有一个指导教师，而association元素就是处理这种关系的映射的。我们为resultMap添加 association如下（从第11行开始）：

<resultMap id="studentResultMap" type="Student">
<!--普通属性映射与以前一致-->
<id property="id" column="id"/>
<result property="name" column="name"/>
<result property="gender" column="gender"/>
<result property="major"  column="major"/>
<result property="grade"  column="grade"/>
<!--property="supervisor"表明这是为了映射学生实体的
supervisor属性。javaType="Teacher"用到了Teacher这个
别名定义，并指出了supervisor属性的java类型-->
<association property="supervisor" javaType="Teacher">
<!--教师自身的属性与数据库字段的映射。注意这里用到了字段别名-->
   <id property="id" column="t_id"/>
   <result property="name" column="t_name"/>
   <result property="gender" column="t_gender"/>
   <result property="researchArea" column="research_area"/>
   <result property="title" column="title"/>
</association>
</resultMap>

其中的javaType属性为必须，否则报以下错误：

这次的执行类是AssociationDemo，代码如下：

package com.demo;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSession;
import com.abc.mapper.StudentMapper;
import com.abc.domain.Student;
import com.util.SqlSessionFactoryGen;
public class AssociationDemo
{
//获取SqlSessionFactory实例
private static SqlSessionFactory factory
= SqlSessionFactoryGen.getSqlSessionFactory();
public static void main(String[] args)
{
SqlSession session = factory.openSession();
StudentMapper mapper =
session.getMapper(StudentMapper.class);
//笔者的数据库中只有ID为4的学生。读者若运行此程序，
//须使用你的数据库中存在的学生ID。否则报空指针异常
Student student = mapper.getById(4);
//使用StringBuilder的append操作代替字符串的“+”
//操作可提高执行效率
StringBuilder sb = new StringBuilder("学生信息：\n");
sb.append("姓名：");
sb.append(student.getName());
sb.append(" ");
sb.append( "专业：");
sb.append(student.getMajor());
sb.append(" 年级：");
sb.append(student.getGrade());
sb.append("\n");
sb.append("指导教师信息：\n");
sb.append("姓名：");
sb.append(student.getSupervisor().getName());
sb.append(" ");
sb.append("职称：");
sb.append(student.getSupervisor().getTitle());
sb.append(" ");
sb.append("研究方向：");
sb.append(student.getSupervisor().getResearchArea());
System.out.println(sb.toString());
session.close();
}
}

相应地，应修改ant的生成文件build.xml中的run target，指定这个类是要运行的类：

<target name="run" depends="compile">
<!--指定AssociationDemo为要运行的类-->
<java fork="true" classname="com.demo.AssociationDemo" classpathref="library">
  <classpath path="${targetdir}"/>
</java>
</target>

执行结果如下：