Spring + MyBatis에서 쿼리의 결과와 객체가 매핑이 되는 과정

🧷 Spring + MyBatis에서 쿼리의 결과와 객체가 매핑이 되는 과정

 

스프링에서 마이바티스를 사용할 때, Select 쿼리의 결과와 객체(Dto)가 어떠한 작업을 통해 매핑이 되는지 정확하게 파악하고 공유하기 위해 매핑 과정에 대해 정리해 보았습니다.

(당연히 틀린 내용이 존재할 수 있으니 피드백 주시면 감사하겠습니다. 😂)

 

🌈 개요

• Spring과 MyBatis에서 쿼리 결과와 객체의 매핑이 이루어지는 과정에 대해 살펴봅니다.
• 이와 관련하여 어떠한 방식으로 매핑을 진행하는지, 좋은 방법이 무엇인지 등에 대해 살펴보겠습니다.

 

🔖 결론

포스팅이 꽤나 장문이기에,, 매핑 과정에 대해 결론부터 말씀드리면 다음과 같습니다.

• 기본 생성자(NoArgs)만 존재할 경우, 쿼리 결과와 객체의 매핑이 정상적으로 진행되지 않습니다. 정확하게는 null로 매핑이 됩니다.
• 기본 생성자(NoArgs)와 컬럼 별칭(Alias)가 존재할 경우 매핑이 정상적으로 됩니다.
• 모든 필드에 대한 생성자(AllArgs)가 존재하면 별칭이 없더라도 매핑이 정상적으로 됩니다.
  • 단, 객체의 필드와 컬럼의 데이터 순서가 일치해야 합니다.
• 기본 생성자와 모든 필드에 대한 생성자가 아닌, 일부 필드에 대한 생성자만 존재할 경우, 해당 필드에 대해서만 데이터 매핑이 진행됩니다.
• No Args, All Args가 아닌 여러 개의 생성자가 존재할 경우, 오류가 발생합니다
• 리플렉션으로 인해 객체 클래스에 getter/setter는 필요하지 않습니다.

 

📃 예제 코드

테스트를 위해 Dto, Mapper, xml 등의 코드를 작성합니다.

(테스트를 위해 사용하였기에 테이블명이 나 컬럼, 필드명 등은 임의로 정했습니다 ^^;)

 

TestDto 객체

public class TestDto {
 
    private String id;
    private Long promotionId;
    private Long itemId;
    private String type;
    private String expiredStartDate;
    private String expiredEndDate;
    private String useYn;
 
}

Mapper 인터페이스

// Alias가 설정된 Mapper
@Mapper
public interface AliasMapper {
    List<TestDto> findAll();
}
 
 
// Alias가 설정되지 않은 Mapper
@Mapper
public interface NoAliasMapper {
    List<TestDto> findAll();
}
   

Mapper.xml

-- NoAliasMapper.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.example.mybatisbinding.mapper.NoAliasMapper" >
    <select id="findAll" resultType="TestDto">
        SELECT
            MC_ID
             , P_ID
             , ITEM_ID
             , MC_FG
             , YH_S_YMD
             , YH_E_YMD
             , USE_YN
        FROM
            TEST_TABLE
        WHERE
            MC_ID IN ('5716', '5717') -- 2건의 데이터 존재
    </select>
</mapper>
   
 
-- AliasMapper.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.example.mybatisbinding.mapper.AliasMapper" >
    <select id="findAll" resultType="TestDto">
        SELECT
            MC_ID AS id
             , P_ID AS promotionId
             , ITEM_ID AS itemId
             , MC_FG AS type
             , YH_E_YMD AS expiredEndDate
             , YH_S_YMD AS expiredStartDate
             , USE_YN AS useYn
        FROM
            TEST_TABLE
        WHERE
            MC_ID IN ('5716', '5717') -- 2건의 데이터 존재
    </select>
</mapper>

• AliasMapper.xml 의 경우 TestDto 객체의 필드명과 동일하게 alias 설정을 합니다.
• xml 파일의 resultType에서 패키지 경로를 제외한 클래스명만 작성한 것은 properties(yml) 파일에 아래 설정을 통해 dto 파일이 존재하는 패키지 경로를 명시적으로 선언하면 됩니다.

mybatis.type-aliases-package: com.example.mybatisbinding.dto

 

📌 테스트

생성자 및 alias의 여러 가지 조합을 통해 테스트해 보겠습니다. 

(밑에서 자세히 설명드리겠지만, TestDto 객체에서 getter/setter는 따로 필요하지 않습니다.)

1. 기본 생성자(@NoArgsConstructor)
2. 기본 생성자(@NoArgsConstructor) + 별칭(Alias)
3. 모든 필드를 포함하는 생성자(@AllArgsConstructor)
4. 기본 생성자 + 모든 필드를 포함하는 생성자(@NoArgs + @AllArgs)
5. 여러 개의 생성자가 존재할 경우
6. 일부 필드를 가지는 단 하나의 생성자만 존재할 경우

 

편의를 위해 기본 생성자는 @NoArgs로, 모든 필드를 포함하는 생성자는 @AllArgs로, 별칭은 Alias로 표기하겠습니다.

 

1. 기본 생성자(@NoArgs)

• 객체(TestDto)에 @NoArgs만 존재할 경우, 객체의 매핑이 정상적으로 이루어지지 않습니다.
  • 좀 더 정확하게는 데이터가 null로 매핑이 됩니다. 
  • 예를 들어, 조회 결과가 10건인 경우, 10개의 객체에 대한 모든 데이터가 null로 매핑됩니다.
• Java의 경우, 생성자를 명시하지 않을 경우 자동적으로 디폴트 생성자가 존재하지만, 가독성을 위해 명시적으로 선언해 주었습니다.

@NoArgsConstructor
public class TestDto {
 
    private String id;
    private Long promotionId;
    private Long itemId;
    private String type;
    private String expiredStartDate;
    private String expiredEndDate;
    private String useYn;
}

 

    @DisplayName("기본 생성자만 존재할 경우 바인딩이 정상적으로 이루어지지 않는다.")
    @Test
    void givenNoArgsBinding_isNull() {
        final int expected = 2;
 
        List<TestDto> dtoList = noAliasMapper.findAll();
 
        SoftAssertions.assertSoftly(softly -> {
            softly.assertThat(dtoList).hasSize(expected);
            softly.assertThat(dtoList.get(0)).isNull();
            softly.assertThat(dtoList.get(1)).isNull();
        });
    }

 

2. 기본 생성자(@NoArgs) + 별칭(Alias)

• 1)와는 다르게 기본 생성자와 컬럼 Alias가 존재하는 경우, 조회 결과와 객체 간 데이터 매핑이 정상적으로 진행됩니다.

-- AliasMapper.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.example.mybatisbinding.mapper.AliasMapper" >
    <select id="findAll" resultType="TestDto">
        SELECT
            MC_ID AS id
             , P_ID AS promotionId
             , ITEM_ID AS itemId
             , MC_FG AS type
             , YH_E_YMD AS expiredEndDate
             , YH_S_YMD AS expiredStartDate
             , USE_YN AS useYn
        FROM
            TEST_TABLE
        WHERE
            MC_ID IN ('5716', '5717') -- 2건의 데이터 존재
    </select>
</mapper>

 

    @DisplayName("기본 생성자와 alias이 존재할 경우 바인딩이 정상적으로 이루어진다.")
    @Test
    void givenNoArgsBindingWithAlias_isNotNull() {
        final int expected = 2;
 
        List<TestDto> dtoList = aliasMapper.findAll();
 
        SoftAssertions.assertSoftly(softly -> {
            softly.assertThat(dtoList).hasSize(expected);
            softly.assertThat(dtoList.get(0)).isNotNull();
            softly.assertThat(dtoList.get(1)).isNotNull();
        });
    }

• 참고로 alias의 경우 컬럼의 순서가 중요하지 않기에 별칭(alias)만 객체의 필드명과 동일하다면, 순서는 중요하지 않습니다.

 

3. 모든 필드를 포함하는 생성자(@AllArgs)

• 객체에 모든 필드가 포함된 생성자가 존재할 경우(@AllArgs) 조회 결과와 객체 간 데이터 매핑이 정상적으로 진행됩니다.

@AllArgsConstructor
public class TestDto {
 
    private String id;
    private Long promotionId;
    private Long itemId;
    private String type;
    private String expiredStartDate;
    private String expiredEndDate;
    private String useYn;
}

 

<?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.example.mybatisbinding.mapper.NoAliasMapper" >
    <select id="findAll" resultType="TestDto">
        SELECT
            MC_ID
             , P_ID
             , ITEM_ID
             , MC_FG
             , YH_S_YMD
             , YH_E_YMD
             , USE_YN
        FROM
            TEST_TABLE
        WHERE
            MC_ID IN ('5716', '5717') -- 2건의 데이터 존재
    </select>
</mapper>

• @AllArgs의 경우 컬럼 순서대로 필드와 매핑이 되기에 컬럼과 필드의 순서를 고려해야 합니다.

    @DisplayName("모든 필드의 생성자가 존재할 경우 바인딩이 정상적으로 이루어진다.")
    @Test
    void givenAllArgsBinding_isNotNull() {
        final int expected = 2;
 
        List<TestDto> dtoList = noAliasMapper.findAll();
 
        SoftAssertions.assertSoftly(softly -> {
            softly.assertThat(dtoList).hasSize(expected);
            softly.assertThat(dtoList.get(0)).isNotNull();
            softly.assertThat(dtoList.get(1)).isNotNull();
        });
    }

3-1. 객체의 필드와 컬럼 순서가 다를 경우 → 원하지 않는 결과가 나올 수 있습니다.

<?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.example.mybatisbinding.mapper.NoAliasMapper" >
    <select id="findAll" resultType="TestDto">
        SELECT
            MC_ID
             , P_ID
             , ITEM_ID
             , MC_FG
             , YH_S_YMD
             , USE_YN  -- YH_E_YMD 컬럼과 순서가 바뀜
             , YH_E_YMD
        FROM
            TEST_TABLE
        WHERE
            MC_ID IN ('5716', '5717') -- 2건의 데이터 존재
    </select>
</mapper>  

• USE_YN의 컬럼과 YH_E_YMD 컬럼의 데이터가 바뀌어 객체와 매핑이 되었습니다. 
  • 컬럼의 타입이 다른 경우엔 SQLException 오류가 발생합니다.

 

4. 기본 생성자 + 모든 필드를 포함하는 생성자(@NoArgs + @AllArgs)

• @AllArgs 어노테이션이 존재할 경우, 디폴트 생성자의 여부는 상관없이 매핑이 정상적으로 됩니다.

@NoArgsConstructor
@AllArgsConstructor
public class TestDto {
 
    private String id;
    private Long promotionId;
    private Long itemId;
    private String type;
    private String expiredStartDate;
    private String expiredEndDate;
    private String useYn;
}

@DisplayName("기본 생성자와 모든 필드의 생성자가 존재할 경우 바인딩이 정상적으로 이루어진다.")
@Test
void givenNoArgsAndAllArgs_isNotNull() {
    final int expected = 2;
 
    List<TestDto> dtoList = mapper.findAll();
 
    SoftAssertions.assertSoftly(softly -> {
        softly.assertThat(dtoList).hasSize(expected);
        softly.assertThat(dtoList.get(0)).isNotNull();
        softly.assertThat(dtoList.get(1)).isNotNull();
    });
}

 

5. 여러 개의 생성자가 존재할 경우

여러 개의 생성자가 존재하는 경우 @NoArgs와 @AllArgs가 존재하냐 아니냐에 따라 결과가 달라집니다.

• 기본 생성자는 존재하나 alias가 없을 경우 - null로 매핑
• 기본 생성자가 존재하지 않을 경우 - alias 여부와 상관없이 어떠한 생성자를 선택해야 할지 알 수 없기에 오류 발생

// 기본 생성자와 모든 필드를 가진 생성자가 아닌, 여러 생성자가 존재할 경우 -> Exception 발생
@ToString
public class TestDto {
 
    private String id;
    private Long promotionId;
    private Long itemId;
    private String type;
    private String expiredStartDate;
    private String expiredEndDate;
    private String useYn;
 
    public TestDto(String id) {
        this.id = id;
    }
 
    public TestDto(String id, Long promotionId) {
        this.id = id;
        this.promotionId = promotionId;
    }
}

 

6. 일부 필드를 가지는 단 하나의 생성자만 존재할 경우

• alias 설정이 없는 경우: 생성자에 존재하는 필드만 매핑이 됩니다.
• alias 설정이 존재하는 경우: 모든 필드에 대해 정상적으로 매핑이 됩니다.

@ToString
public class TestDto {
 
    private String id;
    private Long promotionId;
    private Long itemId;
    private String type;
    private String expiredStartDate;
    private String expiredEndDate;
    private String useYn;
 
    public TestDto(String id, Long promotionId) {
        this.id = id;
        this.promotionId = promotionId;
    }
 
}

 

@DisplayName("일부 필드만 가진 생성자가 존재하고, alias 설정이 없을 경우, 일부 필드에 대해서만 매핑이 된다.")
@Test
void givenSomeFieldArgsWithNoAlias_isOnlySomeFieldsBinding() {
    List<TestDto> dtoList = aliasMapper.findAll();
 
    System.out.println(dtoList);
}

 

 

@DisplayName("일부 필드만 가진 생성자가 존재하고, alias 설정이 된 경우, 모든 필드가 매핑된다.")
@Test
void givenSomeFiledWithAlias_isNotNull() {
    List<TestDto> dtoList = aliasMapper.findAll();
 
    System.out.println(dtoList);
 
    SoftAssertions.assertSoftly(softly -> {
        softly.assertThat(dtoList).hasSize(expected);
        softly.assertThat(dtoList.get(0)).isNotNull();
        softly.assertThat(dtoList.get(1)).isNotNull();
    });
}

 

위 테스트를 토대로 정리해 보면 다음과 같은 상황에서는 바인딩이 정상적으로 진행이 됩니다.

• 기본 생성자와 별칭(alias)이 존재하는 경우 (@NoArgs + alias)
• 모든 필드를 가지는 생성자가 존재하는 경우 (@AllArgs)
• 생성자가 여러 개 존재하더라도, 기본 생성자가 존재하고 alias가 설정된 경우

정리해 보면, @AllArgs가 존재하거나 기본 생성자를 포함하여 별칭(Alias)만 객체 필드와 동일하다면, 생성자의 개수와는 상관없이 매핑이 정상적으로 됩니다.

 

개인적인 생각으로 @AllArgs를 통해 사용할 경우 다음과 같은 단점이 존재하기에 @NoArgs + Alias 조합으로 바인딩 하는 게 좋은 방법이 아닐까 생각합니다.
(아래 의견은 팀원분께서 주신 의견입니다. 🙇‍♂️)

• 조회 결과값이 어떤 필드에 매핑되어 있는지 하나하나 비교하지 않으면 파악이 힘들다.
• 추후 컬럼이나 코드의 변경 시 @AllArgs는 컬럼 순서를 신경 써야 하므로 유지 보수 면에서 비용이 더 발생할 수 있다.
• alias를 통해 객체의 필드와 컬럼의 순서가 일치하지 않더라도 어떠한 필드가 매핑되는지 바로 파악할 수 있다.

 

그럼 실제 내부적으론 어떠한 방식으로 조회 결과와 객체가 바인딩이 되는지 살펴보겠습니다.

 

 

✏️ 매핑 과정

getter/setter의 필요성?

위에서 객체 클래스에 getter/setter가 필요 없다고 말씀드렸는데요, 이는 리플렉션을 이용하여 getter/setter가 존재하지 않더라도 설정을 해주기 때문에 가능합니다.

 

Reflector Class

public class Reflector {
...
 
  public Reflector(Class<?> clazz) {
    type = clazz;
    addDefaultConstructor(clazz);
    Method[] classMethods = getClassMethods(clazz);
    addGetMethods(classMethods); // getter 메서드 대상으로 정보 취합
    addSetMethods(classMethods); // setter 메서드 대상으로 정보 취합
    addFields(clazz); // field 대상으로 정보 취합
    readablePropertyNames = getMethods.keySet().toArray(new String[0]);
    writablePropertyNames = setMethods.keySet().toArray(new String[0]);
    for (String propName : readablePropertyNames) {
      caseInsensitivePropertyMap.put(propName.toUpperCase(Locale.ENGLISH), propName); // 대문자 설정
    }
    for (String propName : writablePropertyNames) {
      caseInsensitivePropertyMap.put(propName.toUpperCase(Locale.ENGLISH), propName); // 대문자 설정
    }
  }

TestDto 클래스에는 private 필드만 존재할 뿐 getter와 setter가 따로 존재하지 않는데요, 이는 리플렉션(Reflector)을 이용하여 resultType의 클래스에 대한 필드 정보 및 getter, setter의 매핑 정보를 생성해두기 때문에 따로 필요가 없습니다.

• 위 코드는 Reflector 클래스의 생성자입니다.
• getter와 setter에 대한 메서드가 존재하면, addGetMethods(), addSetMethods() 메서드에서 getter/setter 처리를 먼저 진행합니다.
• 만약 getter, setter 정보가 없다면 addFields() 메서드에서 필드 정보를 토대로 getter/setter를 새로 만들기에 클래스에 getter/setter를 선언해 주지 않아도 문제가 되지 않습니다.
• 또한 컬럼과 필드의 대소문자가 다르더라도 문제가 발생하지 않는데요, 이는 위 코드에서 toUpperCase() 메서드를 호출하여 대문자로 모두 변경해버리기에 대소문자를 구분하지 않습니다.

 

Reflector - addGetMethods(), addSetMethods(), addFields()

public class Reflector {
...
 
    // 메서드를 토대로 getter 설정
    private void addGetMethods(Method[] methods) {
        Map<String, List<Method>> conflictingGetters = new HashMap<>();
        Arrays.stream(methods)
                .filter(m -> m.getParameterTypes().length == 0 && PropertyNamer.isGetter(m.getName()))
                .forEach(m -> addMethodConflict(conflictingGetters, PropertyNamer.methodToProperty(m.getName()), m));
        resolveGetterConflicts(conflictingGetters);
    }
 
...
 
    // 메서드를 토대로 setter 설정
    private void addSetMethods(Method[] methods) {
        Map<String, List<Method>> conflictingSetters = new HashMap<>();
        Arrays.stream(methods)
                .filter(m -> m.getParameterTypes().length == 1 && PropertyNamer.isSetter(m.getName()))
                .forEach(m -> addMethodConflict(conflictingSetters, PropertyNamer.methodToProperty(m.getName()), m));
        resolveSetterConflicts(conflictingSetters);
    }
 
...
 
    // 필드를 토대로 getter/setter 설정
    private void addFields(Class<?> clazz) {
        Field[] fields = clazz.getDeclaredFields();
        for (Field field : fields) {
            if (!setMethods.containsKey(field.getName())) {
                // issue #379 - removed the check for final because JDK 1.5 allows
                // modification of final fields through reflection (JSR-133). (JGB)
                // pr #16 - final static can only be set by the classloader
                int modifiers = field.getModifiers();
                if (!(Modifier.isFinal(modifiers) && Modifier.isStatic(modifiers))) {
                    addSetField(field);
                }
            }
            if (!getMethods.containsKey(field.getName())) {
                addGetField(field);
            }
        }
        if (clazz.getSuperclass() != null) {
            addFields(clazz.getSuperclass());
        }
    }

 

테스트와 마찬가지로 아래 케이스에 대해 매핑되는 과정을 살펴보겠습니다. 😃

1. 기본 생성자(@NoArgsConstructor)
2. 기본 생성자(@NoArgsConstructor) + 별칭(Alias)
3. 모든 필드를 포함하는 생성자(@AllArgsConstructor)
4. 기본 생성자 + 모든 필드를 포함하는 생성자(@NoArgs + @AllArgs)
5. 여러 개의 생성자가 존재할 경우
6. 일부 필드를 가지는 단 하나의 생성자만 존재할 경우

 

1. 기본 생성자만 존재할 때 매핑되는 과정

MyBatis의 Mapper를 통해 데이터를 조회할 때, ResultSetHandler의 구현체인 DefaultResultSetHandler 클래스에서 조회 및 매핑 처리를 진행합니다.

• 위와 같이 DefaultResultSetHandler 클래스의 생성자에서 쿼리 실행과 관련된 여러 설정들을 진행합니다.
  • 캐싱, 데이터베이스 정보, offset, limit, 쿼리 정보, 데이터베이스의 타입 정보, 매핑하려는 객체의 클래스 정보 등의 데이터가 설정됩니다.
• DefaultResultSetHandler 클래스 초기화 후 여러 과정을 거쳐 getRowValue() 메서드를 호출합니다.

 

DefaultResultSetHandler - getRowValue()

• getRowValue() 메서드에서 실제 데이터(Object)를 생성하는 부분은 398라인의 코드입니다.

 

 

DefaultResultSetHandler - createResultObject()

• 기본 생성자가 존재할 경우, 위 사진에서 656라인의 objectFactory.create() 메서드를 호출하여 리턴합니다.

 

DefaultObjectFactory - create()

• 기본 생성자인 경우, 최초 44라인의 create() 메서드를 호출하는데요, constructorArgTypes와 constructorArgs가 null인 상태로 50 라인의 create() 메서드를 호출합니다.
• 그 후 instantiateClass() 메서드에서 생성자 인자와 관련된 값들이 모두 null이기 때문에 62라인의 constructor.newInstance() 메서드를 호출하여 리턴합니다..
  • 결국 생성자의 정보가 아무것도 존재하지 않기 때문에, 객체의 모든 필드가 null인 상태로 리턴이 됩니다.

 

2. 기본 생성자와 alias가 존재할 때

기본 생성자와 alias가 존재하더라도 2. 기본 생성자만 존재할 때와 동일한 이유로 resultObject 데이터는 모두 null로 매핑이 되지만, 이후 처리 과정이 다릅니다.

 

DefaultResultSetHandler - getRowValue()

• 위 코드에서 applyAutomaticMappings() 메서드 내부에서 alias가 존재할 경우 다르게 동작합니다.
• applyAutomaticMappings() 메서드에 의해 컬럼 alias가 적용될 경우 정상적으로 데이터가 매핑이 되는데요, 해당 메서드에서 autoMapping의 작업이 이루어집니다.

 

• 위 사진에서 좌측이 alias가 설정되지 않은 경우이고, 우측이 alias가 설정된 경우입니다. 실제 alias로 인해 컬럼 네임과 TestDto 객체의 필드가 대문자로 동일하게 설정이 되고, 이후 autoMapping 리스트에 컬럼정보를 모두 add 합니다. (541 라인)

 

• 그 후 autoMapping의 리스트를 순회하며 데이터를 조회하고 객체의 매핑이 이루어지는데요, 위와 같은 과정을 통해 alias가 설정된 경우 최초 resultObject는 null이지만 autoMapping을 통해 실제적으로는 쿼리 결과값과 매핑이 됩니다.

 

3, 4. 기본 생성자가 아닌 경우

이러한 케이스는 위의 2. 기본 생성자 혹은 기본 3. 생성자 + alias가 존재할 때와 다르게 처리됩니다.

DefaultResultSetHandler 클래스에서 getRowValue() 메서드를 호출하는 건 동일하지만, 이후 createResultObject() 메서드 호출 시 다르게 동작합니다.

• 위 코드에서 기본 생성자가 존재할 경우 656 라인의 objectFactory.createI() 메서드를 호출하였으나, @AllArgs가 존재할 경우 그 다음의 658 라인인 createByConstructorSignature() 메서드를 호출합니다.

 

DefaultResultSetHandler - createByConstructorSignature()

• 위에서 생성자의 파라미터 타입을 반복하면서 컬럼에 대한 정보 및 쿼리 결과값을 constructorArgType, constructorArgs 변수에 add 합니다.
• 결국 위 메서드도 objectFactory.create() 메서드를 호출하는 건 기본 생성자의 로직과 동일하지만, 차이점은 생성자에 대한 정보가 null이 아닌 상태로 create() 메서드를 호출합니다.

 

DefaultObjectFactory - create()

• 기본 생성자만 존재하는 경우와는 달리, 생성자 인자의 타입과 데이터가 존재하기 때문에 기본 생성자가 존재할 때의 62라인을 호출하는 게 아닌, 74라인을 호출하여 생성자 인자의 데이터를 통해 객체를 생성합니다.

※ 따라서, 일부 필드만 포함하는 생성자가 존재할 경우, 생성자에 존재하는 필드만 데이터 바인딩이 되고, 나머지 필드는 null로 매핑됩니다.

 

 

5. 여러 개의 생성자가 존재할 경우

위 테스트에서 살펴보았던 5) 여러 개의 생성자가 존재할 경우에 대한 분석입니다.

• 위의 경우 DefaultResultSetHandler 클래스의 createByConstructorSignature() 메서드에서 어떠한 생성자를 선택해야 할지 알 수 없기에 Exception 예외가 발생합니다.
  • 모든 필드의 생성자(@AllArgs)가 존재할 땐 위 예외가 발생하지 않는 이유는 위 if문의 allowedConstructorUsingTypeHandlers() 메서드 내부에서 생성자의 필드 갯수가 모든 필드의 갯수를 비교하여 처리하기 때문입니다.

 

6. 일부 필드를 가지는 단 하나의 생성자만 존재할 경우

해당 케이스는 4. 기본 생성자가 아닌 경우 와 동일하게 작동하여 생성자에 존재하는 필드에 대해서만 매핑이 이루어집니다.

 

 

💡 정리

물론 처음부터 끝까지 모든 코드를 살펴본 건 아니지만, 객체의 매핑이 이루어지기까지 다양한 과정을 통해 진행되는 것을 알 수 있었습니다.

쿼리 결과와 객체와 매핑을 할 때 @AllArgs를 사용하여 불필요한 코드(alias)는 없애는 게 좋지 않을까라고 생각했었는데, 팀원분이 말씀해 주신 대로 유지 보수 측면에서는 @NoArgs + alias의 조합을 사용하여 변경 가능성에도 유연하게 가져가는 것이 좋지 않을까 생각합니다.

 

 

📝 참고 문서

• https://mybatis.org/mybatis-3/sqlmap-xml.html
• https://jasper-rabbit.github.io/posts/mybatis-refector/