一、mybatis歷史: 額,學習一門新事物時瞭解一下它的歷史能在腦中形成一個大致的輪廓...進入正題... mybatis以前叫做ibatis,ibatis是Apache旗下的產品,在2010年時google將其接管並更名為mybatis。(你可以發現它的包結構還是org.apache.ibati ...
一、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語句然後在底層幫你生成該介面的實現類,然後父類引用指向子類實例,就能調用子類的方法啦...
額,第一部分就先到這裡,如果我沒有漏掉什麼的話....完。
如有不對請及時指正,感激不盡