IDEA+Maven配置MyBatis的初體驗（坑點總結）

起因

在老師的推薦下，我跟着這篇文章https://www.jb51.net/article/70923.htm嘗試MyBatis的初次調試運行。途中困難重重，由於教程中的開發環境是eclipse，項目是普通的javaweb項目，而我的是idea+maven，遇到不少坑，因而在此總結一下。

開發環境

idea2017

mybatis-3.1.1

mysql-connector-java-8.0.12

maven+quickstart

 

創建數據庫和表，針對MySQL數據庫

創建sql語句如下

create database mybatis;
 use mybatis;
 CREATE TABLE users(
    id INT PRIMARY KEY AUTO_INCREMENT,
    NAME VARCHAR(20), 
    age INT);
 INSERT INTO users(NAME, age) VALUES('susi',10);
 INSERT INTO users(NAME, age) VALUES('dang',110);

使用maven創建項目，並導入依賴jar包。

選擇quickstart模板。項目的最終結構應該是這樣的

 

在pom.xml文件的project塊中添加Mysql驅動和MyBatis依賴

 　　  <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
      <dependency>
          <groupId>org.mybatis</groupId>
          <artifactId>mybatis</artifactId>
          <version>3.1.1</version>
      </dependency>

      <!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
      <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.12</version>
      </dependency>

在maven中需要的依賴包大部分都可以在maven主倉庫里找到，地址：https://mvnrepository.com/artifact/mysql/mysql-connector-java/8.0.12

如結構圖，在main下創建resource文件夾，並標識為resources root。

IDEA是不會編譯src的java目錄的xml文件，所以在Mybatis的配置文件中找不到xml文件！（也有可能是Maven構建項目的問題）

因此我們把xml文件都放置在resource下，這樣就不會錯了。

 

在resource下添加Mybatis的配置文件conf.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">

<configuration>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC" />
            <!-- 配置數據庫連接信息 -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver" />  <!-- 這里注意，mysql 8.0開始有了小改變 -->
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?serverTimezone=GMT%2B8" />
                <property name="username" value="root" /> 
                <property name="password" value="mysql7758258" />
            </dataSource>
        </environment>
    </environments>
    
</configuration>

注意driver的值，舊版本是com.mysql.jdbc.Driver，8.0以上的版本則是com.mysql.cj.jdbc.Driver。

 

定義表所對應的實體類

package com.fang.domain;

/**
 * @author fang
 * users表所對應的實體類
 */
public class User {

    //實體類的屬性和表的字段名稱一一對應
    private int id;
    private String name;
    private int age;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    @Override
    public String toString() {
        return "User [id=" + id + ", name=" + name + ", age=" + age + "]";
    }
}

 

在resource下定義操作users表的sql映射文件userMapper.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper .//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!-- 為這個mapper指定一個唯一的namespace，namespace的值習慣上設置成包名+sql映射文件名，這樣就能夠保證namespace的值是唯一的
  例如namespace="me.gacl.mapping.userMapper"就是me.gacl.mapping(包名)+userMapper(userMapper.xml文件去除后綴)-->
<mapper namespace="com.fang.mapping.userMapper">
    <!-- 在select標簽中編寫查詢的SQL語句， 設置select標簽的id屬性為getUser，id屬性值必須是唯一的，不能夠重復
    使用parameterType屬性指明查詢時使用的參數類型，resultType屬性指明查詢返回的結果集類型
    resultType="me.gacl.domain.User"就表示將查詢結果封裝成一個User類的對象返回
   User類就是users表所對應的實體類-->

    <!--根據id查詢得到一個user對象-->
    <select id="getUser" parameterType="int"
            resultType="com.fang.domain.User">
        select * from users where id=#{id}
    </select>

</mapper>

 

在conf.xml文件中注冊userMapper.xml文件

    <mappers>
        <!-- 注冊userMapper.xml文件-->
        <mapper resource="userMapper.xml"></mapper>
    </mappers>

 

編寫測試代碼：執行定義的select語句

package com.fang;

import com.fang.domain.User;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.IOException;
import java.io.InputStream;

/**
 * mybatis
 */
public class App {
    public static void main(String[] args) throws IOException {
        //mybatis的配置文件
        String resource = "conf.xml";
        //使用類加載器加載mybatis的配置文件（它也加載關聯的映射文件）
        InputStream is = App.class.getClassLoader().getResourceAsStream(resource);
        //構建sqlSession的工廠
        SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(is);
        //使用MyBatis提供的Resources類加載mybatis的配置文件（它也加載關聯的映射文件）
        //Reader reader = Resources.getResourceAsReader(resource);
        //構建sqlSession的工廠
        //SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(reader);
        //創建能執行映射文件中sql的sqlSession
        SqlSession session = sessionFactory.openSession();
        /**
         * 映射sql的標識字符串，
         * me.gacl.mapping.userMapper是userMapper.xml文件中mapper標簽的namespace屬性的值，
         * getUser是select標簽的id屬性值，通過select標簽的id屬性值就可以找到要執行的SQL
         */
        String statement = "com.fang.mapping.userMapper.getUser";//映射sql的標識字符串
        //執行查詢返回一個唯一user對象的sql
        User user = session.selectOne(statement,2 );
        System.out.println(user);

    }
}

 

運行結果