1. 程式人生 > >【mybatis】1mybatis下載、配置與初步使用

【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語句然後在底層幫你生成該介面的實現類,然後父類引用指向子類例項,就能呼叫子類的方法啦...

額,第一部分就先到這裡,如果我沒有漏掉什麼的話....完。

 

如有不對請及時指正,感激