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

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

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

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

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

 
 
/*数据库编码UTF8，以下命令是为了在脚本和  
命令行中支持中文*/  
set names gbk;  
/*切换到courseman数据库*/  
use courseman;  
/*创建成绩表*/  
droptable if exists teacher;  
CREATETABLE teacher(  
   id intNOTNULL AUTO_INCREMENT primarykey,  
namevarchar(10) NOTNULL,/*姓名*/  
   gender char(1) NOTNULL,/*性别*/  
   research_area varchar(20) NOTNULL,/*研究方向*/  
   title varchar(6) NOTNULL/*职称*/    
);  
/*添加第一条记录，自动生成的ID为1*/  
insertinto 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列*/  
alterTABLE student add supervisor_id intnotnull
references teacher(id);  
/*把上面新增的教师作为目前学生的指导教师*/  
update student set supervisor_id=1; 

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

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

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

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

 
 
<selectid="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如下（从第12行开始）： 

 
 
<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;  
publicclass AssociationDemo  
{  
//获取SqlSessionFactory实例 
privatestatic SqlSessionFactory factory  
        = SqlSessionFactoryGen.getSqlSessionFactory();  
publicstaticvoid 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，指定这个类是要运行的类：

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

      执行结果如下：