`

MyBatis学习 之 二、SQL语句映射文件(1)resultMap

 
阅读更多
MyBatis学习 之 二、SQL语句映射文件(1)resultMap
标签: sqlstringclassjavajdbcjoin
2012-08-05 13:10 2830人阅读 评论(0) 收藏 举报
分类:  Spring(16)   MyBatis(9) 
版权声明:本文为博主原创文章,未经博主允许不得转载。https://github.com/luqin
目录(?)[+]
二、SQL语句映射文件(1)resultMap


MyBatis学习 之 一、MyBatis简介与配置MyBatis+Spring+MySql
MyBatis学习 之 二、SQL语句映射文件(1)resultMap
MyBatis学习 之 二、SQL语句映射文件(2)增删改查、参数、缓存
MyBatis学习 之 三、动态SQL语句
MyBatis学习 之 四、MyBatis配置文件

SQL 映射XML 文件是所有sql语句放置的地方。需要定义一个workspace,一般定义为对应的接口类的路径。写好SQL语句映射文件后,需要在MyBAtis配置文件mappers标签中引用,例如:

[xml] view plain copy
<mappers> 
    <mapper resource="com/liming/manager/data/mappers/UserMapper.xml" /> 
    <mapper resource="com/liming/manager/data/mappers/StudentMapper.xml" /> 
    <mapper resource="com/liming/manager/data/mappers/ClassMapper.xml" /> 
    <mapper resource="com/liming/manager/data/mappers/TeacherMapper.xml" /> 
</mappers> 


当Java接口与XML文件在一个相对路径下时,可以不在myBatis配置文件的mappers中声明。


SQL 映射XML 文件一些初级的元素:

1. cache – 配置给定模式的缓存
2. cache-ref – 从别的模式中引用一个缓存
3. resultMap – 这是最复杂而却强大的一个元素了,它描述如何从结果集中加载对象
4. sql – 一个可以被其他语句复用的SQL 块
5. insert – 映射INSERT 语句
6. update – 映射UPDATE 语句
7. delete – 映射DELEETE 语句
8. select  -  映射SELECT语句


2.1 resultMap
        resultMap 是MyBatis 中最重要最强大的元素了。你可以让你比使用JDBC 调用结果集省掉90%的代码,也可以让你做许多JDBC 不支持的事。现实上,要写一个等同类似于交互的映射这样的复杂语句,可能要上千行的代码。ResultMaps 的目的,就是这样简单的语句而不需要多余的结果映射,更多复杂的语句,除了只要一些绝对必须的语句描述关系以外,再也不需要其它的。
resultMap属性:type为java实体类;id为此resultMap的标识。

resultMap可以设置的映射:

1. constructor – 用来将结果反射给一个实例化好的类的构造器
a) idArg – ID 参数;将结果集标记为ID,以方便全局调用
b) arg –反射到构造器的通常结果

2. id – ID 结果,将结果集标记为ID,以方便全局调用

3. result – 反射到JavaBean 属性的普通结果

4. association – 复杂类型的结合;多个结果合成的类型
a) nested result mappings – 几resultMap 自身嵌套关联,也可以引用到一个其它上

5. collection –复杂类型集合a collection of complex types

6. nested result mappings – resultMap 的集合,也可以引用到一个其它上

7. discriminator – 使用一个结果值以决定使用哪个resultMap
a) case – 基本一些值的结果映射的case 情形
i. nested result mappings –一个case 情形本身就是一个结果映射,因此也可以包括一些相同的元素,也可以引用一个外部resultMap。


2.1.1 id、result
id、result是最简单的映射,id为主键映射;result其他基本数据库表字段到实体类属性的映射。
  最简单的例子:

[xml] view plain copy
<resultMap type="liming.student.manager.data.model.StudentEntity" id="studentResultMap"> 
    <id  property="studentId"        column="STUDENT_ID" javaType="String" jdbcType="VARCHAR"/> 
    <result property="studentName"       column="STUDENT_NAME" javaType="String" jdbcType="VARCHAR"/> 
    <result property="studentSex"        column="STUDENT_SEX"  javaType="int" jdbcType="INTEGER"/> 
    <result property="studentBirthday"   column="STUDENT_BIRTHDAY"  javaType="Date" jdbcType="DATE"/> 
    <result property="studentPhoto"  column="STUDENT_PHOTO" javaType="byte[]" jdbcType="BLOB" typeHandler="org.apache.ibatis.type.BlobTypeHandler" /> 
</resultMap> 



id、result语句属性配置细节:

属性
描述

property
需要映射到JavaBean的属性名称。

column
数据表的列名或者标签别名。

javaType
一个完整的类名,或者是一个类型别名。如果你匹配的是一个JavaBean,那MyBatis通常会自行检测到。然后,如果你是要映射到一个HashMap,那你需要指定javaType要达到的目的。

jdbcType
数据表支持的类型列表。这个属性只在insert,update或delete 的时候针对允许空的列有用。JDBC需要这项,但MyBatis 不需要。如果你是直接针对JDBC编码,且有允许空的列,而你要指定这项。

typeHandler
使用这个属性可以覆写类型处理器。这项值可以是一个完整的类名,也可以是一个类型别名。



支持的JDBC类型
       为了将来的引用,MyBatis 支持下列JDBC 类型,通过JdbcType 枚举:
BIT,FLOAT,CHAR,TIMESTAMP,OTHER,UNDEFINED,TINYINT,REAL,VARCHAR,BINARY,BLOB,NVARCHAR,SMALLINT,DOUBLE,LONGVARCHAR,VARBINARY,CLOB,NCHAR,INTEGER,NUMERIC,DATE,LONGVARBINARY,BOOLEAN,NCLOB,BIGINT,DECIMAL,TIME,NULL,CURSOR


2.1.2 constructor

        我们使用id、result时候,需要定义java实体类的属性映射到数据库表的字段上。这个时候是使用JavaBean实现的。当然我们也可以使用实体类的构造方法来实现值的映射,这个时候是通过构造方法参数的书写的顺序来进行赋值的。
        使用construcotr功能有限(例如使用collection级联查询)。
        上面使用id、result实现的功能就可以改为:
[xml] view plain copy
<resultMap type="StudentEntity" id="studentResultMap" > 
    <constructor> 
        <idArg javaType="String" column="STUDENT_ID"/> 
        <arg javaType="String" column="STUDENT_NAME"/> 
        <arg javaType="String" column="STUDENT_SEX"/> 
        <arg javaType="Date" column="STUDENT_BIRTHDAY"/> 
    </constructor> 
</resultMap> 

        当然,我们需要定义StudentEntity实体类的构造方法:
[java] view plain copy
public StudentEntity(String studentID, String studentName, String studentSex, Date studentBirthday){ 
    this.studentID = studentID; 
    this.studentName = studentName; 
    this.studentSex = studentSex; 
    this.studentBirthday = studentBirthday; 





2.1.3 association联合
联合元素用来处理“一对一”的关系。需要指定映射的Java实体类的属性,属性的javaType(通常MyBatis 自己会识别)。对应的数据库表的列名称。如果想覆写的话返回结果的值,需要指定typeHandler。
不同情况需要告诉MyBatis 如何加载一个联合。MyBatis 可以用两种方式加载:
1. select: 执行一个其它映射的SQL 语句返回一个Java实体类型。较灵活;
2. resultsMap: 使用一个嵌套的结果映射来处理通过join查询结果集,映射成Java实体类型。

例如,一个班级对应一个班主任。
首先定义好班级中的班主任属性:
[java] view plain copy
private TeacherEntity teacherEntity; 


2.1.3.1使用select实现联合
例:班级实体类中有班主任的属性,通过联合在得到一个班级实体时,同时映射出班主任实体。
这样可以直接复用在TeacherMapper.xml文件中定义好的查询teacher根据其ID的select语句。而且不需要修改写好的SQL语句,只需要直接修改resultMap即可。

ClassMapper.xml文件部分内容:
[xml] view plain copy
<resultMap type="ClassEntity" id="classResultMap"> 
    <id property="classID" column="CLASS_ID" /> 
    <result property="className" column="CLASS_NAME" /> 
    <result property="classYear" column="CLASS_YEAR" /> 
    <association property="teacherEntity" column="TEACHER_ID" select="getTeacher"/> 
</resultMap> 
 
<select id="getClassByID" parameterType="String" resultMap="classResultMap"> 
    SELECT * FROM CLASS_TBL CT 
    WHERE CT.CLASS_ID = #{classID}; 
</select> 


TeacherMapper.xml文件部分内容:
[xml] view plain copy
<resultMap type="TeacherEntity" id="teacherResultMap"> 
    <id property="teacherID" column="TEACHER_ID" /> 
    <result property="teacherName" column="TEACHER_NAME" /> 
    <result property="teacherSex" column="TEACHER_SEX" /> 
    <result property="teacherBirthday" column="TEACHER_BIRTHDAY"/> 
    <result property="workDate" column="WORK_DATE"/> 
    <result property="professional" column="PROFESSIONAL"/> 
</resultMap> 
 
<select id="getTeacher" parameterType="String"  resultMap="teacherResultMap"> 
    SELECT * 
      FROM TEACHER_TBL TT 
     WHERE TT.TEACHER_ID = #{teacherID} 
</select> 



2.1.3.2使用resultMap实现联合
与上面同样的功能,查询班级,同时查询器班主任。需在association中添加resultMap(在teacher的xml文件中定义好的),新写sql(查询班级表left join教师表),不需要teacher的select。

修改ClassMapper.xml文件部分内容:
[xml] view plain copy
<resultMap type="ClassEntity" id="classResultMap"> 
    <id property="classID" column="CLASS_ID" /> 
    <result property="className" column="CLASS_NAME" /> 
    <result property="classYear" column="CLASS_YEAR" /> 
    <association property="teacherEntity" column="TEACHER_ID"  resultMap="teacherResultMap"/> 
</resultMap> 
 
<select id="getClassAndTeacher" parameterType="String" resultMap="classResultMap"> 
    SELECT * 
      FROM CLASS_TBL CT LEFT JOIN TEACHER_TBL TT ON CT.TEACHER_ID = TT.TEACHER_ID 
     WHERE CT.CLASS_ID = #{classID}; 
</select> 


其中的teacherResultMap请见上面TeacherMapper.xml文件部分内容中。


2.1.4 collection聚集
聚集元素用来处理“一对多”的关系。需要指定映射的Java实体类的属性,属性的javaType(一般为ArrayList);列表中对象的类型ofType(Java实体类);对应的数据库表的列名称;
不同情况需要告诉MyBatis 如何加载一个聚集。MyBatis 可以用两种方式加载:
1. select: 执行一个其它映射的SQL 语句返回一个Java实体类型。较灵活;
2. resultsMap: 使用一个嵌套的结果映射来处理通过join查询结果集,映射成Java实体类型。

例如,一个班级有多个学生。
首先定义班级中的学生列表属性:
[java] view plain copy
private List<StudentEntity> studentList; 


2.1.4.1使用select实现聚集
用法和联合很类似,区别在于,这是一对多,所以一般映射过来的都是列表。所以这里需要定义javaType为ArrayList,还需要定义列表中对象的类型ofType,以及必须设置的select的语句名称(需要注意的是,这里的查询student的select语句条件必须是外键classID)。

ClassMapper.xml文件部分内容:
[xml] view plain copy
<resultMap type="ClassEntity" id="classResultMap"> 
    <id property="classID" column="CLASS_ID" /> 
    <result property="className" column="CLASS_NAME" /> 
    <result property="classYear" column="CLASS_YEAR" /> 
    <association property="teacherEntity" column="TEACHER_ID"  select="getTeacher"/> 
    <collection property="studentList" column="CLASS_ID" javaType="ArrayList" ofType="StudentEntity" select="getStudentByClassID"/> 
</resultMap> 
 
<select id="getClassByID" parameterType="String" resultMap="classResultMap"> 
    SELECT * FROM CLASS_TBL CT 
    WHERE CT.CLASS_ID = #{classID}; 
</select> 



StudentMapper.xml文件部分内容:
[xml] view plain copy
<!-- java属性,数据库表字段之间的映射定义 --> 
<resultMap type="StudentEntity" id="studentResultMap"> 
    <id property="studentID" column="STUDENT_ID" /> 
    <result property="studentName" column="STUDENT_NAME" /> 
    <result property="studentSex" column="STUDENT_SEX" /> 
    <result property="studentBirthday" column="STUDENT_BIRTHDAY" /> 
</resultMap> 
 
<!-- 查询学生list,根据班级id --> 
<select id="getStudentByClassID" parameterType="String" resultMap="studentResultMap"> 
    <include refid="selectStudentAll" /> 
    WHERE ST.CLASS_ID = #{classID} 
</select> 




2.1.4.2使用resultMap实现聚集
使用resultMap,就需要重写一个sql,left join学生表。
[xml] view plain copy
<resultMap type="ClassEntity" id="classResultMap"> 
    <id property="classID" column="CLASS_ID" /> 
    <result property="className" column="CLASS_NAME" /> 
    <result property="classYear" column="CLASS_YEAR" /> 
    <association property="teacherEntity" column="TEACHER_ID"  resultMap="teacherResultMap"/> 
    <collection property="studentList" column="CLASS_ID" javaType="ArrayList" ofType="StudentEntity" resultMap="studentResultMap"/> 
</resultMap> 
 
<select id="getClassAndTeacherStudent" parameterType="String" resultMap="classResultMap"> 
    SELECT * 
      FROM CLASS_TBL CT 
           LEFT JOIN STUDENT_TBL ST 
              ON CT.CLASS_ID = ST.CLASS_ID 
           LEFT JOIN TEACHER_TBL TT 
              ON CT.TEACHER_ID = TT.TEACHER_ID 
      WHERE CT.CLASS_ID = #{classID}; 
</select> 

其中的teacherResultMap请见上面TeacherMapper.xml文件部分内容中。studentResultMap请见上面StudentMapper.xml文件部分内容中。

2.1.5discriminator鉴别器

有时一个单独的数据库查询也许返回很多不同(但是希望有些关联)数据类型的结果集。鉴别器元素就是被设计来处理这个情况的,还有包括类的继承层次结构。鉴别器非常容易理解,因为它的表现很像Java语言中的switch语句。
定义鉴别器指定了column和javaType属性。列是MyBatis查找比较值的地方。JavaType是需要被用来保证等价测试的合适类型(尽管字符串在很多情形下都会有用)。
下面这个例子为,当classId为20000001时,才映射classId属性。



[xml] view plain copy
<resultMap type="liming.student.manager.data.model.StudentEntity" id="resultMap_studentEntity_discriminator"> 
    <id  property="studentId"        column="STUDENT_ID" javaType="String" jdbcType="VARCHAR"/> 
    <result property="studentName"       column="STUDENT_NAME" javaType="String" jdbcType="VARCHAR"/> 
    <result property="studentSex"        column="STUDENT_SEX"  javaType="int" jdbcType="INTEGER"/> 
    <result property="studentBirthday"   column="STUDENT_BIRTHDAY"  javaType="Date" jdbcType="DATE"/> 
    <result property="studentPhoto"  column="STUDENT_PHOTO" javaType="byte[]" jdbcType="BLOB" typeHandler="org.apache.ibatis.type.BlobTypeHandler" /> 
    <result property="placeId"           column="PLACE_ID" javaType="String" jdbcType="VARCHAR"/> 
    <discriminator column="CLASS_ID" javaType="String" jdbcType="VARCHAR"> 
        <case value="20000001" resultType="liming.student.manager.data.model.StudentEntity" > 
            <result property="classId" column="CLASS_ID" javaType="String" jdbcType="VARCHAR"/> 
        </case> 
    </discriminator> 
</resultMap> 


MyBatis学习 之 一、MyBatis简介与配置MyBatis+Spring+MySql
MyBatis学习 之 二、SQL语句映射文件(1)resultMap
MyBatis学习 之 二、SQL语句映射文件(2)增删改查、参数、缓存
MyBatis学习 之 三、动态SQL语句
MyBatis学习 之 四、MyBatis配置文件
分享到:
评论

相关推荐

    SQL语句映射文件

    ### SQL语句映射文件详解 #### 一、概述 SQL映射文件是MyBatis框架的核心组件之一,主要用于存放数据库操作的SQL语句。它不仅简化了开发过程中的SQL编写工作,还提供了灵活的数据访问层实现方式。通过将SQL语句与...

    Mybatis-03 SQL映射文件

    在MyBatis中,SQL映射文件起着至关重要的作用,它是连接数据库和Java代码的桥梁,允许开发者灵活地控制SQL语句的编写。本文将深入探讨MyBatis框架中的SQL映射文件配置,主要包括以下几个方面: 1. **基本结构** ...

    Mybatis 实体类+Mapper实体映射文件+接口+Config主配置文件+测试类

    2. **Mapper实体映射文件(Mapper XML)**:这是Mybatis的核心组件之一,用于定义SQL语句和结果映射。在映射文件中,你可以编写各种类型的SQL,如SELECT、INSERT、UPDATE和DELETE,并通过XML标签与Java接口的方法...

    详解Java的MyBatis框架中SQL语句映射部分的编写

    在Java的MyBatis框架中,SQL语句映射部分是整个ORM(对象关系映射)过程中的核心组件,它负责将SQL查询结果转化为Java对象。这篇教程将深入讲解SQL映射XML文件的编写,主要关注`resultMap`以及增删查改(CRUD)的...

    Mybatis核心组成部分之SQL映射文件揭秘详解

    Mybatis核心组成部分之SQL映射文件揭秘详解 Mybatis是一个基于Java的持久层框架,它的核心组成部分之一是SQL映射文件。SQL映射文件是Mybatis的真正力量所在,通过它可以实现数据库操作的自动化。下面我们将详细介绍...

    mybatis-demo4-resultMap手动映射.zip

    在MyBatis中,ResultMap是核心配置之一,它用于定义如何将数据库查询结果映射到Java对象。ResultMap的概念是为了提高数据映射的灵活性和效率,避免了简单类型的数据映射过程中的冗余代码。在`mybatis-demo4-...

    mybatis学习总结:对象关系映射的xml配置实现

    首先,MyBatis的核心是SQL映射文件,它以XML格式存储,包含了SQL语句、参数映射以及结果集映射等关键信息。XML配置文件通常位于项目的`resources`目录下,以`.xml`为扩展名,如`Mapper.xml`。在这个文件中,你可以...

    MyBatis+MySQL本地自动生成映射类和XML文件

    2. **XML映射文件**:MyBatis的XML映射文件是SQL查询的载体,它包含了SQL语句、参数类型、结果映射等信息。每个Mapper接口通常会有一个对应的XML文件,文件中定义了接口方法的具体实现,即SQL语句。 3. **自动生成...

    mybatis映射文件生成工具

    映射文件是MyBatis中的关键组成部分,它定义了SQL语句、参数映射以及结果映射。映射文件通常以XML格式存在,其主要内容包括: 1. **namespace**:命名空间,通常对应一个Mapper接口,用于区分不同的SQL语句集。 2. ...

    详解MyBatis直接执行SQL查询及数据批量插入

    MyBatis是一个强大的持久层框架,它允许开发者直接编写SQL语句,简化了数据库操作。在本文中,我们将深入探讨如何使用MyBatis直接执行SQL查询以及如何进行数据的批量插入。 **一、直接执行SQL查询** 在MyBatis中,...

    Mybatis主配置文件、附配置文件、实体类、sql生成工具

    4. **Mappers**:配置Mybatis的映射文件路径,每个Mapper对应一个SQL映射文件,用于定义SQL语句和结果映射。 **二、附配置文件(Mapper XML文件)** Mapper XML文件是Mybatis的SQL映射文件,它包含了SQL语句和结果...

    mybatis学习笔记

    MyBatis 的精髓在于 SQL 映射文件(例如:iBatis学习笔记中的映射文件),其中定义了 SQL 语句、参数和结果集映射。这些映射可以包含动态 SQL,使得 SQL 语句更加灵活,可以根据传入的参数动态生成不同的 SQL。 4....

    MyBatis_sql-resultMap-缓存

    MyBatis是一个流行的Java持久层框架,它简化了数据库操作,通过XML或注解的方式将SQL语句与Java代码解耦。在MyBatis中,`resultMap`是核心配置元素之一,它定义了如何从数据库查询结果中映射数据到Java对象。而缓存...

    mybatis3--4.resultMap高级映射

    1. `id`:ResultMap的唯一标识,用于在SQL语句中引用。 2. `type`:指定映射的目标Java类。 3. `result`元素: - `column`:数据库中的列名。 - `property`:Java对象的属性名。 - `javaType`:可选,指定属性的...

    MyBatis SQL映射器框架的Java.zip

    首先,MyBatis的核心是SQL映射文件,这些文件是XML格式的,定义了SQL语句及其相关的参数映射和结果映射。在`mybatis-3_master.zip`中可能包含了MyBatis的源码,这有助于理解其内部工作原理。通过XML配置,我们可以...

    mybatis学习

    在 MyBatis 中,SQL 映射文件是核心组成部分,它定义了数据库操作的 SQL 语句,并通过 XML 或注解的方式与 Java 代码中的接口方法进行绑定。让我们深入了解一下 MyBatis 的主要概念和功能: 1. **配置文件**:...

    MyBatis学习-映射文件标签篇(select、resultMap).rar_alikeett_blueaod_mybatis

    `select`标签是MyBatis用于执行SQL查询的标签,它允许我们将SQL语句嵌入到XML配置文件中。`select`标签的基本结构如下: ```xml SELECT * FROM your_table WHERE id = #{id} ``` 在这里,`id`是方法参数的类型,...

    Mybatis高级映射查询

    2. 映射文件与 XML 映射元素:Mybatis 的映射文件通常以 `.xml` 结尾,如 `mybatis3.xml`,它包含了 SQL 语句和结果集映射。在映射文件中,`&lt;select&gt;`, `&lt;insert&gt;`, `&lt;update&gt;`, `&lt;delete&gt;` 元素分别对应 SQL 的查询...

Global site tag (gtag.js) - Google Analytics