mybatis入“坑”第一步

一、導入坐标

要想通過maven建立一個簡單的mybatis項目，首先需要的是要導入相關的坐标。需要導入的坐标如下：

<dependencies>
	<!--mysql驅動坐标-->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.46</version>
    </dependency>
    <!-- mybatis坐标 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.6</version>
    </dependency>
    <!--單元測試坐标-->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
        <scope>test</scope>
    </dependency>
</dependencies>

建立實體類User和在資料庫中插入建立對應的user表。

二、配置mybatis的核心配置檔案mybtis-config.xml

建立mybatis-config.xml的配置檔案，用于配置連接配接資料庫和注冊Mapper.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>
    <properties resource="db.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>

    <!--每一個Mapper.xml都需要在mybatis核心配置檔案中注冊-->
    <mappers>
        <mapper resource="com/wkx/dao/UserMapper.xml"/>
    </mappers>
</configuration>

①properties标簽：可以動态配置屬性。

可以全部在外部進行配置，如下：

<properties resource="db.properties" />

也可以在通過property标簽一部分在外部進行内部配置另一部分在内部進行配置(如下)，增加配置的靈活性。

<properties resource="db.properties">
    <property name="username" value="root"/>
    <property name="password" value="123456"/>
</properties>

②環境配置environments标簽：用于配置資料的環境。可配置多個資料庫環境，但是SqlSessionFactory隻能選擇一個去使用。如下：

<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>
    <environment id="test">
        <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>

可以在不同的環境下切換不同的資料環境，隻需要修改environments标簽中的default屬性對應不同環境下的id屬性，比如development和test不同的環境。

③映射器mappers：定義映射的路徑，告訴mybatis去哪裡找對應的語句。除了上述通過類路徑的資源引用方式，也可以通過其它的方式。比如通過包的形式将映射器接口全部注冊為映射器，如下：

<mappers>
  <package name="com.wkx.dao"/>
</mappers>

問題：Mapper.xml的配置檔案在mybatis核心配置檔案注冊時找不到對應Mapper.xml，是因為maven讀取配置檔案時隻在resources的檔案目錄下尋找，是以需要在pom.xml檔案中配置過濾器。是以pom.xml中應該添加如下代碼：

<!--在build中配置resources,來防止資源導出失敗的原因-->
<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>

        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
    </resources>
</build>

三、建立Mapper.xml

完成mybatis-config.xml配置檔案的建立後，接着需要配置相關的Mapper.xml，進而進行SQL語句的編寫。

<mapper namespace="com.wkx.dao.UserMapper">
    <select id="getUser" resultType="com.wkx.pojo.User">
        select * from user
    </select>

    <!--使用User類作為輸入類型-->
    <update id="updateUser" parameterType="com.wkx.pojo.User">
        update user set name=#{name},pwd=#{pwd} where id=#{id}
    </update>

    <!--map類型(隻需要其中的key對應sql語句中的需要注入的值)-->
    <update id="updateUserMap" parameterType="map">
        update user set name=#{username} where id=#{uid}
    </update>
</mapper>

①namespace命名空間：使用全限定類名對語句進行隔離，以及實作對接口的綁定。

②select、update等标簽中的id屬性對應的是Mapper接口中的方法名。通過id找到對應的方法需要執行的SQL語句。

③使用的Map集合類型對資料的SQL語句進行操作，隻需要将Map集合中key對應SQL語句中的需要注入的值。也就是說SQL注入的值可以不和實體類中屬性一緻。同時，使用Map集合而不是User類作為傳入類型進行傳輸時不需要将User類中所有資料傳輸。

四、編寫工具類

mybatis的使用需要以SqlSessionFactory為核心，使用SqlSessionFactory去生産SqlSession對象。建立一個工具類去生産SqlSession對象，以後使用mybatis便可以從該工具類中拿出SqlSession。

public class MybatisUtils {

    private static SqlSessionFactory sqlSessionFactory;

    // 調用該類執行該靜态子產品中的代碼，擷取SqlSessionFactory
    static {
        try {
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    // 通過該方法可以生産SqlSession對象
    public SqlSession getSqlSession(){
        SqlSession sqlSession = sqlSessionFactory.openSession();
        return sqlSession;
    }
}

五、測試

接着我們就可以利用mybatisUtils工具類生産的SqlSession對象去調用openSession執行對應的Mapper接口，就可以調用接口中的方法去執行對應的SQL語句。

具體測試類如下：

// 查詢所有使用者資訊
@Test
public void queryUserTest(){
    MybatisUtils mybatisUtils = new MybatisUtils();
    // 調用mybatisUtils中的getSqlSession方法擷取SqlSession對象
    SqlSession sqlSession = mybatisUtils.getSqlSession();
    // 執行SqlSession中的getMapper方法，以便後來來執行對應的Mapper接口方法
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);

    // 執行接口方法，配置完成mybatis會調用的對應的SQL語句執行
    List<User> user = mapper.getUser();
    sqlSession.close();
    System.out.println(user);
}

// 使用Map資料類型對資料進行更新
@Test
public void updateUserMap(){
    MybatisUtils mybatisUtils = new MybatisUtils();
    SqlSession sqlSession = mybatisUtils.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);

    Map<String,Object> map = new HashMap<>();

    map.put("username","王三");
    // map.put("password","2334op");
    map.put("uid","3");

    int count = mapper.updateUserMap(map);

    /*增删改的資料庫操作需要送出事務*/
    sqlSession.commit();
    sqlSession.close();
    System.out.println(count);
}

注意：① 增删改的SQL語句操作都需要進行事務的送出。

② SqlSession使用完後要記得關閉。

mybatis入“坑”第一步

一、導入坐标

二、配置mybatis的核心配置檔案mybtis-config.xml

三、建立Mapper.xml

四、編寫工具類

繼續閱讀

MyBatis從入門到精通(一)：MyBatis入門

MyBatis從入門到精通(二)：MyBatis XML方式的基本用法之Select

MyBatis從入門到精通(三)：MyBatis XML方式的基本用法之多表查詢

MyBatis從入門到精通(四)：MyBatis XML方式的基本用法之增删改

MyBatis從入門到精通(五)：MyBatis 注解方式的基本用法

MyBatis從入門到精通(六)：MyBatis動态Sql之if标簽的用法

MyBatis從入門到精通(七)：MyBatis動态Sql之choose,where,set标簽的用法

MyBatis從入門到精通(九)：MyBatis進階結果映射之一對一映射

MyBatis從入門到精通(十二)：使用collection标簽實作嵌套查詢

mybatis源碼解析-日志擴充卡

史上最全SpringBoot整合Mybatis案例

MyBatis(七):MyBatis緩存詳解(一級緩存/二級緩存)

MyBatis(八):MyBatis插件機制詳解

MyBatis(九):MyBatis類型處理器(TypeHandler)詳解

MyBatis(十一):MyBatis架構流程淺析