MyBatis #

MyBatis는 자바 퍼시스턴스 프레임워크의 하나로 XML 서술자나 annotation을 사용하여 저장 프로시저나 SQL 문으로 객체들을 연결한다. MyBatis는 아파치 라이선스 2.0으로 배포되는 자유 소프트웨어이며 iBATIS 3.0의 포크로 iBATIS의 원 개발자들이 포함된 팀에 의해 유지 보수되고 있다. MyBatis는 구성을 위해 간단한 XML 또는 주석을 사용하고 기본 요소, Map 인터페이스 및 Java POJO(Plain Old Java Objects)를 데이터베이스 레코드에 매핑할 수 있다.

Mapped Statements #

Mybatis 의 가장 큰 장점은 매핑된 구문으로, 동일한 기능의 JDBC 코드와 비교하면 약 95% 이상의 코드 수를 감소시키기도 하며 SQL을 작성하는 작업에 집중할 수 있도록 만들어졌다.

• select - 매핑된 SELECT 구문
• insert - 매핑된 INSERT 구문
• update - 매핑된 UPDATE 구문
• delete - 매핑된 DELETE 구문
• sql - 다른 구문에서 재사용하기 위한 SQL 조각
• resultMap - 데이터베이스 결과 데이터를 객체에 불러오는 방법을 정의하는 요소

select #

<select
      id = "selectPerson"
      parameterType = "int"
      parameterMap = "deprecated"
      resultType = "hashmap"
      resultMap = "personResultMap"
      flushCache = "false"
      useCache = "true"
      timeout = "10"
      fetchSize = "256"
      statementType = "PREPARED"
      resultSetType = "FORWARD_ONLY" >

insert, update and delete #

<insert
      id = "insertAuthor"
      parameterType = "domain.blog.Author"
      flushCache = "true"
      statementType = "PREPARED"
      keyProperty = ""
      keyColumn = ""
      useGeneratedKeys = ""
      timeout = "20">

<update
      id = "updateAuthor"
      parameterType = "domain.blog.Author"
      flushCache = "true"
      statementType = "PREPARED"
      timeout = "20">

<delete
      id = "deleteAuthor"
      parameterType = "domain.blog.Author"
      flushCache = "true"
      statementType = "PREPARED"
      timeout = "20">

sql #

<sql id = "userColumns"> id,username,password </sql>

SQL 조각은 다른 구문에 포함할 수 있다.

<select id = "selectUsers" resultType = "map">
    select
    <include refid = "userColumns"></include>
    from some_table t1
    cross join some_table t2
</select>

resultMap #

<resultMap id = "detailedBlogResultMap" type = "Blog">
  <constructor>
    <idArg column = "blog_id" javaType = "int"/>
  </constructor>

  <result property = "title" column = "blog_title"/>

  <association property = "author" javaType = "Author">
    <id     property = "id"       column = "author_id"/>
    <result property = "username" column = "author_username"/>
    <result property = "password" column = "author_password"/>
    <result property = "email"    column = "author_email"/>
    <result property = "bio"      column = "author_bio"/>
  </association>

  <collection property = "posts" ofType = "Post">
    <id     property = "id"      column = "post_id"/>
    <result property = "subject" column = "post_subject"/>

    <discriminator javaType = "int" column = "draft">
      <case value = "1" resultType = "DraftPost"/>
    </discriminator>
  </collection>

</resultMap>

• constructor - 인스턴스 화 되는 클래스의 생성자에 결과를 삽입하기 위해 사용
  • idArg - id가 되는 인자
  • arg - 그 외 일반적인 결과
• id - ID result
• result - 필드 혹은 java bean property에 삽입되는 일반적인 결과
• association - 복잡한 타입의 연관관계 (1:N)
• collection - 복잡한 타입의 컬렉션
• discriminator - 사용할 resultMap을 동적으로 판단
  • case - 몇 가지 값에 기초한 결과 매핑

constructor #

<constructor>
    <idArg column = "blog_id" javaType = "int"/>
</constructor>

id, result #

<id property="id" column="post_id"/>
<result property="subject" column="post_subject"/>

association, collection #

<association property="author" javaType="Author">
  <id property="id" column="author_id"/>
  <result property="username" column="author_username"/>
</association>

<collection property="posts" 
            javaType="ArrayList" 
            column="id" 
            ofType="Post" 
            select="selectPostsForBlog"/>

Reference #

• https://mybatis.org/mybatis-3/sqlmap-xml.html