resultMap

MyBatis

resultMap

SQL 쿼리 결과를 Java 객체로 매핑하는 태그입니다.

resultMap을 사용하면 복잡한 SQL 쿼리 결과를 쉽게 매핑할 수 있으며, 특히 JOIN 쿼리 결과를 여러 객체로 매핑할 때 유용합니다.

resultMap 을 사용하면, 설정을 통해서 1:1, 1:N JOIN 쿼리를 적용할 수 있습니다.

개요

•

기본 구조

◦

구조 설명

◦

기본 코드

•

주요 요소

•

주요 기능

•

주요 예시

기본 구조

구조 설명

<resultMap id="매핑ID" type="패키지.클래스명">
    <!-- 기본 키를 매핑하는 요소 -->
    <id property="자바 객체의 변수명" column="DB 테이블의 컬럼명"/>
    <!-- 일반 속성을 매핑하는 요소 -->
    <result property="자바 객체의 변수명" column="DB 테이블의 컬럼명"/>
    
    <!-- 1:1 관계를 매핑하는 요소 -->
    <association property="객체 변수명" javaType="패키지.클래스명 (제2의 매핑객체)">
        <!-- 중첩된 resultMap 요소 -->
    </association>
    <!-- 1:N 관계를 매핑하는 요소 -->
    <collection property="컬렉션 변수명" ofType="자바 컬렉션 타입">
        <!-- 중첩된 resultMap 요소 -->
    </collection>
</resultMap>
XML
복사

<resultMap>: resultMap 요소는 매핑을 정의하는 루트 요소입니다.

•

id: resultMap의 고유 식별자입니다.

•

type: 매핑할 Java 클래스의 전체 이름입니다.

<id>: 기본 키를 매핑하는 데 사용됩니다.

•

property: Java 객체의 속성 이름입니다.

•

column: SQL 쿼리 결과의 열 이름입니다.

<result>: 일반 속성을 매핑하는 데 사용됩니다.

•

property: Java 객체의 속성 이름입니다.

•

column: SQL 쿼리 결과의 열 이름입니다.

<association>: 1:1 관계를 매핑하는 데 사용됩니다.

•

property: Java 객체의 속성 이름입니다.

•

javaType: 연관된 Java 클래스의 전체 이름입니다.

•

association 요소 내에 다른 resultMap 요소를 중첩할 수 있습니다.

<collection>: 1:N 관계를 매핑하는 데 사용됩니다.

•

property: Java 객체의 속성 이름입니다.

•

ofType: 연관된 Java 클래스의 전체 이름입니다.

•

collection 요소 내에 다른 resultMap 요소를 중첩할 수 있습니다.

기본 코드

<?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.aloha.thymeleaf_security.mapper.UserMapper">
	<resultMap type="Users" id="UserMap">
	    <id property="no" column="no" />
	    
	    <result property="no" column="no" />
	    <result property="username" column="username" />
	    <result property="password" column="password" />
	    <result property="name" column="name" />
	    <result property="email" column="email" />
	    <result property="enabled" column="enabled" />
	    <result property="createdAt" column="created_at" />
	    <result property="updatedAt" column="updated_at" />
	    
	</resultMap>
</mapper>
XML
복사

@Data
public class Users {
    private Long no;
    private String username;
    private String password;
    private String name;
    private String email;
    private Date createdAt;
    private Date updatedAt;
    private int enabled;
}
Java
복사

DROP TABLE IF EXISTS `user`;

CREATE TABLE `user` (
  `NO` bigint NOT NULL AUTO_INCREMENT,
  `ID` varchar(255) NOT NULL,
  `USERNAME` varchar(100) NOT NULL,
  `PASSWORD` varchar(200) NOT NULL,
  `NAME` varchar(100) NOT NULL,
  `EMAIL` varchar(200) DEFAULT NULL,
  `CREATED_AT` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `UPDATED_AT` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `ENABLED` int DEFAULT 1,
  PRIMARY KEY (`NO`)
) COMMENT='회원';
SQL
복사

주요 요소

•

<resultMap>

◦

<id>

◦

<result>

◦

<association>

◦

<collection>

요소	속성	설명
<resultMap>	id	resultMap의 고유 식별자입니다.
	type	매핑할 Java 클래스의 전체 이름입니다.
<id>	property	Java 객체의 속성 이름입니다.
	column	SQL 쿼리 결과의 열 이름입니다.
	javaType	(선택 사항) 매핑할 Java 타입입니다.
	jdbcType	(선택 사항) 매핑할 JDBC 타입입니다.
	typeHandler	(선택 사항) 사용자 정의 타입 핸들러입니다.
<result>	property	Java 객체의 속성 이름입니다.
	column	SQL 쿼리 결과의 열 이름입니다.
	javaType	(선택 사항) 매핑할 Java 타입입니다.
	jdbcType	(선택 사항) 매핑할 JDBC 타입입니다.
	typeHandler	(선택 사항) 사용자 정의 타입 핸들러입니다.
<association>	property	Java 객체의 속성 이름입니다.
	javaType	연관된 Java 클래스의 전체 이름입니다.
	columnPrefix	(선택 사항) 열 이름의 접두사입니다.
	select	(선택 사항) 별도의 select 문을 지정합니다.
	resultMap	(선택 사항) 중첩된 resultMap의 ID입니다.
	notNullColumn	(선택 사항) null이 아닌 열을 지정합니다.
	fetchType	(선택 사항) lazy 또는 eager 로딩을 지정합니다.
<collection>	property	Java 객체의 속성 이름입니다.
	ofType	연관된 Java 클래스의 전체 이름입니다.
	columnPrefix	(선택 사항) 열 이름의 접두사입니다.
	select	(선택 사항) 별도의 select 문을 지정합니다.
	resultMap	(선택 사항) 중첩된 resultMap의 ID입니다.
	notNullColumn	(선택 사항) null이 아닌 열을 지정합니다.
	fetchType	(선택 사항) lazy 또는 eager 로딩을 지정합니다.

<resultMap>

SQL 쿼리 결과를 Java 객체로 매핑하는 루트 요소입니다.

속성	설명
id	resultMap의 고유 식별자입니다.
type	매핑할 Java 클래스의 전체 이름입니다.

<resultMap id="맵id" type="패키지명.클래스명">

</resultMap>
XML
복사

type 속성의 값은 Java 클래스의 전체 이름 (패키지명.클래스명)을 지정해야합니다.

typeAliases 별칭 설정이 되어있으면 type 속성값으로 별칭을 지정할 수도 있습니다.

typeAliases 설정 방법

mybatis 에서 Java 클래스 전체이름(패키지명.클래스명)을 설정하는 방법은 아래 방법 중에 하나로 적용할 수 있습니다.

•

 mybatis-config.xml 

•

 application.properties 

•

 @Alias 어노테이션

mybatis-config.xml

•

설정 파일 위치

◦

 ~/src/main/resources

▪

 mybatis-config.xml

•

mybatis-config.xml 

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "https://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>

	<!-- 설정 -->
	<settings>
		<!-- 언더스코어 케이스인 컬럼을 카멜 케이스로 변환하는 설정  -->
		<!-- board_no - boardNo -->
		<setting name="mapUnderscoreToCamelCase" value="true"/>
	</settings>
	
	<!-- 타입 별칭 설정 -->
	<typeAliases>
		<!-- 
			⭐ typeAlias : 별칭 설정 
			- alias : 별칭
			- type : 별칭을 사용할 클래스 경로
		-->
		<typeAlias alias="User" type="com.aloha.mybatis.dto.User"/>
		<!--
			⭐ package : 패키지 경로 지정
			- name : 패키지 경로
		-->
		<package name="com.aloha.mybatis.dto"/>
	</typeAliases>	


</configuration>
XML
복사

•

application.properties

# Mybatis 설정

# Mybatis 설정 경로      : ~/resources/mybatis-config.xml
mybatis.config-location=classpath:mybatis-config.xml

# Mybatis 매퍼 파일 경로 : ~/메인패키지/mapper/**Mapper.xml
mybatis.mapper-locations=classpath:mybatis/mapper/**/**.xml
Java
복사

타입 별칭 package 경로를 설정하면, 해당 패키지 아래의 모든 클래스들을 클래스 이름만으로 type 을 지정할수 있습니다.

•

typeAliases - package 설정 

<resultMap id="맵id" type="패키지명.클래스명">

</resultMap>
XML
복사

•

typeAliases - package 설정 

<!-- <resultMap id="맵id" type="패키지명.클래스명"> -->
<resultMap id="맵id" type="클래스명">

</resultMap>
XML
복사

application.properties

mybatis-config.xml 마이바티스 설정파일을 따로 만들지 않고,

application.properties 의 속성으로 바로 적용할 수도 있습니다.

# Mybatis 설정

# 컬럼명을 변수명으로 자동매핑 :  board_no ➡ boardNo
mybatis.configuration.map-underscore-to-camel-case=true
# resultType 속성에서 dto 객체 (패키지.클래스명) ➡ (클래스명)
mybatis.type-aliases-package=com.aloha.mybatis.dto

# Mybatis 매퍼 파일 경로 : ~/메인패키지/mapper/**Mapper.xml
mybatis.mapper-locations=classpath:mybatis/mapper/**/**.xml
Java
복사

@Alias 어노테이션

mybatis-config.xml 또는 application properties 에 MyBatis가 지정된 패키지 내의 클래스에 대해 타입 별칭을 자동으로 스캔하도록 설정해야 @Alias 를 사용할 수 있습니다.

쿼리 결과를 매핑할 각 객체에서, @Alias 어노테이션으로 별칭을 설정하는 방법

package com.aloha.mybaits.dto;
...

@Data
@Alias("Users")
public class Users {
    private Long no;
    private String username;
    private String password;
    private String name;
    private String email;
    private Date createdAt;
    private Date updatedAt;
    private int enabled;
}
Java
복사

•

@Alias("Users") 설정 

<!-- ⭐ typeAliases 설정하지 않은 경우 - 패키지명.클래스명 -->
<select id="select" resultType="com.aloha.mybatis.dto.Users">
    SELECT *
    FROM user
    WHERE username = #{username}
</select>
XML
복사

•

@Alias("Users") 설정 

<!-- ⭐ typeAliases 설정한 경우 - 별칭 (Users) -->
<select id="select" resultType="Users">
    SELECT *
    FROM user
    WHERE username = #{username}
</select>
XML
복사

<id>

기본 키를 매핑하는 데 사용되는 요소입니다.

속성	설명
property	Java 객체의 속성 이름입니다.
column	SQL 쿼리 결과의 열 이름입니다.
javaType	(선택 사항) 매핑할 Java 타입입니다.
jdbcType	(선택 사항) 매핑할 JDBC 타입입니다.
typeHandler	(선택 사항) 사용자 정의 타입 핸들러입니다.

<result>

일반 속성을 매핑하는 데 사용되는 요소입니다.

속성	설명
property	Java 객체의 속성 이름입니다.
column	SQL 쿼리 결과의 열 이름입니다.
javaType	(선택 사항) 매핑할 Java 타입입니다.
jdbcType	(선택 사항) 매핑할 JDBC 타입입니다.
typeHandler	(선택 사항) 사용자 정의 타입 핸들러입니다.

<association>

1:1 관계를 매핑하는 데 사용되는 요소입니다.

속성	설명
property	Java 객체의 속성 이름입니다.
javaType	연관된 Java 클래스의 전체 이름입니다.
columnPrefix	(선택 사항) 열 이름의 접두사입니다.
select	(선택 사항) 별도의 select 문을 지정합니다.
resultMap	(선택 사항) 중첩된 resultMap의 ID입니다.
notNullColumn	(선택 사항) null이 아닌 열을 지정합니다.
fetchType	(선택 사항) lazy 또는 eager 로딩을 지정합니다.

<collection>

1:N 관계를 매핑하는 데 사용되는 요소입니다.

속성	설명
property	Java 객체의 속성 이름입니다.
ofType	연관된 Java 클래스의 전체 이름입니다.
columnPrefix	(선택 사항) 열 이름의 접두사입니다.
select	(선택 사항) 별도의 select 문을 지정합니다.
resultMap	(선택 사항) 중첩된 resultMap의 ID입니다.
notNullColumn	(선택 사항) null이 아닌 열을 지정합니다.
fetchType	(선택 사항) lazy 또는 eager 로딩을 지정합니다.

주요 기능

객체 매핑 (Object Mapping)

1:1 조인 (One-to-One Join)

1:N 조인 (One-to-Many Join)

다중 매핑 (Multiple Mapping)

상속 매핑 (Inheritance Mapping)

복합 키 매핑 (Composite Key Mapping)

네임스페이스 사용 (Namespace Usage)

자동 매핑 (Auto Mapping)

resultMap은 MyBatis에서 SQL 쿼리 결과를 Java 객체로 매핑하는 데 사용됩니다. 이를 통해 다양한 매핑 작업을 수행할 수 있습니다.

1. 객체 매핑 (Object Mapping)

SQL 쿼리 결과를 Java 객체의 속성에 매핑합니다. 각 컬럼을 객체의 속성에 매핑할 수 있습니다.

<resultMap id="UserMap" type="User">
    <id property="id" column="id"/>
    <result property="username" column="username"/>
    <result property="password" column="password"/>
    <result property="name" column="name"/>
    <result property="email" column="email"/>
    <result property="enabled" column="enabled"/>
    <result property="createdAt" column="created_at"/>
    <result property="updatedAt" column="updated_at"/>
</resultMap>
XML
복사

2. 1:1 조인 (One-to-One Join)

다른 테이블과의 1:1 관계를 매핑합니다. association 요소를 사용하여 다른 객체와의 관계를 정의할 수 있습니다.

<resultMap id="UserMap" type="User">
    <id property="id" column="id"/>
    <result property="username" column="username"/>
    <result property="password" column="password"/>
    <result property="name" column="name"/>
    <result property="email" column="email"/>
    <result property="enabled" column="enabled"/>
    <result property="createdAt" column="created_at"/>
    <result property="updatedAt" column="updated_at"/>
    <association property="profile" javaType="Profile">
        <id property="id" column="profile_id"/>
        <result property="bio" column="bio"/>
        <result property="website" column="website"/>
    </association>
</resultMap>
XML
복사

3. 1:N 조인 (One-to-Many Join)

다른 테이블과의 1:N 관계를 매핑합니다. collection 요소를 사용하여 컬렉션 속성을 정의할 수 있습니다.

<resultMap id="UserMap" type="User">
    <id property="id" column="id"/>
    <result property="username" column="username"/>
    <result property="password" column="password"/>
    <result property="name" column="name"/>
    <result property="email" column="email"/>
    <result property="enabled" column="enabled"/>
    <result property="createdAt" column="created_at"/>
    <result property="updatedAt" column="updated_at"/>
    <collection property="roles" ofType="Role">
        <id property="id" column="role_id"/>
        <result property="name" column="role_name"/>
    </collection>
</resultMap>
XML
복사

4. 다중 매핑 (Multiple Mapping)

여러 테이블의 결과를 하나의 객체에 매핑할 수 있습니다. association과 collection을 조합하여 복잡한 매핑을 수행할 수 있습니다.

<resultMap id="UserMap" type="User">
    <id property="id" column="id"/>
    <result property="username" column="username"/>
    <result property="password" column="password"/>
    <result property="name" column="name"/>
    <result property="email" column="email"/>
    <result property="enabled" column="enabled"/>
    <result property="createdAt" column="created_at"/>
    <result property="updatedAt" column="updated_at"/>
    <association property="profile" javaType="Profile">
        <id property="id" column="profile_id"/>
        <result property="bio" column="bio"/>
        <result property="website" column="website"/>
    </association>
    <collection property="roles" ofType="Role">
        <id property="id" column="role_id"/>
        <result property="name" column="role_name"/>
    </collection>
</resultMap>
XML
복사

5. 상속 매핑 (Inheritance Mapping)

상속 관계를 매핑할 수 있습니다. discriminator 요소를 사용하여 상속 관계를 정의할 수 있습니다.

<resultMap id="vehicleMap" type="Vehicle">
    <id property="id" column="id"/>
    <result property="make" column="make"/>
    <result property="model" column="model"/>
    <discriminator javaType="string" column="type">
        <case value="car" resultType="Car"/>
        <case value="truck" resultType="Truck"/>
    </discriminator>
</resultMap>
XML
복사

6. 복합 키 매핑 (Composite Key Mapping)

복합 키를 매핑할 수 있습니다. 여러 컬럼을 하나의 키로 매핑할 수 있습니다.

<resultMap id="orderMap" type="Order">
    <id property="orderId" column="order_id"/>
    <id property="productId" column="product_id"/>
    <result property="quantity" column="quantity"/>
    <result property="price" column="price"/>
</resultMap>
XML
복사

7. 네임스페이스 사용 (Namespace Usage)

다른 resultMap을 재사용할 수 있습니다. extends 속성을 사용하여 다른 resultMap을 확장할 수 있습니다.

<resultMap id="baseUserMap" type="User">
    <id property="id" column="id"/>
    <result property="username" column="username"/>
    <result property="password" column="password"/>
</resultMap>

<resultMap id="extendedUserMap" extends="baseUserMap">
    <result property="name" column="name"/>
    <result property="email" column="email"/>
</resultMap>
XML
복사

8. 자동 매핑 (Auto Mapping)

MyBatis는 자동 매핑 기능을 제공하여 SQL 결과를 자동으로 Java 객체에 매핑할 수 있습니다. autoMapping 속성을 사용하여 자동 매핑을 활성화할 수 있습니다.

<resultMap id="UserMap" type="User" autoMapping="true">
    <id property="id" column="id"/>
    <result property="username" column="username"/>
    <result property="password" column="password"/>
    <result property="name" column="name"/>
    <result property="email" column="email"/>
    <result property="enabled" column="enabled"/>
    <result property="createdAt" column="created_at"/>
    <result property="updatedAt" column="updated_at"/>
</resultMap>
XML
복사

resultMap을 사용하면 MyBatis에서 다양한 매핑 작업을 수행할 수 있습니다. 객체 매핑, 1:1 조인, 1:N 조인, 다중 매핑, 상속 매핑, 복합 키 매핑, 네임스페이스 사용, 자동 매핑 등 다양한 기능을 활용하여 복잡한 SQL 결과를 Java 객체로 매핑할 수 있습니다. 이를 통해 데이터베이스와 애플리케이션 간의 데이터 전송을 효율적으로 처리할 수 있습니다.

주요 예시

•

조인

◦

1:1 조인 - association

◦

1:N 조인 - collection

조인

•

1:1 조인 - association

•

1:N 조인 - collection

예시 객체 및 테이블

•

user.sql

•

user_auth.sql

•

board.sql

•

Users.java

•

UserAuth.java

user.sql

DROP TABLE IF EXISTS `user`;

CREATE TABLE `user` (
  `NO` bigint NOT NULL AUTO_INCREMENT,
  `ID` VARCHAR(255)	NOT NULL	COMMENT 'UK',
  `USERNAME` varchar(100) NOT NULL,
  `PASSWORD` varchar(200) NOT NULL,
  `NAME` varchar(100) NOT NULL,
  `EMAIL` varchar(200) DEFAULT NULL,
  `CREATED_AT` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `UPDATED_AT` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `ENABLED` int DEFAULT 1,
  PRIMARY KEY (`NO`)
) COMMENT='회원';
SQL
복사

user_auth.sql

DROP TABLE IF EXISTS `user_auth`;

CREATE TABLE `user_auth` (
      no bigint NOT NULL AUTO_INCREMENT       -- 권한번호
    `id`	VARCHAR(255)	NOT NULL	COMMENT 'UK',
    , username varchar(100) NOT NULL             -- 아이디
    , auth varchar(100) NOT NULL                -- 권한 (ROLE_USER, ROLE_ADMIN, ...)
    , PRIMARY KEY(no)                      
);
SQL
복사

board.sql

DROP TABLE IF EXISTS `board`;

CREATE TABLE `board` (
	`no`	BIGINT	NOT NULL AUTO_INCREMENT PRIMARY KEY	COMMENT 'PK',
	`id`	VARCHAR(255)	NOT NULL	COMMENT 'UK',
	`title`	VARCHAR(100)	NOT NULL	COMMENT '제목',
  `user_no`	BIGINT	NOT NULL	COMMENT '회원PK',
	`content`	TEXT	NULL	COMMENT '내용',
	`created_at`	TIMESTAMP	NOT NULL	DEFAULT CURRENT_TIMESTAMP	COMMENT '등록일자',
	`updated_at`	TIMESTAMP	NOT NULL	DEFAULT CURRENT_TIMESTAMP	COMMENT '수정일자'
);


ALTER TABLE `board` ADD CONSTRAINT `FK_users_TO_board_1` FOREIGN KEY (
	`user_no`
)
REFERENCES `users` (
	`no`
)
ON DELETE CASCADE
;
SQL
복사

Users.java

@Data
public class Users {
    private Long no;
    private String id;
    private String username;
    private String password;
    private String name;
    private String email;
    private Date createdAt;
    private Date updatedAt;
    private int enabled;

    private List<UserAuth> authList;
    
    public Users() {
        this.id = UUID.randomUUID().toString();
    }

}
Java
복사

UserAuth.java

@Data
public class UserAuth {
    private Long no;
    private String id;
    private String username;
    private String auth;
    private Date createdAt;
    private Date updatedAt;
    
    public UserAuth() {
        this.id = UUID.randomUUID().toString();
    }
}
Java
복사

Board.java

@Data
@AllArgsConstructor
@Builder
public class Board {

    private Long no;
    private String id;
    private String title;
    private Long userNo;
    private String content;
    private Date createdAt;
    private Date updatedAt;

    // 유저
    Users user;

    public Board() {
        this.id = UUID.randomUUID().toString();
    }
    
}
Java
복사

1:1 조인 - association

association

MyBatis에서 1:1 관계를 매핑하기 위해 사용되는 요소입니다. 이는 SQL 쿼리 결과를 Java 객체의 속성으로 매핑할 때, 다른 객체와의 1:1 관계를 정의하는 데 사용됩니다.

방법

•

방법 1 - JOIN 쿼리 직접 작성

•

방법 2 - 2개의 쿼리를 연결

board 테이블과 user 테이블을 1:1 로 조인하여, board 테이블의 user_no 로 user 테이블의 no (PK) 참조하여 조회합니다.

이 때, Board 객체 안의 필드(멤버변수)인 Users 객체에 조인 결과를 매핑합니다. 여기서는, 게시글 정보 조회 시, 사용자 정보(이름)을 참조하여 출력하기 위해 사용합니다.

방법 1 - JOIN 쿼리 직접 작성

<resultMap id="BoardMap" type="Board">
    <!-- Board 필드 매핑 -->
    <id property="no" column="no" />
    <result property="id" column="id" />
    <result property="title" column="title" />
    <result property="content" column="content" />
    <result property="userNo" column="user_no" />
    <result property="createdAt" column="created_at" />
    <result property="updatedAt" column="updated_at" />

    <!-- Users 객체 매핑 -->
    <association property="user" javaType="Users">
        <id property="no" column="user_no" />
        <result property="name" column="name" />
        <result property="username" column="username"/>
    </association>
</resultMap>
XML
복사

<select id="list" resultMap="BoardMap">
	SELECT b.*
	      ,u.no user_no
	      ,u.name
	      ,u.username 
	FROM board b JOIN user u ON b.user_no = u.no
</select>
XML
복사

방법 2 - 2개의 쿼리를 연결

<resultMap id="BoardMap" type="Board">
    <!-- Board 필드 매핑 -->
    <id property="no" column="no" />
    <result property="id" column="id" />
    <result property="title" column="title" />
    <result property="content" column="content" />
    <result property="userNo" column="user_no" />
    <result property="createdAt" column="created_at" />
    <result property="updatedAt" column="updated_at" />

    <!-- Users 객체 매핑 -->
    <association property="user" select="selectUser" column="user_no" ofType="com.aloha.security_method.domain.Users">
        <id property="no" column="user_no" />
        <result property="name" column="name" />
        <result property="username" column="username"/>
    </association>
</resultMap>
XML
복사

association

•

property: 

◦

주 객체의 속성 이름을 지정합니다. 

◦

이 속성은 연관된 객체를 저장할 속성입니다.

◦

여기서는, Board 객체의 Users user; 변수로 선언되어 있습니다.

•

select

◦

연관된 객체를 조회하기 위한 SQL 쿼리를 지정합니다. 

◦

이 쿼리는 다른 매퍼 메소드로 정의되어 있어야 합니다.

◦

여기서는, selectUser select 태그 id 로 쿼리가 지정되어 있습니다.

•

column

◦

주 객체의 컬럼 이름을 지정합니다.

◦

이 컬럼의 값이 연관된 객체를 조회하는 데 사용됩니다.

◦

여기서는, board 테이블의 user_no 를 지정하여, 서브쿼리에 전달하여 조인합니다.

•

ofType

◦

연관된 객체의 타입을 지정합니다.

◦

이 속성은 연관된 객체의 Java 클래스 타입을 지정합니다.

◦

여기서는, Users 객체로 매핑되도록 지정합니다.

•

메인 쿼리

<select id="list" resultMap="BoardMap">
	SELECT *
	FROM board
</select>
XML
복사

•

서브 쿼리

◦

resultType 으로 지정

◦

resultMap 으로 지정

•

resultType 으로 지정

<select id="selectUser" resultType="Users">
    SELECT u.no user_no
          ,u.*
    FROM user
    WHERE user_no= #{user_no}
</select>
XML
복사

•

resultMap 으로 지정

<select id="selectUser" resultMap="UserMap">
    SELECT u.no user_no
          ,u.*
    FROM user
    WHERE user_no= #{user_no}
</select>
XML
복사

(UserMap 은 아직 미구현 뒤에 1:N 조인 - collection 에서 구현)

resultMap 으로, JOIN 시, 하위 매핑 타입도 resultMap 이고 그 매핑에서도 조인을 하고 있다면, 아래와 같이 계층적으로 조회가 가능하다.

즉, 게시글 정보와 회원 정보를 조인하면서, 회원정보와 권한 정보가 조인되어 조회할 수 있다.

•

BoardMap

◦

UserMap

▪

AuthMap

1:N 조인 - collection

collection

MyBatis에서 collection 요소는 1:N 관계를 매핑하는 데 사용됩니다. 이는 SQL 쿼리 결과를 Java 객체의 컬렉션 속성으로 매핑할 때 사용됩니다.

예시

user - user_auth JOIN

board - user JOIN

user - user_auth JOIN

방법

•

방법 1 - JOIN 쿼리 직접 작성

•

방법 2 - 2개의 쿼리를 연결

user 테이블과 user_auth 테이블을 1:N 로 조인하여, user 테이블의 username 과 user_auth 테이블의 username 를 조인 조건으로 조회합니다.

이 때, Users 객체 안의 필드(멤버변수)인 List<UserAuth> 컬렉션에 조인 결과를 매핑합니다. 여기서는, 회원 정보 조회 시, 회원 권한 목록을 함께 조회하기 위해 사용합니다.

방법 1 - JOIN 쿼리 직접 작성

<resultMap id="UserMap" type="com.aloha.security_method.domain.Users">
    <id property="no" column="no" />
    <result property="username" column="username" />
    <result property="password" column="password" />
    <result property="name" column="name" />
    <result property="email" column="email" />
    <result property="enabled" column="enabled" />
    <result property="createdAt" column="created_at" />
    <result property="updatedAt" column="updated_at" />
    
    <collection property="authList" resultMap="authMap"></collection>
</resultMap>
    
<resultMap id="authMap" type="UserAuth">
    <id property="no" column="auth_no" />
    <result property="id" column="auth_id" />
    <result property="username" column="username" />
    <result property="userNo" column="user_no" />
    <result property="auth" column="auth" />
    <result property="createdAt" column="created_at" />
    <result property="updatedAt" column="updated_at" />
</resultMap>
XML
복사

<select id="select" resultMap="UserMap">
    SELECT u.no
          ,u.username
          ,password
          ,name
          ,email
          ,enabled
          ,u.created_at
          ,u.updated_at
          ,auth.no auth_no
          ,auth.id auth_id
          ,auth.user_no
          ,auth.auth auth
    FROM user u LEFT OUTER JOIN user_auth auth ON u.username = auth.username
    WHERE u.username = #{username}
</select>
XML
복사

방법 2 - 2개의 쿼리를 연결

<resultMap id="UserMap" type="com.aloha.security_method.domain.Users">
    <id property="no" column="no" />
    <result property="username" column="username" />
    <result property="password" column="password" />
    <result property="name" column="name" />
    <result property="email" column="email" />
    <result property="enabled" column="enabled" />
    <result property="createdAt" column="created_at" />
    <result property="updatedAt" column="updated_at" />
    
    <collection property="authList" select="selectAuthList" column="username" javaType="list" ofType="com.car.ckauto.domain.users.UserAuth" ></collection>
</resultMap>
XML
복사

collection

•

property: 

◦

주 객체의 속성 이름을 지정합니다. 

◦

이 속성은 연관된 객체를 저장할 속성입니다.

◦

여기서는, Users 객체의 List<UserAuth> authList; 변수로 선언되어 있습니다.

•

select

◦

연관된 객체를 조회하기 위한 SQL 쿼리를 지정합니다. 

◦

이 쿼리는 다른 매퍼 메소드로 정의되어 있어야 합니다.

◦

여기서는, selectAuthList select 태그 id 로 쿼리가 지정되어 있습니다.

•

column

◦

주 객체의 컬럼 이름을 지정합니다.

◦

이 컬럼의 값이 연관된 객체를 조회하는 데 사용됩니다.

◦

여기서는, user 테이블의 username 를 지정하여, 서브쿼리에 전달하여 조인합니다.

•

ofType

◦

연관된 객체의 타입을 지정합니다.

◦

이 속성은 연관된 객체의 Java 클래스 타입을 지정합니다.

◦

여기서는, UserAuth 객체로 매핑되도록 지정합니다.

•

메인 쿼리

<select id="select" resultMap="UserMap">
    SELECT *
    FROM user u
    WHERE u.username = #{username}
</select>
XML
복사

•

서브 쿼리

<select id="selectAuthList" resultType="UserAuth">
    SELECT *
    FROM user_auth
    WHERE username = #{username}
</select>
XML
복사

board - user JOIN

•

BoardMapper.xml

•

UserMapper.xml

•

JOIN 테이블 관계

boad : user = 1 : 1 user : user_auth = 1 : N

BoardMapper.xml

<resultMap id="BoardMap" type="Board">
    <!-- Board 필드 매핑 -->
    <id property="no" column="no" />
    <result property="id" column="id" />
    <result property="title" column="title" />
    <result property="content" column="content" />
    <result property="userNo" column="user_no" />
    <result property="createdAt" column="created_at" />
    <result property="updatedAt" column="updated_at" />

    <!-- Users 객체 매핑 -->
    <association property="user" select="selectUser" column="user_no" javaType="com.aloha.security_method.domain.Users"></association>
  
</resultMap>
XML
복사

<select id="list" resultMap="BoardMap">
	SELECT b.*
	FROM board b 
</select>
XML
복사

<select id="selectUser" resultMap="com.aloha.security_method.mapper.UserMapper.UserMap">
    SELECT *
    FROM user u
    WHERE u.no = #{user_no}
</select>
XML
복사

UserMapper.xml

<resultMap id="UserMap" type="com.aloha.security_method.domain.Users">
    <id property="no" column="no" />
    <result property="username" column="username" />
    <result property="password" column="password" />
    <result property="name" column="name" />
    <result property="email" column="email" />
    <result property="enabled" column="enabled" />
    <result property="createdAt" column="created_at" />
    <result property="updatedAt" column="updated_at" />
    
    <collection property="authList" select="selectAuthList" column="username" javaType="list" ofType="com.car.ckauto.domain.users.UserAuth" ></collection>
</resultMap>
        
XML
복사

<select id="select" resultMap="UserMap">
    SELECT *
    FROM user u
    WHERE u.username = #{username}
</select>
XML
복사

<select id="selectAuthList" resultType="UserAuth">
    SELECT *
    FROM user_auth
    WHERE username = #{username}
</select>
XML
복사

이렇게 resultMap 으로 참조하여 JOIN 을 하면, 다중의 JOIN 쿼리를 쉽게 작성할 수 있다.

여기서는, 게시글 목록 조회 시

•

board : user = 1 : 1 

•

user : user_auth = 1 : N

이렇게 다중으로 계층적으로 게시글 목록을 조회할 수 있다.

- BoardMap
    - UserMap
        - AuthMap (or selectAuthList)
Plain Text
복사

Board
├── no: 1
├── id: 67610565-a89b-11ef-a47a-a8a1596f255e
├── title: 제목1
├── userNo: 3
├── content: 내용1
├── createdAt: Fri Nov 22 15:31:27 KST 2024
├── updatedAt: Fri Nov 22 15:31:27 KST 2024
├── user: Users
│   ├── no: 3
│   ├── id: 60b8c64d-a89b-11ef-a47a-a8a1596f255e
│   ├── username: test
│   ├── password: $2a$12$TrN..KcVjciCiz.5Vj96YOBljeVTTGJ9AUKmtfbGpgc9hmC7BxQ92
│   ├── name: 테스트
│   ├── email: test@mail.com
│   ├── createdAt: Fri Nov 22 15:31:16 KST 2024
│   ├── updatedAt: Fri Nov 22 15:31:16 KST 2024
│   ├── enabled: 1
│   └── authList: List<UserAuth>
│       └── UserAuth
│           ├── no: 4
│           ├── id: 64816228-a89b-11ef-a47a-a8a1596f255e
│           ├── userNo: 1
│           ├── username: test
│           ├── auth: ROLE_USER
│           ├── createdAt: Fri Nov 22 15:31:23 KST 2024
│           └── updatedAt: Fri Nov 22 15:31:23 KST 2024
├── fileList: null
└── deleteFiles: null
Plain Text
복사