本文共 5617 字,大约阅读时间需要 18 分钟。
前两篇博文介绍的都是单表映射,而实际上很多时候我们需要用到较复杂的映射。今天学会的association的用法,就是一例,现写出来和大家分享(为简洁起见,ant工程中各文件、目录的布局,以及其它与前面的例子重复的内容,将不再赘述。以后博文亦将如此)。
假设每个学生都有一名指导老师,本示例的任务就是查询出学生的详细信息,这就包括学生的指导教师的信息。为此,应先增加一个教师的实体类。如下所示(和以前一样的原因,读者不要复制本文的配置文件。在文章下方的附件下载处,可下载本示例的完整代码):
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 | 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)如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | /*数据库编码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。注意,这里是“/”,而不是“\”。以下脚本的运行方式不再赘述)。
接着为学生增加指导教师属性,如下:
1 | private Teacher supervisor; //指导教师 |
并为此属性编写getter和setter方法,此处略去。
相应地,为学生表增加一个指导教师ID的字段,脚本(supervisor.sql)如下:
1 2 3 4 5 6 7 | /*切换到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中增加教师类型的别名定义,如下:
1 2 3 4 5 6 7 | < typeAliases > < typeAlias alias = "Student" type = "com.abc.domain.Student" /> <!--增加的教师类型别名--> < typeAlias alias = "Teacher" type = "com.abc.domain.Teacher" /> </ typeAliases > |
然后,我们需要修改StudentMapper.xml中的select语句及要用到的resultMap元素,这是本示例的关键部分。
首先,为了能够同时查询到学生的指导教师的信息,修改select语句如下:
1 2 3 4 5 6 7 8 9 10 11 12 | < 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行开始):
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | < 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,代码如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 | 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,指定这个类是要运行的类:
1 2 3 4 5 6 7 | < target name = "run" depends = "compile" > <!--指定AssociationDemo为要运行的类--> < java fork = "true" classname = "com.demo.AssociationDemo" classpathref = "library" > < classpath path = "${targetdir}" /> </ java > </ target > |
执行结果如下: