MyBatis 入門實戰（一）：環境搭建、配置文件、映射器與測試全流程

MyBatis 入門實戰（一）：環境搭建、配置文件、映射器與測試全流程

1. 依賴準備

• mybatis-3.4.1.jar
• 數據庫驅動（如 sqljdbc4.jar for SQL Server）

2. 核心配置文件 conf.xml

<configuration>
  <properties resource="jdbc.properties"/>
  <environments default="development">
    <environment id="development">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="${driver}"/>
        <property name="url" value="${url}"/>
        <property name="username" value="${username}"/>
        <property name="password" value="${password}"/>
      </dataSource>
    </environment>
  </environments>
  <mappers>
    <mapper resource="userMapper.xml"/>
  </mappers>
</configuration>

3. 外部屬性文件 jdbc.properties

driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
url=jdbc:sqlserver://127.0.0.1;databaseName=test
username=sa
password=123456

4. 映射文件 userMapper.xml

<mapper namespace="hw.com.ser.IUser">
  <select id="queryUsers" resultType="hw.com.pojo.User">
    select * from MS_User
  </select>
  <select id="queryUserById" resultType="hw.com.pojo.User" parameterType="int">
    select * from MS_User where id=#{id}
  </select>
</mapper>

關鍵： namespace 必須等於映射接口全限定名（接口映射模式）。

5. 映射接口 IUser.java

public interface IUser {
    List<User> queryUsers();
    User queryUserById(int id);
}

6. SqlSessionFactory 工具類

public class SqlSessionFactoryUtil {
    private static SqlSessionFactory factory;
    static {
        String resource = "conf.xml";
        InputStream is = Resources.getResourceAsStream(resource);
        factory = new SqlSessionFactoryBuilder().build(is);
    }
    public static SqlSession openSqlSession() {
        return factory.openSession();
    }
}

7. 實體類 User.java

標準 POJO，含所有字段 getter/setter、toString()、無參構造器。

8. 測試類

public class UserTest {
    public static void main(String[] args) {
        try (SqlSession session = SqlSessionFactoryUtil.openSqlSession()) {
            IUser mapper = session.getMapper(IUser.class);
            List<User> users = mapper.queryUsers();
            users.forEach(System.out::println);
        } catch (Exception e) { e.printStackTrace(); }
    }
}

運行輸出用戶列表，驗證環境搭建成功。