MyBatis

 

🔸 MyBatis 

• 개발자가 작성한 SQL문 혹은 저장프로시저 결과 값을 자바 오브젝트에 자동매핑하는 서비스
• 수동적인 JDBC 방식의 데이터 처리 작업 코드와는 달리 쿼리결과와 오브젝트 간에 자동매핑을 지원
• 데이터베이스 연동을 위한 자바 ORM 프레임워크 (Object-Relational Mapping)

---

💻 구성요소

1. MapperConfig XML File : MyBatis 동작을 위한 기본적인 설정을 공통으로 정의

2. Mapper XML File : 실행할 SQL문 및 매핑정보를 XML 방식으로 정의

3. Mapper Annotations : 자바 코드 내에서 실행할 SQL문 및 매핑 정보를 어노테이션을 이용해 정의

4. Parameter Object :  SQL 문의 조건절에서 값을 비교하거나 , INSERT , UPDATE 등에 필요한 입력값을 받아오기 위한 오브젝트

5. Result Object :  쿼리 결과를 담아 리턴하기 위한 오브젝트

---

🧩 주요속성

① id

② parameterType

•  SQL 구문실행에 필요한 값을 전달하는 객체의 패키지 경로 , 클래스명 혹은 별칭
• parameterType 으로 가능한 값
  • 기본자료형과 문자열   →  SQL 구문에 치환할 값이 오직 하나밖에 없는경우
  • 자바빈즈 , Map  →  SQL 구문에 치환할 값이 여러개 있는 경우 
                                   Map 을 사용할 경우 parameterType="map"으로 설정해서 사용한다

③ resultType

• 조회 결과 값을 저장하는 객체의 패키지 경로 및 클래스명 혹은 별칭
• 조회결과가 여러개의 행이어도 한 행에 대해서만 고려하면 된다
  • resultType 으로 가능한 값
  • 기본 자료형과 문자열 → 컬럼의 갯수가 1개 일때 , int , long , double , Date , string
  • 자바빈즈 → 컬럼의 갯수가 여러개 일 때  , 조회결과가 가변적이지 않을 때
  • Map → 여러 테이블을 조인한 결과를 저장해야할 때
                  조회결과가 가변적일 때
                  테이블 별로 자바빈즈 정의없이 데이터 값을 조회하고 저장할 때

④ resultMap

• 조회결과의 컬럼명과 자바빈즈의 멤버변수를 매핑시키는 resultMap 을 정의하고
  resultMap에 정의된 resultMap의 아이디를 설정한다
  📌 resultMap 에서는  <association> 과  <collection> 태그를 사용해
        객체 타입 또는 컬렉션 타입의 결과를 매핑 시킬수 있다

 

🕹 여러개의 파라미터 값 전달하기

public interface BookMapper {
 	void insertBook(Book book)	;
	List<Book> getBooksByPrice(@Param("min") int min , @Param("max") int max) ;
}

<insert id="insertBook" parameterType="vo.Book">

<select id="getBooksByPrice" resultType="vo.Book">
select * 
from books
where
 book_price between #{min} and #{max}
</select>

 

---

 

📚 변경사항

IBatis의 Sql MapClient → SqlSession 변경

• SqlSession 인터페이스
  • MyBatis를 사용하기 위한 기본적인 인터페이스로 , SQL문 처리를 위한 메서드를 제공
  • 실행 메서드 , 트랜잭션 제어 메서드 등 포함
  • SqlSessionFactory 클래스를 통해 MyBatis Confiiiguration정보에 해당 , SqlSession 인스턴스 생성

selectList()
selectOne()
insert()
update()
delete() 
commit() 
rollback()

 

• 어노테이션 방식 설정 도입
  • MyBatis는 본래 XML 기반의 프레임워크 , MyBatis 3.X 부터 어노테이션 방식의 설정을 지원
  • Mapper XML File 내 SQL문 및 매핑 정보를 자바코드 내에서 어노테이션으로 그대로 적용 가능

---

🔒 IBatis 와 MyBatis

데이터베이스 연동을 위한 자바 프레임워크

• IBatis ▶ MyBatis 이름 변경
• IBatis에 비해 조금 더 간결하고 유연한 XML 구성을 제공
• MyBatis는 자동매핑 기능을 지원해 편리한 객체 - 데이터베이스 매핑을 제공
• 동적인 SQL 작성 - <if>  <choose>  <when>  <oterwise> 등의 동적 SQL 태그를 사용해 간편하게 작성할 수 있다

 

---

 

🖱 Maven pom.xml 추가 방식

<!-- iBATIS pom.xml -->
<dependency>
    <groupid>org.apache.ibatis</groupid>
   <artifactid>ibatis-sqlmap</artifactid>
   <version>2.3.4.726</version>
</dependency>

<!-- -->

<!-- MyBatis pom.xml -->
<dependency>
    <groupid>org.mybatis</groupid>
   <artifactid>mybatis</artifactid>
   <version>3.4.5</version>
</dependency>

 

🔧 NameSpace

기존 iBatis에서는 <sqlMap namespace = "ibatisDAO">와 같이 사용하였지만,
MyBatis에서는 <mapper namespace = "com.gil.log.MybatisMapper">과 같이 변경되었다.

---

 

🔨 주의

요소 유형 "null"과(와) 연관된 "test" 속성의 값에는 '<' 문자가 포함되지 않아야 한다.

if 태그 안에 ">"  괄호를 인식하지 못하므로 대체식을 사용해야 한다.

<	lt;	<if test="paraName1 lt; 0">
>	gt;	<if test="paraName1 gt; 0">
<=, =<	lte;	<if test="paraName1 lte; 0">
>=, =>	gte;	<if test="paraName1 gte; 0">

 

 

 

---

🧩 개발순서

1. 의존성 라이브러리 추가
2. myBatis 환경설정 파일추가
3. Spring Bean Configuration 파일에 myBatis 관련 객체를 스프링 컨테이너의 빈으로 등록
4. Mapper 인터페이스 추가

 

public interface DepartmentMapper {
	void insertDept(Dept dept);
    void deleteDeptById(int id);
    Dept getDeptById(int id);
    List<Dept> getAllDepts();
}

<mapper namespace = "kr.co.jhta.dao.DepartmentMapper>
    <insert id="insertDept" parameterType="kr.co.hjta.vo.Dept">
        insert into departments
        	(dept_id , dept_name , manager_id , loc_id)
        values
        	(#{id} , #{name} , #{managerId} , #{locID})
    </inssert>
    
    <delete id="deleteDeptById" parameterType="int">
        delete from departments
        where dept_id =  #{value}  
    </delete>
    
    <select id="getDeptByID" parameterType="int" resultType="kr.co.hjta.vo.Dept">
    </select>

    <select id="getAllDepts" resultType="kr.co.hjta.vo.Dept">
    </select>
</mapper>

 

---

⛏ 데이터베이스 엑세스 하기

@Service
public class HrService {

    @Autowired
    private DeptMapper deptMapper;
}

 

 

---

🎮 MyBatis 동적쿼리

 

MyBatis는 <if> , <choose> ~ <when> ~ <otherwise> , <where> , <set> , <foreach> 태그를 사용해
동적 SQL를 작성할 수 있다

• myBatis에서 동적 SQL 작성을 지원하기 위해 제공하는 태그는 JSTL의 태그와 사용법이 비슷하다

 

<if> 

<if test="조건식">
	SQL 구문
</if>
// 제시된 조건식은 true / false 로 판정되는 조건식이다
// 제시된 조건식이 true로 판정되면 태그 내부의 SQL구문이 사용된다

<select id="getBooks" parameterType="dto.Criteria" resultType="vo.Book">
	select *
	from  books
	where book_status = 'sell'
            <if test="title != null">
                book_title = #{title}
            </if>
</select>

getBooks() 메서드가 호출될 때 title 파라미터가 null이 아니라면 
book_title = #{ title } 이라는 조건문이 SQL 쿼리에 추가된다

---

<choose> ~ <when> ~ <otehrwise>

여러 조건문 중 하나를 선택해 SQL 구문을 사용하게 해준다
내부의 <when>태그로 조건을 설정하며 모든 조건이 false 일 경우 사용할 
<otherwise> 태그를 선택적으로 추가할 수 있다.

<choose>
    <when test ="조건식1">
        SQL 구문
    </when>
    <when test = "조건식2>
        SQL 구문
    </when>
    <when test = "조건식3>
        SQL 구문
    </when>
    <otherwise>
        SQL 구문
    <otherwise>
</choose>

// 제시된 여러 조건 중에서 조건식이 true로 판정되는 SQL 구문이 사용되고 
// 제시된 모든 조건식이 false로 판정되면 otherwise의 SQL 구문을 사용

<select id="getBooks" parameterType="dto.Criteria" resyltType="vo.Books">
select *
from  books
where book_status = 'sell'
    <choose>
        <when test="title != null">
            and book_title = #{title}
        </when>
        <when test="author != null" >
            and book_publisher = #{publish}
        </when>
    </choose>
</select<>

 

---

<where>

태그 내부에 <if> <choose> ~ <when> ~ <otherwise> , <foreach> 태그를 사용하는 동적 SQL 구문이 있어야한다

<where>
	동적 SQL구문
</where>

// <where> 태그는 반드시 <if> , <choose> , <otherwise> , <foreach> 태그를 사용하는
// 동적 SQL 구문이 위치 해야한다

 

where 키워드 추가

<select>
select * 
from books
where book_status = 'sell'
    <if test ="title != null">
    	and book_title = #{title}
    </if>
</select>	
// where 태그 사용할 필요가 없다.

 select * from books where book_status = 'sell'

📌  title의 값이 null 이면 and book_title = #{title} 이 추가 되지 않는다

 

<select>
select * 
from book
where
    <if test ="title != null">
        and book_title = #{title}
    </if>
</select>	
// title 값이 null이면 실행되는 SQL은 아래 와 같다

 select * from books where

📌 title의 값이 null 이라면 where 이후 문장이 없어 오류 발생

 

<select>
select * 
from  books
<where>
    <if test ="title != null">
      	and book_title = #{title}
    </if>
</where>
</select>	
// title 값이 null 이면 실행되는 SQL
select * from books

// title 값이 null이 아니면 실행되는 SQL
select * from books where book_title = ?

📌 앞에 보여준것과 같은 쿼리에 <where> 태그를 사용해 title의 값이 null 일 때도 

• title 값이 null이 아닌 경우에는 book_title = #{title} 조건이 추가되어 실행
• title 값이 null인 경우에는 <if> 조건문이 무시되고 전체 결과를 반환하는 기본적인 쿼리가 실행

 <where> 태그를 사용해 조건에 따라 SQL 쿼리를 동적으로 생성할 수 있다.
<where> 태그는 조건이 비어있을 때 WHERE 절을 생성하지 않고,
조건이 존재할 때는 WHERE 절과 조건을 함께 생성한다

and 키워드 제거

<where> 태그는  쿼리문에 where 키워드 바로 뒤에 오는 and 키워드를 제거하는 기능을 수행한다

<select>
select *
from books
where
    <if test ="title != null">
        book_title = #{title}
    </if>
    <if test = "author != null">
        and book_autohr = #{author}
    </if>
    <iftest = "publisher != null">
        and book_publisher = #{publisher}
    </if>
</select>

 

 

title 이 null 
author 이나 publisher가 null 이 아니라면

// title 이 null , author 이나 publisher가 null 이 아니면
select *
from books 
where 
and book_autohr = #{author}

// where 다음에 and가 있어서 오류 발생

 

<where> 태그사용

<select>
select *
from books
	<where>
        <if test ="title != null">
            book_title = #{title}
        </if>
        <if test = "author != null">
            book_autohr = #{author}
        </if>
        <if test = "publisher != null">
            book_publisher = #{publisher}
        </if>
    </where>
</select>

// <where> 태그는 and를 제거한다

select * from books
where
	book_author = #{author}

<where> 태그로 인해 where 뒤에 오는 and 키워드가제거된다

 

---

<SET> 

<SET> 태그는 쿼리에서 동적으로 SET 키워드를 추가하고, 필요없는 콤마(,)를 제거하는 역할을 수행한다

<update>
    update books
    <set>
        <if test ="title != null">
			book_title = #{title},
        </if>
        <if test ="author!= null">
        	book_author = #{author},
        </if>
        <if test ="price != null">
        	book_price = 0 " ,
        </if>
        <if test ="filename!= null">
        	book_filename = #{filename},
        </if>
    </set>
    where book_no = #{no}
</update>

 

 

update books
set
    book_title= #{title},
    book_author = #{author},
    book_price = #{price}
where
	book_no = #{no}

 

EX

1. title이 null이 아닌 경우에는 book_title = #{title}을 SET 절에 추가하고, 
2. author가 null이 아닌 경우에는 author = #{author}을 SET 절에 추가한다
3.설정된 SET 절은 동적으로 생성되며, null인 컬럼은 제외된다.
4. 콤마(,)도 동적으로 처리되어 콤마가 필요하지 않은 경우에는 제외된다

 

---

<foreach> 

<foreach> 태그는 SQL 쿼리에서 반복 처리를 지원하는 태그다
주로 'IN'  연산자와 함께 사용되며, 콜렉션에 대한 반복 처리를 수행할 수 있다.

<foreach item="a" index="b" collection="productNumbers" 
    open="("separator="m" close=") nullable="true">
</foreach>
// 컬렉션에 대한 반복처리를 지원하는 태그
// in 연산자와 주로 사용된다

<delete id="deleteProducts">
delete from products
where product_no
in
<foreach index="index" item ="num" collection="productNumber"
    open="("separator=" , "close =")" >
    #{num}
</delete>

delete 
from products
where product_no 
in (102,104,105)

 

1. collection : 반복대상이 되느 값을 담고있는 프로퍼티명 혹은 파라미터 지정
2. item : collection에서 지정한 배열 혹은 List에서 순서대로 하나씩 추출되는 값을 담을 변수명
3. index : collection에서 지정된 배열 혹은 List를 반복처리 할때 마다 0부터 시작하는 인덱스 값을 담을 변수명을 지정한다 정의만하고 sql 구문에서는 사용하지 않는다
4. open : <foreach> 태그를 반복을 시작하기전에 sql 구문에 출력할 컨텐츠를 지정한다
5. close : <foreach> 태그로 반복이 종료되었을 때 sql 구문에 출력할 컨텐츠를 지정한다
6. separator : #{num}으로 값을 하나씩 출력할 때마다 값을 구분하는 구분문자 지정