MyBatis | Mapper | 基本

Tags:

DBテーブル

test_table

id string number
1 hoge 100
2 fuga 200
3 piyo 300

ソースコード

TestTable.java

package sample.mybatis;

public class TestTable {
    private int id;
    private String string;
    private int number;

    @Override
    public String toString() {
        return "TestTable [id=" + id + ", string=" + string + ", number=" + number + "]";
    }
}

sample_mapper.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="sample.mybatis.TestTableMapper"> <!-- MapperのFQCNをnamespaceにする。 -->

  <select id="selectAll" resultType="sample.mybatis.TestTable">
    select *
      from test_table
  </select>
</mapper>

TestTableMapper.java

package sample.mybatis;

import java.util.List;

// Mapperインターフェース
public interface TestTableMapper {

    // Statement IDと同じ名前のメソッドを定義
    List<TestTable> selectAll();
}

Main.java

package sample.mybatis;

import java.io.InputStream;

import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

public class Main {

    public static void main(String[] args) throws Exception {
        try (InputStream in = Main.class.getResourceAsStream("/mybatis-config.xml")) {
            SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(in);

            try (SqlSession session = factory.openSession()) {
                // Mapperのインスタンスを取得する。
                TestTableMapper mapper = session.getMapper(TestTableMapper.class);

                mapper.selectAll().forEach(System.out::println);
            }
        }
    }
}

実行結果

[DEBUG] s.m.T.selectAll - ==>  Preparing: select * from test_table 
[DEBUG] s.m.T.selectAll - ==> Parameters: 
[DEBUG] s.m.T.selectAll - <==      Total: 3
TestTable [id=1, string=hoge, number=100]
TestTable [id=2, string=fuga, number=200]
TestTable [id=3, string=piyo, number=300]

説明

  • Mapperを使用する場合は、専用インターフェースを定義する(TestTableMapper)。
    • このインターフェースのメソッドと、設定ファイルの各Statementが対応するようにそれぞれを定義する。
    • StatementではnamespaceをインターフェースのFQCNにする(sample.mybatis.TestTableMapper)。
    • Statement IDとインターフェースのメソッド名を一致させる(selectAll)。
    • パラメータが存在する場合は、メソッドに引数を渡すように定義する。
  • MapperインスタンスはSqlSessionのgetMapper()メソッドで取得する。