JDBC 개발자나 아이바티스 개발자가 마이바티스를 손쉽게 이용할 수 있도록 차근차근 설명하는 세계 최초의 마이바티스 가이드

마이바티스(MyBatis)는 JDBC를 대체하는 자바 퍼시스턴스 프레임워크로 국내에서 가장 인기 있는 퍼시스턴스 프레임워크인 아이바티스(iBatis)가 새로이 업그레이드된 제품이다. 마이바티스는 아이바티스가 가진 간결함에, 아이바티스에 없던 다양한 기능과 개선을 더했다. 이 책은 JDBC를 사용하는 개발자가 쉽게 마이바티스를 사용할 수 있도록 차근차근 설명한다. 그리고 기존에 아이바티스를 사용하던 개발자에게는 마이바티스와의 차이점을 설명해서 쉽게 전환할 수 있도록 지원한다. 따라서 데이터베이스를 다루는 퍼시스턴스 프레임워크를 사용한 적 없는 개발자는 데이터베이스 연동작업을 매우 쉽게 할 수 있으며, 아이바티스를 사용해온 개발자는 처음 아이바티스를 사용할 때 느꼈던 그 간결함이 새로운 느낌으로 다가올 것이다. 이 책에서 다루는 마이바티스 버전은 3.2.1이고 스프링 연동모듈은 1.2.0이다.

이 책의 대상 독자

이 책은 마이바티스를 처음 접하는 사람을 대상으로 내용을 구성했다. 또한 기존에 아이바티스를 사용하다가 마이바티스로 전환하려는 많은 개발자를 위해 아이바티스와 비교하는 내용도 곳곳에 적어뒀다.
자바의 기본 문법을 먼저 설명하고 JDBC를 설명하면 이 책은 굉장히 두꺼워지고 이 책이 전달하고자 하는 핵심을 제대로 전달하기 힘들다. 전달하고 싶은 내용에만 충실하기 위해 독자가 간단한 자바 애플리케이션을 작성해서 자바에 대한 어느 정도의 경험이 있고 데이터베이스 연동을 위한 JDBC 코드를 작성한 경험이 있다고 가정한다. 마이바티스는 내부에서 JDBC API를 사용하기 때문에 JDBC의 스펙을 그대로 가져간다. 이 말은 JDBC API의 제약 사항이 마이바티스에서도 동일하다는 뜻이고, JDBC를 아는 만큼 쉽게 마이바티스를 익힐 수 있다는 말도 된다. 마이바티스가 데이터베이스를 사용하는 프레임워크이므로 데이터베이스에 대한 기본 지식도 반드시 갖고 있어야 한다. 많은 애플리케이션은 데이터베이스에서 select/insert/update/delete만 알아도 대부분의 작업이 가능하다. 그래서 이 책을 보기 위해서는 자바의 기본적인 지식 외에도 데이터베이스에서 데이터를 조작하기 위한 select/insert/update/delete 구문에 대해서 반드시 알아야 한다.


이 책의 구성

프레임워크를 비롯한 대부분의 기술을 습득할 때는 한 번에 모든 내용을 이해하기는 어렵다. 그렇기 때문에 전체를 구성할 수 있는 작은 단위의 주제를 나눠서 각각의 주제별로 이해하게 해야 한다. 각 주제에 대해 일정 수준 이상을 이해하고 나서 전체를 이해하게 하는 게 효과적인 학습 방법이다. 각 주제는 별도의 장으로 나눴으며 순서대로 읽도록 구성했다. 마이바티스가 처음인 독자는 1장부터 순서대로 보면 되고, 마이바티스를 사용해봤거나 조금 알고 있는 독자는 레퍼런스 형태로 필요한 내용을 찾아서 봐도 무방하다.

각 장은 다음과 같이 구성돼 있다.

1장. JDBC 코드의 대안 마이바티스: 마이바티스는 2003년 아이바티스 데이터베이스 레이어로 처음 릴리스(출시)했다. 직후 SQLMaps와 DAO 패키지를 함께 릴리스했다. 국내에는 많은 개발자들이 아이바티스 또는 SQLMaps라는 이름으로 알고 있다. 최근에는 아파치 프로젝트에서 구글 코드로 호스팅을 옮기고, 코드를 새로 작성하면서 마이바티스로 이름을 바꿔 릴리스하고 있다. 1장에서는 데이터베이스 프로그래밍을 할 때 JDBC API를 사용하는 코드에서 불편한 점을 하나씩 살펴보면서 아이바티스와 마이바티스가 만들어진 배경을 간단히 살펴본다. 2.x 버전의 아이바티스와 3.x 버전의 마이바티스에 대해 간단히 비교해보는 것으로 1장을 마무리한다.

2장. 마이바티스 시작: 책 전반에 사용되는 코드를 실제로 돌려볼 수 있도록 개발 환경을 설정한다. 그리고 JDBC 코드를 살펴본다. JDBC에서 데이터베이스 연결을 가져오는 방법을 살펴보고, 마이바티스에서 데이터베이스 연결을 가져오기 위해 설정하는 방법과 마이바티스 API를 살펴본다. 3장에서 데이터를 조회하고 입력, 수정, 삭제하는 방법을 살펴보기에 앞서, 사용할 데이터의 구조를 데이터베이스의 ERD와 자바 모델 클래스를 보면서 파악한다.

3장. 마이바티스 CRUD: 데이터를 조회하고 입력, 수정, 삭제하는 실제 코드를 살펴본다. 먼저 JDBC 코드를 살펴보고 마아비티스 코드로 변환하는 과정을 거친다. 마이바티스 코드를 실행해서 로그를 보면서 마이바티스가 내부에서 JDBC를 활용하는 점도 함께 살펴본다.

4장. 마이바티스 웹 애플리케이션과 활용: 자바에서 데이터베이스를 사용하는 애플리케이션은 대부분 웹 애플리케이션 형태로 작성한다. 2장과 3장에서 간단한 설정과 SQL을 사용했다면 4장에서는 실무에서 사용하는 복잡한 설정과 SQL을 사용한다. 데이터베이스 연결풀과 조인을 사용한 예제를 살펴본다. 마이바티스의 가장 중요한 기능 중 하나인 조인 SQL의 결과 매핑을 살펴본다.

5장. 마이바티스와 스프링 웹 애플리케이션 연동: 스프링은 자바 개발자가 가장 많이 사용하는 프레임워크로서, 전자정부 표준 프레임워크에도 선정돼 있다. 5장에서는 마이바티스의 스프링 연동 모듈을 사용해서 마이바티스와 스프링을 함께 사용하는 방법을 다룬다. 마이바티스와 스프링 연동은 어렵지 않으며 설정 방법과 특이 사항을 주로 다룬다.

6장. 마이바티스 설정 파일: 마이바티스는 다양한 관계형 데이터베이스를 지원하기 위해 많은 옵션을 제공한다. 5장은 마이바티스의 다양한 설정을 다룬다. 보편적으로 사용할 마이바티스 설정은 대부분 4장까지 다룬다. 다만, 마이바티스는 데이터베이스가 제공하는 JDBC 드라이버의 기능에 의존하기 때문에 JDBC 드라이버에 크게 의존하는 설정은 설명에서 제외한다.

7장. 매퍼 XML과 매퍼 인터페이스: 마이바티스는 SQL을 자바 코드에 명시하는 JDBC와 달리 SQL을 코드에서 분리해서 XML에 정의할 수 있다. XML에 정의하는 방법 외에도 자바 코드의 애노테이션에도 명시할 수 있다. SQL을 자바 코드가 아닌 다른 곳에 명시하기 때문에 SQL에서 사용하는 파라미터와 조회 결과를 자바 객체로 변환하는 기능을 제공한다. JDBC에서 객체에 값을 설정하기 위해 모델 클래스의 getter/setter 메소드를 호출하는 번거로움을 덜기 위해 자동으로 getter/setter 메소드를 호출해서 값을 설정해주기도 하고, 별도로 매핑 규칙을 정의할 수도 있다. 7장에서는 파라미터를 매핑하거나 결과 데이터를 자바의 다양한 타입의 객체에 설정하는 방법을 살펴본다.

8장. 동적 SQL: 자바 코드를 사용해서 동적 SQL을 만드는 작업은 빈번하다. 하지만 동적 SQL 처리를 위해 사용하는 분기 처리는 코드의 가독성을 떨어뜨리고 에러 발생 시 원인을 찾기가 어렵다. 마이바티스는 SQL을 별도의 XML이나 애노테이션에 정의하기 때문에 기존 자바 코드를 사용해서 동적 SQL을 만드는 작업과 다를 수밖에 없다. XML에서 동적 SQL을 처리하기 위해 제공하는 엘리먼트를 살펴본다. 그리고 애노테이션에서 동적 SQL을 위해 구문 빌더를 사용하는 방법을 살펴본다.

9장. 마이바티스 제너레이터: 데이터베이스 프로그래밍을 하다 보면 대부분 공통적으로 처리하는 작업이 있다. 테이블에 대응하는 모델 클래스를 만들거나 테이블별로 SQL을 만드는 작업이다. 물론 조인을 적용한 SQL은 데이터에 대한 요구 사항을 정의해야 하기 때문에 자동으로 만들어주는 것은 어렵다. 하지만 테이블별로 모델 클래스와 조회, 입력, 수정, 삭제를 처리하는 SQL은 형태가 대부분 일정한 규칙을 가진다. 마이바티스는 이러한 작업을 자동으로 처리하는 제너레이터를 제공한다. 9장은 제너테이터의 설치 방법과 사용법, 그리고 설정 파일에 대한 세부적인 내용을 살펴본다.

부록 A. 아이바티스에서 마이바티스로 전환: 아이바티스와 마이바티스는 개발자가 동일하고, 마이바티스는 아이바티스의 특징을 대부분 그대로 가져왔다. 아이바티스와 마이바티스는 어느 정도 차이점이 있다. 마이바티스는 아이바티스를 사용해서 작성한 코드를 마이바티스로 전환하기 위해 도구를 제공한다. 그 도구의 사용법과 도구의 제약 사항을 다룬다.

부록 B. 마이바티스 편집기: 마이바티스의 매퍼 XML에 정의한 SQL을 좀더 보기 쉽게 이클립스의 마이바티스 편집기 플러그인이 있다. 마이바티스 편집기의 설치 방법과 사용 방법을 살펴본다.

부록 C. 흔히 발생할 수 있는 에러 유형: 마지막으로 마이바티스를 사용할 때 흔히 볼 수 있는 에러 유형을 정리했다.

이 책에서 다루는 내용

■ JDBC 개발자와 아이바티스 개발자를 위한 단계별 마이바티스 설명
■ 데이터 CRUD를 처리하는 마이바티스 코드와 결과물
■ 스프링 연동모듈을 통한 손쉬운 스프링 연동
■ 다양해진 매핑구문 정의
■ 아이바티스에 비해 훨씬 쉬워진 동적 SQL 처리
■ 소스 자동 생성기인 마이바티스 제너레이터
■ 자바 애플리케이션, 자바 웹, 스프링 연동 웹까지 마이바티스와 관련한 포괄적 설명

이 책의 특징

■ 아이바티스, 마이바티스 공식 한글문서와 『iBatis 인 액션』의 역자가 쓴 세계 최초의 마이바티스 입문서
■ JDBC 코드에서 마이바티스 코드로 자연스럽게 전환하는 과정을 이해하기 쉽도록 설명
■ 개발 효율성을 높일 수 있도록 마이바티스뿐 아니라 마이바티스 제너레이터도 학습
■ 개인 위키(http://ldg.pe.kr/)와 페이스북 페이지(http://facebook.com/mybatis)를 통한 업데이트와 독자 지원