【mybatis】1mybatis下載、配置與初步使用

一、mybatis歷史：

額，學習一門新事物時了解一下它的歷史能在腦中形成一個大致的輪廓...進入正題...

mybatis以前叫做ibatis，ibatis是Apache旗下的產品，在2010年時google將其接管並更名為mybatis。(你可以發現它的包結構還是org.apache.ibatis)。

二、mybatis介紹：

mybatis運行在三層架構中的Dao層，它的主要功能是簡化jdbc操作，並且能夠降低耦合(sql語句和java代碼分離)，便於維護。mybatis是ORM(Object Ralational Mapping 對象關系映射)的產品。ORM框架將數據庫中的表和JavaBean二者觀念起來。但是，ORM框架只是一個理念，mybatis才是它的實現，比較著名的ORM框架還有hibernate，JPA等。

三、下載及配置：

1、下載

當我們大致了解了mybatis的概念與用處之后，我們就可以開始下載它啦，外網有時候不穩定，建議在中文官網下載，網址：http://www.mybatis.cn/82.html，下載完成你會得到一個壓縮包，將其解壓縮將得到文件結構如下：

 

 

 

 

好的~我們把注意力放在lib目錄和mybatis-3.4.6.jar、mybatis-3.4.6.pdf上面來~其中lib是你在使用mybatis進行開發的過程中，可能會用到的一些jar包，而mybatis-3.4.6.jar是mybatis的核心jar包，剩下的mybatis-3.4.6.pdf很明顯是官方文檔啦~至於剩下的咱們裝作沒看見就好~

2、使用mybatis

好的，當我們下載了mybatis之后，就可以使用它啦~前面雖然說它是一個作用於Dao層的框架，但它的實質是完成數據庫表與JavaBean之間的關聯，所以我們創建一個J2SE項目(普通的Java項目)即可，以eclipse為例就是new->java project，然后選中咱們的src目錄，ctrl+n輸入package，然后創建一個entity包和一個mapper包還有一個test包，額，咱們做測試就不用那么規范了額。其中entity包用於存放實體類，也就是JavaBean(為了防止可能有的童鞋不知道JavaBean是啥，這里簡單交代一下：JavaBean的規范有三，類的訪問權限為public、構造方法的訪問權限為public且必須提供無參構造、所有屬性的訪問權限必須是private，嗯，最重要的是它與表是映射關系)；mapper包用於存放接口和xml文件，具體存放啥接口和啥xml文件先別着急，也別亂想，博主在下文會交代明白；最后的test包用於存放咱們的Test類，嗯，就是做測試的。

建完后的項目結構如圖：然后咱們將剛剛下完的mybatis核心jar包復制粘貼到src目錄下，並右鍵build path->add to build path加入環境~

接下來在src目錄下創建一個xml文件(選中src ctrl+n 輸入xml file)，該xml文件是mybatis的配置文件，其中最核心的配置信息是數據庫的信息(驅動路徑、url、賬號密碼之類的)和需要加載的映射文件路徑(就是上文中提到的mapper包下面的xml文件)，該配置文件的名字可以隨便起，在這里我們就命名為mybatis-config.xml吧！

關於配置文件的文件格式，我們可以查看mybatis的官方文檔——mybatis-3.4.6.pdf。

找到目錄我們先點擊getting started：

然后我們往下翻到第3頁，將這個模板直接復制到mybatis-config.xml文件中去：

ctrl+shift+f整理文件格式之后我們開始配置。

<?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>
    <!-- 指定開發環境,通過default值與id值進行制定，這里我制定的就是mysql數據庫環境 -->
    <environments default="devMysql">
        <!-- 配置開發環境，可以指定多個開發環境 -->
        <environment id="devMysql">
            <!-- 事務提交方式，這里設置JDBC是手動提交，一般都是手動提交哦 -->
            <transactionManager type="JDBC" />
            <!-- 數據源類型，POOLED是使用mybatis默認的數據源，
                也可以選擇UNPOOLED不使用數據源，
                以及JNDI使用tomcat內置數據源，
                不過一般推薦使用POOLED哦
            -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://127.0.0.1:3306/testdb" />
                <property name="username" value="root" />
                <property name="password" value="abc" />
            </dataSource>
        </environment>

        <environment id="devOracle">
            <transactionManager type="JDBC" />
            <dataSource type="POOLED">
                <property name="driver" value="oracle.jdbc.OracleDriver" />
                <property name="url" value="jdbc:oracle:thin:@127.0.0.1:1521:orcl" />
                <property name="username" value="scott" />
                <property name="password" value="abc" />
            </dataSource>
        </environment>
    </environments>
    <mappers>
        
    </mappers>
</configuration>

額，排版好大...咳咳，ok，我們這里配置了兩個開發環境，分別對應於mysql數據庫以及oracle數據庫，我們將對應的數據庫驅動jar包粘貼到src目錄下並add build path加入環境~

接下來，我們在數據庫中創建一個person表，我使用的是mysql數據庫，建表語句如下：

create table person(
id int primary key,
name varchar(30),
age int,
gender int)

 

上文中提到，entity包下存放的是數據庫表對應的實體類，那么是怎么個對應法呢？簡單來說就是表名與JavaBean的類名關聯，表中的字段與JavaBean中的屬性關聯(這個不關聯也可以用別的手段解決，但是最好關聯)，與person表對應的實體類代碼如下：

package pers.tz.mapper;

/**
 * @author tangze
 * @create 2019-10-11 0:07
 */
public class person {
    private int id;
    private String name;
    private int age;
    private int gender;

    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;
    }

    public int getGender() {
        return gender;
    }

    public void setGender(int gender) {
        this.gender = gender;
    }

    public person(int id, String name, int age, int gender) {
        this.id = id;
        this.name = name;
        this.age = age;
        this.gender = gender;
    }

    public person() {
    }

    @Override
    public String toString() {
        return "person{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", age=" + age +
                ", gender=" + gender +
                '}';
    }
}

 

接下來我們就可以開始寫sql語句啦~我們之前說過，mybatis的一個作用在於解耦合，它將sql語句以及java代碼分離，在以往，我們的sql語句是以字符串的形式與java語言混雜在一起的，這樣的結構不利於維護，因此，現在咱們寫在一個單獨的文件中，這個文件就是上文中提到的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="命名空間">

</mapper>

上方的代碼就是mapper包下的xml文件的大致結構，一個xml文件與一個表相關聯，負責該表的dml操作，也就是說sql語句都存放於該xml文件中。又由於xml文件與表相關聯，所以我們不妨將該文件命名為personMapper.xml。我們在personMapper.xml中寫入一條sql語句，即插入一個person記錄：

<?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="命名空間">
    <insert id="insertPerson" parameterType="pers.tz.entity.Person">
        insert into person values(#{id},#{name},#{age},#{gender})
    </insert>
</mapper>

id屬性是該標簽的唯一標識符，parameterType屬性是傳入參數的類型，這里接下來傳入的是一個JavaBean，要寫全類名，因為這是insert語句所以使用的是insert節點，與之相應的還有delete update select節點。接下來我們在mybatis-config.xml文件中關聯personMapper.xml文件(我先講步驟，你們也先會用，原理等流程完成之后我會說明)：

<mappers>
        <mapper resource="mapper/personMapper.xml"/>
</mappers>

然后...我們創建一個上文所說的mapper包下的接口，該接口用於與personMapper.xml文件關聯，我們不妨起名為PersonMapper，然后將PersonMapper的全類名復制，作為personMapper.xml映射文件的命名空間...然后在該接口中創建一個insertPerson方法：

<?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="mapper.PersonMapper">
    <insert id="insertPerson" parameterType="pers.tz.entity.Person">
        insert into person values(#{id},#{name},#{age},#{gender})
    </insert>
</mapper>

public interface PersonMapper {
    int insertPerson(Person person);
}

這樣，personMapper.xml和PersonMapper.java就關聯起來了，接口中的方法名對應xml映射文件中的id值，接口中的方法形參對應xml映射文件中的parameterType值，接口的全類名對應xml映射文件中的命名空間。實際上mybatis先通過它的配置文件(即mybatis-config.xml)找到映射文件(即personMapper.xml)，然后通過映射文件找到接口(PersonMapper.java)

走到這里我們的步驟差不多就走完了，就剩下測試類了。那么我們開始整一個測試類，在test包下創建一個類，我創建的是Test類：

public class Test {
    public static void demo1(Person person) throws Exception {
        //讀入mybatis-config.xml文件
        Reader reader = Resources.getResourceAsReader("mybatis-config.xml");
        //工廠模式...嚶嚶嚶說錯了別噴我
        SqlSessionFactory sqlSessionFactory = new     
                SqlSessionFactoryBuilder().build(reader);
        //獲取一個session，你可以將它近似的理解為connection對象
        SqlSession session = sqlSessionFactory.openSession();
        //反射獲取該接口的實現類，mybatis幫你生成的實現類
        PersonMapper mapper = session.getMapper(PersonMapper.class);
        int count = mapper.insertPerson(person);
        //手動提交
        session.commit();
    }
    public static void main(String[] args) {
        demo1(new Person(1,"張三",17,1));
    }
}

執行完后..你就能看到在你的數據庫表中多出一條記錄啦...

原理

最后來簡單說一下它的原理...它的底層是對映射文件(personMapper.xml)進行解析，從而得到該文件中的sql節點(上文中的insert)，這樣就能得到它的id值，parameterType值，以及其中的sql語句，那么它要得到這些值干嘛呢？看上方我們有這么一行代碼：

PersonMapper mapper = session.getMapper(PersonMapper.class);

這里的mapper對象的類型不知道你發現了沒有，它的類型是一個接口！那么顯然這個對象是該接口的實現類，但是這個實現類我們並沒有寫啊！難道這個對象就是該接口的實例？！這顯然是不合理的，java的接口連構造方法都沒有！那么真相就只有一個，有一個家伙偷偷的幫我們寫了實現類...這個家伙就是mybatis。

實際上，mybatis通過mybatis-config.xml配置文件找到personMapper.xml映射文件，然后通過該映射文件找到對應的接口，mybatis底層會解析這個映射文件，解析sql節點的屬性值和其中的sql語句然后在底層幫你生成該接口的實現類，然后父類引用指向子類實例，就能調用子類的方法啦...

額，第一部分就先到這里，如果我沒有漏掉什么的話....完。

 

如有不對請及時指正，感激不盡