【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語句然後在底層幫你生成該介面的實現類,然後父類引用指向子類例項,就能呼叫子類的方法啦...
額,第一部分就先到這裡,如果我沒有漏掉什麼的話....完。
如有不對請及時指正,感激