Explication détaillée des attributs mybatis

Avant-propos

MyBatis est basé sur l'idée de "la structure de la base de données est incontrôlable", c'est-à-dire que nous espérons que la base de données suivra la troisième forme normale ou BCNF, mais en fait, cela se retourne contre vous, donc le mappage de l'ensemble de résultats. C'est MyBatis qui nous fournit ce moyen de conversion entre l'idéal et la réalité, et resultMap est l'étiquette de configuration du mappage de l'ensemble de résultats.
Avant d'approfondir la balise ResultMap, nous devons comprendre le processus allant de l'ensemble de résultats de requête SQL à l'entité JavaBean ou POJO.

Des résultats de requête SQL aux entités de modèle de domaine　

1. Obtenez l'objet ResultSet via une requête JDBC

2. Parcourez l'objet ResultSet et stockez temporairement chaque ligne de données dans une instance HashMap, en utilisant le nom du champ ou l'alias du champ de l'ensemble de résultats comme clé et la valeur du champ comme valeur

3. selon l'attribut type de la balise ResultMap Instancier le modèle de domaine par réflexion

4. Remplissez les paires clé-valeur du HashMap dans l'instance du modèle de domaine selon l'attribut type du ResultMap tag et informations de balise telles que l'identifiant et le résultat et le retour

1 resultMap

1. >attribut id, l'identification de la balise resultMap.

• attribut de type, le nom de classe complet de la valeur de retour ou un alias de type.

• Attribut autoMapping, plage de valeurs true (valeur par défaut) | false, définissez s'il faut démarrer la fonction de mappage automatique. La fonction de mappage automatique consiste à trouver automatiquement le nom de l'attribut portant le même nom que. le nom du champ en minuscules et appelez la méthode setter. Après l'avoir défini sur false, la relation de mappage doit être clairement indiquée dans

  avant que la méthode de définition correspondante ne soit appelée.

• resultMap

  2. Fonction de base : Établir une relation de mappage entre les champs de résultat de la requête SQL et les attributs d'entité

Exemple 1 : Construire un modèle de domaine via des setters

Description du sous-élément :

public class EStudent{  private long id;  private String name;  private int age;  // getter,setter方法  /**
   * 必须提供一个无参数的构造函数
   */  public EStudent(){}
}

<select id="getStudent" resultMap="getStudentRM">
  SELECT ID, Name, Age
    FROM TStudent
</select>
<resultMap id="getStudentRM" type="EStudnet">
  <id property="id" column="ID"/>
  <result property="studentName" column="Name"/>
  <result property="studentAge" column="Age"/>
</resultMap>

élément id, utilisé pour définir la relation de mappage entre les champs de clé primaire et les attributs du modèle de domaine

• L'élément result est utilisé pour définir la relation de mappage entre les champs ordinaires et les attributs du modèle de domaine

• id et détails de configuration de l'attribut de l'instruction de résultat :

  属性	描述
  property	需要映射到JavaBean 的属性名称。
  column	数据表的列名或者标签别名。
  javaType	一个完整的类名，或者是一个类型别名。如果你匹配的是一个JavaBean，那MyBatis 通常会自行检测到。然后，如果你是要映射到一个HashMap，那你需要指定javaType 要达到的目的。
  jdbcType	数据表支持的类型列表。这个属性只在insert,update 或delete 的时候针对允许空的列有用。JDBC 需要这项，但MyBatis 不需要。如果你是直接针对JDBC 编码，且有允许空的列，而你要指定这项。
  typeHandler	使用这个属性可以覆写类型处理器。这项值可以是一个完整的类名，也可以是一个类型别名。

  示例2：通过构造函数构造领域模型

  <select id="getStudent" resultMap="getStudentRM">
    SELECT ID, Name, Age
      FROM TStudent</select><resultMap id="getStudentRM" type="EStudnet">  <constructor>    <idArg column="ID" javaType="_long"/>    <arg column="Name" javaType="String"/>    <arg column="Age" javaType="_int"/>  </constructor></resultMap>

  子元素说明：

  • constructor元素 ，指定使用指定参数列表的构造函数来实例化领域模型。注意：其子元素顺序必须与参数列表顺序对应

  • idArg子元素 ，标记该入参为主键

  • arg子元素 ，标记该入参为普通字段(主键使用该子元素设置也是可以的)

  3、一对一关系、一对多关系查询

   注意：在采用嵌套结果的方式查询一对一、一对多关系时，必须要通过resultMap下的id或result标签来显式设置属性/字段映射关系，否则在查询多条记录时会仅仅返回最后一条记录的情况。

  association联合

  联合元素用来处理“一对一”的关系。需要指定映射的Java实体类的属性，属性的javaType（通常MyBatis 自己会识别）。对应的数据库表的列名称。如果想覆写的话返回结果的值，需要指定typeHandler。 
  不同情况需要告诉MyBatis 如何加载一个联合。MyBatis 可以用两种方式加载：

  • select: 执行一个其它映射的SQL 语句返回一个Java实体类型。较灵活；

  • resultsMap: 使用一个嵌套的结果映射来处理通过join查询结果集，映射成Java实体类型。

  例如，一个班级对应一个班主任。 
  首先定义好班级中的班主任 private TeacherEntity teacherEntity;

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

  ClassMapper.xml文件部分内容：

  <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文件部分内容：

  <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>

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

  修改ClassMapper.xml文件部分内容：

  <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文件部分内容中。

  collection聚集

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

  例如，一个班级有多个学生。 
  首先定义班级中的学生列表属性：private List<StudentEntity> studentList;

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

  ClassMapper.xml文件部分内容：

  <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文件部分内容：

  <!-- 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>

  使用resultMap实现聚集 
  使用resultMap，就需要重写一个sql，left join学生表。

  <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文件部分内容中。

  4. 动态映射关系 
  通过 discriminator子元素 （鉴别器）可以实现动态映射关系信息的设置。具体示例如下：

  public class EStudent{  private long id;  private String name;  private String juniorHighSchool;  private String seniorHighSchool;  private int during; // 在本校就读时间  // getter,setter方法  /**
     * 必须提供一个无参数的构造函数
     */  public EStudent(){}
  }

  情景：查询学生信息的seniorHighSchool信息，若就读时间during字段值为4、5、6时，则以juniorHighSchool字段作所为seniorHighSchool信息。

  <select id="getStundent" resultMap="rm">
    SELECT ID, Name, JuniorHighSchool, SeniorHighSchool, during
      FROM TStudent</select><resultMap id="rm" type="EStudent">
    // 若不加这句，则当将juniorHighSchool赋予给seniorHighSchool属性时，juniorHighSchool属性将为null  <result column="juniorHighSchool" property="juniorHighSchool"/>  <discriminator column="during" javaType="_int">
      // 形式1：通过resultType设置动态映射信息    <case value="4" resultType="EStudent">      <result column="juniorHighSchool" property="seniorHighSchool"/>    </case>
     // 形式2: 通过resultMap设置动态映射信息   <case value="5" resultMap="dynamicRM"/>   <case value="6" resultMap="dynamicRM"/>  </discriminator></resultMap><resultMap id="dynamicRM" type="EStudent">  <result column="juniorHighSchool" property="seniorHighSchool"/></resultMap>

  注意：上面关于 discriminator子元素 的 case元素 的 resultType属性 和 resultMap元素 的 type属性 ，均不是直指返回的领域模型类型，而是指定根据判断条件后得到映射关系，可通过 id子元素 和 result子元素 重写映射关系。

  5. id元素,result元素,idArg元素,arg元素,discriminator元素的共同属性

  • javaType属性 ：Java类的全限定名，或别名

  • jdbcType属性 ：JDBC类型, JDBC类型为CUD操作时列可能为空时进行处理

  • typeHandler属性 ：指定类型处理器的全限定类名或类型别名

  • column属性 ：指定SQL查询结果的字段名或字段别名。将用于JDBC的 resultSet.getString(columnName)

  • Cet article explique l'explication détaillée des attributs mybatis. Pour plus de contenu connexe, veuillez faire attention au site Web PHP chinois.

  • Recommandations associées :

  • Opération multi-table de base de données MySQL

  • Requête de table unique de base de données MySQL

  • Entrée de sortie de base de données Oracle
    

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!