스프링 DB 2편 - 데이터 접근 활용 기술 섹션 4 수강

섹션 4. 데이터 접근 기술 - MyBatis 수강 완료!!

MyBatis 소개

MyBatis는 JdbcTemplate보다 더 많은 기능을 제공하는 SQL Mapper이다.
MyBatis는 SQL을 XML에 편리하게 작성할 수 있고, 동적 쿼리를 매우 편리하게 작성할 수 있다는 장점이 있다.

설정의 장단점
JdbcTemplate은 스프링에 내장된 기능이라 별도의 설정없이 사용할 수 있다. 반면 MyBatis는 약간의 설정이 필요하다.

정리
프로젝트에서 동적 쿼리와 복잡한 쿼리가 많다면 MyBatis를 사용하고, 단순한 쿼리들이 많으면 JdbcTemplate을 사용하면 된다. 물론 둘을 함께 사용해도 된다.

설정

• mybatis.type-aliases-package: MyBatis에서 타입 정보를 사용할 때는 패키지 이름을 적어야 하는데, 여기에 명시하면 패키지 이름을 생략할 수 있다.

• mybatis.configuration.map-underscore-to-camel-case: JdbcTemplate의 BeanPropertyRowMapper처럼 언더바를 카멜 케이스로 자동 변경해주는 기능을 활성화한다.

참고 - 관례의 불일치

자바 객체에는 주로 카멜 케이스를 사용하고, 관계형 데이터베이스에서는 주로 스네이크 케이스를 사용한다.
이렇게 관례로 많이 사용하다 보니 map-underscore-to-camel-case 기능을 활성화하면 스네이크 케이스를 카멜 케이스로 자동 변환해준다. 따라서 DB에서 select item_name으로 조회해도 객체의 itemName(setItemName()) 속성에 값이 정상 입력된다.
해당 옵션을 켜면 스네이크 케이스는 자동으로 해결되고, 컬럼 이름과 객체 이름이 완전히 다른 경우에는 조회 SQL에서 별칭(as)을 사용하면 된다.

---

<insert id="save" useGeneratedKeys="true" keyProperty="id">
	insert into item (item_name, price, quantity)
	values (#{itemName}, #{price}, #{quantity})
</insert>

• InsertSQL은 <insert>를 사용하면 된다.
• 파라미터는 #{} 문법을 사용하면 된다. 그리고 매퍼에서 넘긴 객체의 프로퍼티 이름을 적어주면 된다.
• #{} 문법을 사용하면 PreparedStatement를 사용한다. JDBC의 ?를 치환한다고 생각하면 된다.
  
  

void update(@Param("id") Long id, @Param("updateParam") ItemUpdateDto updateParam);

<update id="update">
	update item
	set item_name=#{updateParam.itemName},
	price=#{updateParam.price},
	quantity=#{updateParam.quantity}
	where id = #{id}
</update>

• UpdateSQL은 <update>를 사용하면 된다.
• 파라미터가 1개만 있으면 @Param을 지정하지 않아도 되지만, 파라미터가 2개 이상이면 @Param으로 이름을 지정해서 파라미터를 구분해야 한다.
  
  

<select id="findById" resultType="Item">
	select id, item_name, price, quantity
	from item
	where id = #{id}
</select>

• Select SQL은 <select>를 사용하면 된다.
• resultType은 반환 타입을 명시하면 된다. 여기서는 결과를 Item 객체에 매핑한다. SELECT SQL의 결과를 편리하게 바로 객체로 변환해준다.
• 자바 코드에서 반환 객체가 하나면 Item, Optional<Item>과 같이 사용하면 되고, 반환 객체가 하나 이상이면 컬렉션을 사용하면 된다. 주로 List를 사용한다.
  
  

<select id="findAll" resultType="Item">
	select id, item_name, price, quantity
	from item
	<where>
		<if test="itemName != null and itemName != ''">
			and item_name like concat('%',#{itemName},'%')
		</if>
		<if test="maxPrice != null">
			and price &lt;= #{maxPrice}
		</if>
	</where>
</select>

• MyBatis는 <where>, <if> 같은 동적 쿼리 문법을 통해 편리한 동적 쿼리를 지원한다.
• <if>는 해당 조건이 만족하면 구문을 추가한다.
• <where>는 적절하게 where 문장을 만들어준다.
  • 예제에서 <if>가 모두 실패하게 되면 SQL where를 만들지 않는다.
  • 예제에서 <if>가 하나라도 성공하면 처음 나타나는 and를 where로 변환한다.

---

MyBatis 스프링 연동 모듈 설정 원리

1. 애플리케이션 로딩 시점에 MyBatis 스프링 연동 모듈은 @Mapper가 붙은 인터페이스를 조사한다.

2. 해당 인터페이스가 발견되면 동적 프록시 기술을 사용해서 ItemMapper 인터페이스의 구현체를 만든다.

3. 생성된 구현체를 스프링 빈으로 등록한다.

매퍼 구현체

MyBatis 스프링 연동 모듈이 만들어주는 ItemMapper의 구현체 덕분에 인터페이스만으로 편리하게 XML의 데이터를 찾아 호출할 수 있게 됐다.
매퍼 구현체는 예외 변환까지 처리해준다. MyBatis에서 발생한 예외를 스프링 예외 추상화인 DataAccessException에 맞게 변환해서 반환한다.

문자열 대체(String Substitution)

#{} 문법은 ?를 넣고 파라미터를 바인딩하는 PreparedStatement를 사용한다.
파라미터 바인딩이 아니라 문자 그대로를 처리하고 싶을 땐 ${}를 사용하면 된다. 다만 ${}를 사용하면 SQL Injection 공격을 당할 수 있기 때문에 가급적 사용하지 않는 것이 좋다.

재사용 가능한 SQL 조각

<sql>을 사용하면 SQL 코드를 재사용할 수 있다.

<sql id="userColumns"> ${alias}.id,${alias}.username,${alias}.password </sql>

<select id="selectUsers" resultType="map">
	select
		<include refid="userColumns"><property name="alias" value="t1"/></include>,
		<include refid="userColumns"><property name="alias" value="t2"/></include>
	from some_table t1
		cross join some_table t2
</select>

<include>를 통해 <sql> 조각을 찾아서 사용할 수 있다.

Result Maps

결과를 매핑할 때 테이블은 user_id이지만 객체는 id일 때, 컬럼명과 객체의 프로퍼티명이 다르다. 이 때 별칭(as)을 사용하면 된다.
하지만 별칭을 사용하지 않고도 문제를 해결할 수 있는데, 바로 다음과 같이 resultMap을 선언하면 된다.

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

<select id="selectUsers" resultMap="userResultMap">
	select user_id, user_name, hashed_password
	from some_table
	where id = #{id}
</select>

---

인준, 지원이 만나서 토픽 발표 및 토이 프로젝트 관련 회의하기

+) 22. 09. 05. 기록 추가

내가 발표한 내용은 스프링 트랜잭션!! 원래 전에 DB 트랜잭션 발표하고 그 다음에 바로 이어서 스프링 트랜잭션에 대해 발표하려 했으나 내가 스프링에 대해 정말 무지해서... 이번에 인프런 강의로 스프링 트랜잭션에 대해 좀 배운 뒤에 발표하게 됐다.

강의 들으면서 공부했었던 내용으로 진행했다. pages로 만든 간단 발표 자료 보여주면서 전에 짰던 코드도 같이 보여주고. 덕분에 나 혼자 두 시간은 잡아 먹었지만... 그래도 이왕 발표하는 거 트랜잭션에 대해 A to Z 다 알려주고 싶어서! 내용을 좀 길게 짰다.

그래서 그런지 피드백도 좋게 받았다! 하지만 내가 생각해도 좀... 루즈해지는 감이 없지않아 있었음. 다음엔 좀 더 나은 발표를 목표로... 루즈해지지 않게 구성을 잘 짜봐야겠다.

인준이가 발표한 내용은 IPv4와 IPv6. 이건 전에 네트워크 IP에 대해 공부했을 때 스쳐지나가듯 배웠던 건데... 오랜만에 다시 배우니 복습하는 느낌이라 좋았다. 근데 사실 서브넷 마스크에 대해선... 아직 잘 이해가 안 감. 발표 듣는 것만으로는 이해가 잘 안 됐다. 내가 직접 공부해봐야 알 듯...

지원이가 발표한 내용은 자바 컴파일 과정. 이건 전에 인준이가 발표했었던 건데 이 주제 역시 오랜만에 들으니 새로웠다. 역시... 선생님답게 핵심만 쏙쏙 알려줘서 좋았음. 간결했지만 들을 건 다 들은 느낌...!

어쨌든 이번 발표는 양이 많아 준비하기 힘들었지만 그래도 그만큼 뿌듯하다. 다들 잘 이해해 준 것 같아 기뻐...

토이 프로젝트 관련 회의로는 주요 기능들이랑, 명세서 어떻게 짤지에 대해 얘기 나눴다. 그리고 스터디룸 시간 다 돼서 저녁 먹으러 감...^^

회의 끝나고 먹은 돈가스인데 좐맛이었다. 치즈가... 짱 부드러워! 맛있었다! 또 먹고 싶다!