接下来的文章中,关于Mybatis的示例,全部来自于Mybatis代码中的单元测试代码,通过这些代码能够学习Mybatis中很有用的知识,这些内容在doc文档中可能只是简单提到了,或者有一些文字说明,通过这些单元测试能更直观的了解如何在Mybatis使用这些内容。
这一节内容为Association关联的结果查询,就是在查询出结果后,根据查询的列和resultMap定义的对应关系,来创建对象并写入值。
- association – 一个复杂的类型关联;许多结果将包成这种类型
- 嵌入结果映射 – 结果映射自身的关联,或者参考一个
(注:“参考一个”,这里参考一个是通过对象的Key来唯一确定的,如果Key值一样,就直接用已经存在的这个对象。)
association是resultMap中的一个配置选项,下面是用到的类的UML图:
Car对象中包含了Engine和Brakes两个对象。Mapper是接口对象。AssociationTest是该测试对象。
SQL表结构和数据:
- drop table cars if exists;
- create table cars (
- carid integer,
- cartype varchar(20),
- enginetype varchar(20),
- enginecylinders integer,
- brakestype varchar(20)
- );
- insert into cars (carid, cartype, enginetype, enginecylinders, brakestype) values(1, 'VW', 'Diesel', 4, null);
- insert into cars (carid, cartype, enginetype, enginecylinders, brakestype) values(2, 'Opel', null, null, 'drum');
- insert into cars (carid, cartype, enginetype, enginecylinders, brakestype) values(3, 'Audi', 'Diesel', 4, 'disk');
- insert into cars (carid, cartype, enginetype, enginecylinders, brakestype) values(4, 'Ford', 'Gas', 8, 'drum');
Mapper.xml文件:
- <mapper namespace="org.apache.ibatis.submitted.associationtest.Mapper">
- <resultMap type="org.apache.ibatis.submitted.associationtest.Car" id="carResult">
- <id column="carid" property="id"/>
- <result column="cartype" property="type"/>
- <association property="engine" resultMap="engineResult"/>
- <association property="brakes" resultMap="brakesResult"/>
- </resultMap>
- <resultMap type="org.apache.ibatis.submitted.associationtest.Engine" id="engineResult">
- <result column="enginetype" property="type"/>
- <result column="enginecylinders" property="cylinders"/>
- </resultMap>
- <resultMap type="org.apache.ibatis.submitted.associationtest.Brakes" id="brakesResult">
- <result column="brakesType" property="type"/>
- </resultMap>
- <select id="getCars" resultMap="carResult">
- select * from cars
- </select>
- <select id="getCarsNonUnique" resultMap="carResult">
- select 1 as carid, cartype, enginetype, enginecylinders, brakestype from cars
- </select>
- <select id="getCars2" resultMap="carResult">
- select 1 as carid, cartype, enginetype, enginecylinders, brakestype from cars where carid in (1,2)
- </select>
- </mapper>
其中的一个测试用例:
- @Test
- public void shouldGetAllCars() {
- SqlSession sqlSession = sqlSessionFactory.openSession();
- try {
- Mapper mapper = sqlSession.getMapper(Mapper.class);
- List<Car> cars = mapper.getCars();
- Assert.assertEquals(4, cars.size());
- Assert.assertEquals("VW", cars.get(0).getType());
- Assert.assertNotNull(cars.get(0).getEngine());
- Assert.assertNull(cars.get(0).getBrakes());
- Assert.assertEquals("Opel", cars.get(1).getType());
- Assert.assertNull(cars.get(1).getEngine());
- Assert.assertNotNull(cars.get(1).getBrakes());
- } finally {
- sqlSession.close();
- }
- }
cars返回值:
association是嵌套查询中最简单的一种情况,像上述例子中,一般我们都会用一个Car对面包含所有的属性,这里的例子使用了嵌套对象,使对像的结构更鲜明。不过一般情况下很少会拆分一个对象为多个,用的多的时候是多表查询的嵌套。
上面XML中的
carResult和engieResult,brakesResult都是分别定义,carResult引用了另外两个resultMap。
对于不需要重用嵌套对象的情况,还可以直接这么写,把上面的XML修改后:
- <resultMap type="org.apache.ibatis.submitted.associationtest.Car" id="carResult">
- <id column="carid" property="id"/>
- <result column="cartype" property="type"/>
- <association property="engine" javaType="org.apache.ibatis.submitted.associationtest.Engine">
- <result column="enginetype" property="type"/>
- <result column="enginecylinders" property="cylinders"/>
- </association>
- <association property="brakes" resultMap="brakesResult"/>
- </resultMap>
如果有association方面问题可以参考(或在此留言):
http://mybatis.github.io/mybatis-3/zh/sqlmap-xml.html
本节源码请看官方git: