前两篇博文介绍的都是单表映射,而实际上很多时候我们需要用到较复杂的映射。今天学会的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>
执行结果如下: