mybatisの<resultMap>タグを使用します

記録: 420

シナリオ: MyBatis の <resultMap></resultMap> を使用して、クエリ結果オブジェクトのプロパティ、タイプ、およびデータベース テーブル フィールドのプロパティとタイプを 1 対 1 対応で手動で指定します。<result></result> のプロパティ、javaType、jdbcType、列を使用して、対応する関係を完成させます。<select> などのタグの resultMap 属性参照を使用します。

バージョン: JDK 1.8、Spring Boot 2.6.3、mybatis-3.5.9。

1. 基礎知識

1.1 MyBatis ラベル

(1) MyBatisがサポートしているタグを確認する

アドレス: http://mybatis.org/dtd/mybatis-3-mapper.dtd

(2) ラベルの使用状況を表示する

mybatis-3-mapper.dtd で次のように <mapper></mapper> タグ要素を例として取り上げます。

<!ELEMENT mapper (cache-ref | cache | resultMap* | parameterMap* | sql* | insert* | update* | delete* | select* )+>
<!ATTLIST mapper
namespace CDATA #IMPLIED
>

<!ELEMENT マッパー(...)+>。これがラベル要素マッパーであることを示します。

(..|insert*|update* | delete* | select*)。マッパー要素にネストできる要素のリストを示します。

<!ATTLIST マッパー>。これが要素タグのサポートされている属性であることを示します。

1.2 MyBatisの使用

(1) mybatis によってマッピングされた xml ファイルの場所を application.yml 設定ファイルに設定します。

mybatis:
  mapper-locations: classpath*:mapper/**/*.xml

(2) Javaインターフェースを作成します。インターフェースにメソッドを追加します。

(3) Javaインタフェースマッピングxmlファイルを作成します。XML の <mapper></mapper> タグの名前空間属性を使用して、Java インターフェイスのフルパスを指定します。Java インターフェイスと XML マッピング ファイルによってバインディング関係が完成します。

(4) <mapper></mapper> タグ内には、<insert><update><delete><select> などのタグの id 属性を使用して Java メソッド名を指定します。Java インターフェースのメソッドと XML マッピング ファイルの <mapper></mapper> 内のタグによってバインディング関係が完成します。

2. <resultMap></resultMap> タグ要素を使用します。

シナリオ: <resultMap></resultMap> タグ要素が <mapper></mapper> で定義されています。<insert><update><delete><select> などのタグ要素で resultMap 属性参照を使用します。

2.1 Javaインターフェース

@Repository
public interface Label05ResultMapMapper {
  List<CityLabelPO> queryCity01(CityLabelPO cityPO);
  List<CityLabelPO> queryCity02(CityLabelPO cityPO);
}

2.2 Javaインタフェースマッピング用のXMLファイル

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.hub.example.mapper.Label05ResultMapMapper">
  <resultMap id="poResult" type="com.hub.example.domain.CityLabelPO">
      <result property="cityId" javaType="java.lang.Long" jdbcType="BIGINT" column="CITY_ID"></result>
      <result property="cityName" javaType="java.lang.String" jdbcType="VARCHAR" column="CITY_NAME"></result>
      <result property="landArea" javaType="java.lang.Double" jdbcType="DOUBLE" column="LAND_AREA"></result>
      <result property="population" javaType="java.lang.Long" jdbcType="BIGINT" column="POPULATION"></result>
      <result property="gross" javaType="java.lang.Double" jdbcType="DOUBLE" column="GROSS"></result>
      <result property="cityDescribe" javaType="java.lang.String" jdbcType="VARCHAR" column="CITY_DESCRIBE"></result>
      <result property="dataYear" javaType="java.lang.String" jdbcType="VARCHAR" column="DATA_YEAR"></result>
      <result property="updateTime" javaType="java.util.Date" jdbcType="TIMESTAMP" column="UPDATE_TIME"></result>
  </resultMap>
  <!-- 1.使用resultMap标签封装返回结果对象-->
  <select id="queryCity01" resultMap="poResult">
      select aa.*
      from t_city aa
      where aa.CITY_ID = #{cityId}
  </select>
  <!-- 2.使用resultType属性指定封装结果对象,以及每个属性执行封装属性名称-->
  <select id="queryCity02" resultType="com.hub.example.domain.CityLabelPO">
      select CITY_ID       AS "cityId",
             CITY_NAME     AS "cityName",
             LAND_AREA     AS "landArea",
             POPULATION    AS "population",
             GROSS         AS "gross",
             CITY_DESCRIBE AS "cityDescribe",
             DATA_YEAR     AS "dataYear",
             UPDATE_TIME   AS "updateTime"
      from t_city aa
      where aa.CITY_ID = #{cityId}
  </select>
</mapper>

2.3 resultMap タイプのマッチングを使用する

<resultMap></resultMap> を使用する場合は、属性とクラスを手動で一致させる必要があります。

(1) データベースの型は、次の SQL クエリを使用できます。

MySQL の場合:

SELECT
  aa.column_name,
  aa.data_type
FROM
  INFORMATION_SCHEMA.COLUMNS aa
WHERE aa.TABLE_NAME = 't_city'
在Oracle中:
SELECT
  aa.COLUMN_NAME,
  aa.DATA_TYPE
FROM
  user_tab_columns aa
WHERE aa.table_name = 'T_CITY'

オラクルの場合:

SELECT
  aa.COLUMN_NAME,
  aa.DATA_TYPE
FROM
  user_tab_columns aa
WHERE aa.table_name = 'T_CITY'

(2) MyBatisと入力します。

「MyBatis: org.apache.ibatis.type.JdbcType」と入力します。

public enum JdbcType {
    ARRAY(2003),
    BIT(-7),
    TINYINT(-6),
    SMALLINT(5),
    INTEGER(4),
    BIGINT(-5),
    FLOAT(6),
    REAL(7),
    DOUBLE(8),
    NUMERIC(2),
    DECIMAL(3),
    CHAR(1),
    VARCHAR(12),
    LONGVARCHAR(-1),
    DATE(91),
    TIME(92),
    TIMESTAMP(93),
    BINARY(-2),
    VARBINARY(-3),
    LONGVARBINARY(-4),
    NULL(0),
    OTHER(1111),
    BLOB(2004),
    CLOB(2005),
    BOOLEAN(16),
    CURSOR(-10),
    UNDEFINED(-2147482648),
    NVARCHAR(-9),
    NCHAR(-15),
    NCLOB(2011),
    STRUCT(2002),
    JAVA_OBJECT(2000),
    DISTINCT(2001),
    REF(2006),
    DATALINK(70),
    ROWID(-8),
    LONGNVARCHAR(-16),
    SQLXML(2009),
    DATETIMEOFFSET(-155),
    TIME_WITH_TIMEZONE(2013),
    TIMESTAMP_WITH_TIMEZONE(2014);
    public final int TYPE_CODE;
    private static Map<Integer, JdbcType> codeLookup = new HashMap();
    private JdbcType(int code) {
        this.TYPE_CODE = code;
    }
    public static JdbcType forCode(int code) {
        return (JdbcType)codeLookup.get(code);
    }
    static {
        JdbcType[] var0 = values();
        int var1 = var0.length;
        for(int var2 = 0; var2 < var1; ++var2) {
            JdbcType type = var0[var2];
            codeLookup.put(type.TYPE_CODE, type);
        }
    }
}

(3) Javaエンティティクラスの型

Java エンティティ クラスの型は、定義オブジェクトで直接表示されます。例えば:

java.lang.Integer
java.lang.Long
java.lang.Double
java.lang.String
java.lang.String
java.util.Date
java.lang.Boolean

3. テスト

3.1 テストコード

@Slf4j
@RestController
@RequestMapping("/hub/example/cityLabel")
public class CityLabelController {
  @Autowired
  private Label05ResultMapMapper label05ResultMapMapper;
  @GetMapping("/load05")
  public Object load05() {
    log.info("测试开始...");
    CityLabelPO cityPO = CityLabelPO.builder().cityId(3L).build();
    // 示例一 
    List<CityLabelPO> list01 = label05ResultMapMapper.queryCity01(cityPO);
    // 示例二 
    List<CityLabelPO> list02 = label05ResultMapMapper.queryCity02(cityPO);
    log.info("测试结束...");
    return "执行成功";
  }
}

3.2 テストリクエスト

URL:http://127.0.0.1:18080/hub-example/hub/example/cityLabel/load05

3.3 SQLの実行

この例では、<resultMap></resultMap> タグを使用して、さまざまなビジネス シナリオに適応するさまざまな条件に従ってさまざまなクエリの SQL を組み立てます。

例 1:

select aa.* from t_city aa where aa.CITY_ID = ?

例 2:

SELECT
  CITY_ID AS "cityId",
  CITY_NAME AS "cityName",
  LAND_AREA AS "landArea",
  POPULATION AS "population",
  GROSS AS "gross",
  CITY_DESCRIBE AS "cityDescribe",
  DATA_YEAR AS "dataYear",
  UPDATE_TIME AS "updateTime"
FROM
  t_city aa
WHERE aa.CITY_ID = ?

4. サポート

4.1 エンティティオブジェクト

(1) 結果オブジェクトCityLabelPOをカプセル化する

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class CityLabelPO {
  private Long cityId;
  private String cityName;
  private Double landArea;
  private Long population;
  private Double gross;
  private String cityDescribe;
  private String dataYear;
  private Date updateTime;
}

4.2 テーブル作成ステートメント

CREATE TABLE t_city (
  CITY_ID BIGINT(16) NOT NULL COMMENT '唯一标识',
  CITY_NAME VARCHAR(64) COLLATE utf8_bin NOT NULL COMMENT '城市名',
  LAND_AREA DOUBLE DEFAULT NULL COMMENT '城市面积',
  POPULATION BIGINT(16) DEFAULT NULL COMMENT '城市人口',
  GROSS DOUBLE DEFAULT NULL COMMENT '生产总值',
  CITY_DESCRIBE VARCHAR(512) COLLATE utf8_bin DEFAULT NULL COMMENT '城市描述',
  DATA_YEAR VARCHAR(16) COLLATE utf8_bin DEFAULT NULL COMMENT '数据年份',
  UPDATE_TIME DATETIME DEFAULT NULL COMMENT '更新时间'
) ENGINE=INNODB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='城市信息表';

以上、ありがとうございます。

2023 年 4 月 23 日

おすすめ

転載: blog.csdn.net/zhangbeizhen18/article/details/130331263