一、目前最主流的持久層框架爲 Hibernate 與 MyBatis,並且國內公司目前使用 Mybatis 的要比 Hibernate 要多。html
二、Hibernate 學習門檻不低,且精通門檻更高。門檻高在如何設計 O/R 映射,在性能和對象模型之間如何權衡取得平衡,以及怎樣用好 Hibernate 緩存與數據加載策略方面須要經驗和能力都很強才行。java
三、SQL 優化方面,Hibernate 的查詢會將表中的全部字段查詢出來,這一點會有性能消耗。固然,Hibernate 也能夠本身寫 SQL 來指定須要查詢的字段,但這樣就破壞了 Hibernate 開發的間接性。說得更深刻一點,若是有個查詢要關聯多張表,並且咱們要取的只是幾張表中的部分字段。這時用 Hibernate 就會有些力不從心,就算用 Hibernate 的 SQLQuery,後續的維護工做也會很麻煩。mysql
能夠先回顧一下 JDBC 的使用。spring
一、頻繁建立和打開、關閉數據庫鏈接,太消耗資源。sql
二、SQL 語句及參數存在硬編碼,不利於維護。數據庫
三、結果集獲取與封裝複雜,存在硬編碼,不利於維護。apache
MyBatis 本是 apache 的一個開源項目 iBatis,2010 年這個項目由 Apache software foundation 遷移到了 Google code,並更名爲 iBatis。2013 年 11 月遷移到 Github。api
MyBatis 是面向 SQL 的持久層框架,它封裝了 jdbc 訪問數據庫的過程,咱們開發時,只須要專一於 SQL 語句自己的拼裝,其它複雜的過程所有能夠交給 MyBatis 去完成。緩存
更多可參考官方文檔session
一、建立 maven java 工程,引入如下依賴:
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.zze</groupId> <artifactId>mybatis_test1</artifactId> <version>1.0-SNAPSHOT</version> <dependencies> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.7.25</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>1.7.25</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.2.8</version> </dependency> <dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-core</artifactId> <version>2.0-rc1</version> </dependency> <dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-api</artifactId> <version>2.0-rc1</version> </dependency> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency> <dependency> <groupId>javassist</groupId> <artifactId>javassist</artifactId> <version>3.11.0.GA</version> </dependency> <dependency> <groupId>commons-logging</groupId> <artifactId>commons-logging</artifactId> <version>1.1.1</version> </dependency> <dependency> <groupId>cglib</groupId> <artifactId>cglib</artifactId> <version>2.2.2</version> </dependency> <dependency> <groupId>asm</groupId> <artifactId>asm</artifactId> <version>3.3.1</version> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.37</version> </dependency> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.11</version> <scope>test</scope> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.6.1</version> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> </plugins> </build> </project>
二、建立 jdbc 鏈接屬性文件:
jdbc.url=jdbc:mysql://192.168.208.192:3306/test?characterEncoding=utf-8 jdbc.driver=com.mysql.jdbc.Driver jdbc.username=root jdbc.password=root
三、建立與數據庫表對應的 pojo:
package com.zze.mybatis.pojo; import java.util.Date; public class User { private Integer id; private String name; private Integer age; private Date birthday; private String uuid; public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public Integer getAge() { return age; } public void setAge(Integer age) { this.age = age; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Date getBirthday() { return birthday; } public void setBirthday(Date birthday) { this.birthday = birthday; } public String getUuid() { return uuid; } public void setUuid(String uuid) { this.uuid = uuid; } @Override public String toString() { return "User{" + "id=" + id + ", name='" + name + '\'' + ", birthday=" + birthday + '}'; } }
四、建立 pojo 對應映射文件:
<?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="user"> </mapper>
五、建立 MyBatis 核心配置文件:
<?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="jdbc.properties"/> <!-- 和spring整合後 environments配置將廢除--> <environments default="development"> <environment id="development"> <!-- 使用jdbc事務管理--> <transactionManager type="JDBC"/> <!-- 數據庫鏈接池--> <dataSource type="POOLED"> <property name="driver" value="${jdbc.driver}"/> <property name="url" value="${jdbc.url}"/> <property name="username" value="${jdbc.username}"/> <property name="password" value="${jdbc.password}"/> </dataSource> </environment> </environments> <!-- 加載映射文件 --> <mappers> <mapper resource="mybatis/mapper/User.xml"/> </mappers> </configuration>
六、建立 log4j 屬性文件:
log4j.rootLogger = debug,stdout,E ### 輸出信息到控制擡 ### log4j.appender.stdout = org.apache.log4j.ConsoleAppender log4j.appender.stdout.Target = System.out log4j.appender.stdout.layout = org.apache.log4j.PatternLayout log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n ### 輸出DEBUG 級別以上的日誌到=E://logs/error.log ### log4j.appender.D = org.apache.log4j.DailyRollingFileAppender log4j.appender.D.File = E://logs/log.log log4j.appender.D.Append = true log4j.appender.D.Threshold = DEBUG log4j.appender.D.layout = org.apache.log4j.PatternLayout log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n ### 輸出ERROR 級別以上的日誌到=E://logs/error.log ### log4j.appender.E = org.apache.log4j.DailyRollingFileAppender log4j.appender.E.File =E://logs/error.log log4j.appender.E.Append = true log4j.appender.E.Threshold = ERROR log4j.appender.E.layout = org.apache.log4j.PatternLayout log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
一、抽取工具類:
package com.zze.mybatis.util; import org.apache.ibatis.io.Resources; import org.apache.ibatis.session.SqlSession; import org.apache.ibatis.session.SqlSessionFactory; import org.apache.ibatis.session.SqlSessionFactoryBuilder; import java.io.IOException; import java.io.InputStream; public class SqlSessionFactoryUtil { private static SqlSessionFactory sqlSessionFactory; static { // 建立 SqlSessionFactoryBuilder 對象 SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder(); // 建立核心配置文件的輸入流 InputStream resourceAsStream = null; try { resourceAsStream = Resources.getResourceAsStream("mybatis/SqlMapConfig.xml"); } catch (IOException e) { e.printStackTrace(); } // 建立 Session 工廠 sqlSessionFactory = sqlSessionFactoryBuilder.build(resourceAsStream); } /** * 打開一個 Session * * @return SqlSession 實例 */ public static SqlSession openSession() { return sqlSessionFactory.openSession(); } /** * 打開一個 Session * * @param autoCommit 是否自動提交事務 * @return SqlSession 實例 */ public static SqlSession openSession(Boolean autoCommit) { return sqlSessionFactory.openSession(autoCommit); } }
二、修改映射文件:
<?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="user"> <!-- 新增操做 parameterType : 參數類型 selectKey 配置主鍵返回 keyProperty : 主鍵屬性 resultType : 主鍵數據類型 order : 指定 selectKey 什麼時候執行 --> <insert id="add1" parameterType="com.zze.mybatis.pojo.User"> <selectKey keyProperty="id" resultType="int" order="AFTER"> SELECT LAST_INSERT_ID(); </selectKey> INSERT INTO user(name,age,birthday) VALUES(#{name},#{age},#{birthday}); </insert> <!-- 新增操做 useGeneratedKeys : 使用自增 keyProperty : 指定主鍵屬性,與 useGeneratedKeys 搭配使用 用這兩個屬性至關於 add1 中使用 selectKey --> <insert id="add2" parameterType="com.zze.mybatis.pojo.User" useGeneratedKeys="true" keyProperty="id"> INSERT INTO user(name,age,birthday) VALUES(#{name},#{age},#{birthday}); </insert> <!-- 新增操做 在真正執行插入操做以前生成一個 uuid 賦值給指定屬性 --> <insert id="add3" parameterType="com.zze.mybatis.pojo.User"> <selectKey keyProperty="uuid" resultType="string" order="BEFORE"> select UUID(); </selectKey> INSERT INTO user(name,age,birthday,uuid) VALUES(#{name},#{age},#{birthday},#{uuid}); </insert> <!-- 更新操做 --> <update id="update" parameterType="com.zze.mybatis.pojo.User"> UPDATE user SET name=#{name},age=#{age},birthday=#{birthday} WHERE id=#{id}; </update> <!-- 獲取單個對象 --> <select id="getById" parameterType="int" resultType="com.zze.mybatis.pojo.User"> SELECT id,name,age,birthday FROM user where id=#{id}; </select> <!-- 根據名字模糊查詢方式一 #{} 方式至關於 jdbc 的 ? 佔位符方式 當傳入參數爲基礎類型,使用 #{任意變量名},來引用傳入的參數 --> <select id="getByName1" parameterType="string" resultType="com.zze.mybatis.pojo.User"> SELECT id,name,age,birthday FROM user where name like #{name}; </select> <!-- 根據名字模糊查詢方式二 該方式爲字符串拼接 當傳入的參數爲基礎類型時,只可使用 ${value} 來引用傳入參數 當傳入的參數爲 POJO 時,直接使用${屬性名} --> <select id="getByName2" parameterType="string" resultType="com.zze.mybatis.pojo.User"> SELECT id,name,age,birthday FROM user where name like '%${value}%'; </select> <!-- 查詢全部 --> <select id="getAll" resultType="com.zze.mybatis.pojo.User"> SELECT id,name,age,birthday FROM user </select> <!-- 刪除操做 --> <delete id="deleteById" parameterType="int"> DELETE FROM user WHERE id=#{id} </delete> </mapper>
三、編寫測試類測試:
package com.zze.mybatis.test; import com.zze.mybatis.pojo.User; import com.zze.mybatis.util.SqlSessionFactoryUtil; import org.apache.ibatis.session.SqlSession; import org.junit.Test; import java.text.ParseException; import java.text.SimpleDateFormat; import java.util.Date; import java.util.List; public class MyBatisTest { /** * 新增操做 */ @Test public void testAdd() throws Exception { SqlSession sqlSession = SqlSessionFactoryUtil.openSession(true); // 要新增的對象 User user = new User(); user.setName("張三"); user.setAge(19); Date birthday = new SimpleDateFormat("yyyy-MM-dd").parse("1998-1-1"); user.setBirthday(birthday); // 執行新增操做 // 第一個參數爲映射文件中的 sql id // 第二個參數爲要傳入 sql 中的參數 // 返回影響數據條數 // int insert = sqlSession.insert("user.add1", user); // selectKey 方式 // int insert = sqlSession.insert("user.add2", user); // useGeneratedKeys 方式 int insert = sqlSession.insert("user.add3", user); // uuid 方式 System.out.println(user); // 釋放資源 sqlSession.close(); } /** * 更新操做 */ @Test public void testUpdate() throws ParseException { SqlSession sqlSession = SqlSessionFactoryUtil.openSession(true); User user = new User(); user.setId(4); user.setName("李四"); user.setAge(45); user.setBirthday(new SimpleDateFormat("yyyy-MM-dd").parse("1997-4-4")); // 返回影響數據條數 int update = sqlSession.update("user.update", user); sqlSession.close(); } @Test public void testGetById() { SqlSession sqlSession = SqlSessionFactoryUtil.openSession(); User user = (User) sqlSession.selectOne("getById", 4); System.out.println(user); sqlSession.close(); } /** * 模糊查詢方式一 */ @Test public void testGetByName1() { SqlSession sqlSession = SqlSessionFactoryUtil.openSession(); List<User> objects = sqlSession.selectList("user.getByName1", "%三%"); objects.forEach(p -> System.out.println(p)); sqlSession.close(); /* ==> Preparing: SELECT id,name,age,birthday FROM user where name like ? ==> Parameters: %三%(String) */ } /** * 模糊查詢方式二 */ @Test public void testGetByName2() { SqlSession sqlSession = SqlSessionFactoryUtil.openSession(); List<User> users = sqlSession.selectList("user.getByName2", "三"); users.forEach(u -> System.out.println(u)); sqlSession.close(); /* ==> Preparing: SELECT id,name,age,birthday FROM user where name like '%三%' */ } /** * 查詢全部 */ @Test public void testGetAll() { SqlSession sqlSession = SqlSessionFactoryUtil.openSession(); List<Object> users = sqlSession.selectList("getAll"); users.forEach(u -> System.out.println(u)); sqlSession.close(); } /** * 刪除操做 */ @Test public void testDelete(){ SqlSession sqlSession = SqlSessionFactoryUtil.openSession(true); // 返回影響數據條數 int delete = sqlSession.delete("user.deleteById", 3); sqlSession.close(); } }
一、建立映射文件對應接口:
package com.zze.mybatis.mapper; import com.zze.mybatis.pojo.User; import java.util.List; public interface UserMapper { Integer add1(User user); Integer add2(User user); Integer add3(User user); Integer update(User user); User getById(Integer id); List<User> getByName1(String name); List<User> getByName2(String name); List<User> getAll(); Integer deleteById(Integer id); }
二、修改映射文件 namespace 爲對應接口全路徑名:
<?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="com.zze.mybatis.mapper.UserMapper"> <!-- 新增操做 parameterType : 參數類型 selectKey 配置主鍵返回 keyProperty : 主鍵屬性 resultType : 主鍵數據類型 order : 指定 selectKey 什麼時候執行 --> <insert id="add1" parameterType="com.zze.mybatis.pojo.User"> <selectKey keyProperty="id" resultType="int" order="AFTER"> SELECT LAST_INSERT_ID(); </selectKey> INSERT INTO user(name,age,birthday) VALUES(#{name},#{age},#{birthday}); </insert> <!-- 新增操做 useGeneratedKeys : 使用自增 keyProperty : 指定主鍵屬性,與 useGeneratedKeys 搭配使用 用這兩個屬性至關於 add1 中使用 selectKey --> <insert id="add2" parameterType="com.zze.mybatis.pojo.User" useGeneratedKeys="true" keyProperty="id"> INSERT INTO user(name,age,birthday) VALUES(#{name},#{age},#{birthday}); </insert> <!-- 新增操做 在真正執行插入操做以前生成一個 uuid 賦值給指定屬性 --> <insert id="add3" parameterType="com.zze.mybatis.pojo.User"> <selectKey keyProperty="uuid" resultType="string" order="BEFORE"> select UUID(); </selectKey> INSERT INTO user(name,age,birthday,uuid) VALUES(#{name},#{age},#{birthday},#{uuid}); </insert> <!-- 更新操做 --> <update id="update" parameterType="com.zze.mybatis.pojo.User"> UPDATE user SET name=#{name},age=#{age},birthday=#{birthday} WHERE id=#{id}; </update> <!-- 獲取單個對象 --> <select id="getById" parameterType="int" resultType="com.zze.mybatis.pojo.User"> SELECT id,name,age,birthday FROM user where id=#{id}; </select> <!-- 根據名字模糊查詢方式一 #{} 方式至關於 jdbc 的 ? 佔位符方式 當傳入參數爲基礎類型,使用 #{任意變量名},來引用傳入的參數 --> <select id="getByName1" parameterType="string" resultType="com.zze.mybatis.pojo.User"> SELECT id,name,age,birthday FROM user where name like #{name}; </select> <!-- 根據名字模糊查詢方式二 該方式爲字符串拼接 當傳入的參數爲基礎類型時,只可使用 ${value} 來引用傳入參數 當傳入的參數爲 POJO 時,直接使用${屬性名} --> <select id="getByName2" parameterType="string" resultType="com.zze.mybatis.pojo.User"> SELECT id,name,age,birthday FROM user where name like '%${value}%'; </select> <!-- 查詢全部 --> <select id="getAll" resultType="com.zze.mybatis.pojo.User"> SELECT id,name,age,birthday FROM user </select> <!-- 刪除操做 --> <delete id="deleteById" parameterType="int"> DELETE FROM user WHERE id=#{id} </delete> </mapper>
三、測試:
package com.zze.mybatis.test; import com.zze.mybatis.mapper.UserMapper; import com.zze.mybatis.util.SqlSessionFactoryUtil; import org.apache.ibatis.session.SqlSession; import org.junit.Test; public class MyBatisMapperProxyTest { @Test public void test() { SqlSession sqlSession = SqlSessionFactoryUtil.openSession(); UserMapper userMapper = sqlSession.getMapper(UserMapper.class); // userMapper.add1(); // userMapper.add2(); // userMapper.add3(); // userMapper.getByName1(); // userMapper.getByName2(); // userMapper.getById();a // userMapper.deleteById(); // userMapper.update() userMapper.getAll().forEach(u -> System.out.println(u)); } }
這些屬性都是可外部配置且可動態替換的,既能夠在典型的 Java 屬性文件中配置,亦可經過 properties 元素的子元素來傳遞。例如:
<properties resource="jdbc.properties"> <property name="username" value="root"/> <property name="password" value="root"/> </properties>
而後其中的屬性就能夠在整個配置文件中被用來替換須要動態配置的屬性值。好比:
<dataSource type="POOLED"> <property name="driver" value="${driver}"/> <property name="url" value="${url}"/> <property name="username" value="${username}"/> <property name="password" value="${password}"/> </dataSource>
這個例子中的 username 和 password 將會由 properties 元素中設置的相應值來替換。 driver 和 url 屬性將會由 config.properties 文件中對應的值來替換。這樣就爲配置提供了諸多靈活選擇。
類型別名是爲 Java 類型設置一個短的名字。它只和 XML 配置有關,存在的意義僅在於用來減小類徹底限定名的冗餘。例如
<typeAliases> <typeAlias alias="user" type="com.zze.pojo.User"/> <typeAlias alias="customer" type="com.zze.pojo.Customer"/> <typeAlias alias="order" type="com.zze.pojo.Order"/> </typeAliases>
當這樣配置時, user 能夠用在任何使用 com.zze.pojo.User 的地方。
也能夠指定一個包名,MyBatis 會在包名下面搜索須要的 Java Bean,好比:
<typeAliases> <package name="com.zze.pojo"/> </typeAliases>
每個在包 com.zze.pojo 中的 Java Bean,在沒有註解的狀況下,會使用 Bean 的首字母小寫的非限定類名來做爲它的別名。 好比 domain.blog.Author 的別名爲 author;如有註解,則別名爲其註解值。看下面的例子:
@Alias("order") public class Order{ ... }
這是一些爲常見的 Java 類型內建的相應的類型別名。它們都是大小寫不敏感的,須要注意的是由基本類型名稱重複致使的特殊處理。
別名 | 映射的類型 |
---|---|
_byte | byte |
_long | long |
_short | short |
_int | int |
_integer | int |
_double | double |
_float | float |
_boolean | boolean |
string | String |
byte | Byte |
long | Long |
short | Short |
int | Integer |
integer | Integer |
double | Double |
float | Float |
boolean | Boolean |
date | Date |
decimal | BigDecimal |
bigdecimal | BigDecimal |
object | Object |
map | Map |
hashmap | HashMap |
list | List |
arraylist | ArrayList |
collection | Collection |
iterator | Iterator |
咱們要定義 SQL 映射語句,首先咱們須要告訴 MyBatis 到哪裏去找到這些語句。 Java 在自動查找這方面沒有提供一個很好的方法,因此最佳的方式是告訴 MyBatis 到哪裏去找映射文件。你可使用相對於類路徑的資源引用, 或徹底限定資源定位符(包括 file:/// 的 URL),或類名和包名等。例如:
<!-- 使用相對於類路徑的資源引用 --> <mappers> <mapper resource="org/mybatis/builder/AuthorMapper.xml"/> <mapper resource="org/mybatis/builder/BlogMapper.xml"/> <mapper resource="org/mybatis/builder/PostMapper.xml"/> </mappers>
<!-- 使用徹底限定資源定位符(URL) --> <mappers> <mapper url="file:///var/mappers/AuthorMapper.xml"/> <mapper url="file:///var/mappers/BlogMapper.xml"/> <mapper url="file:///var/mappers/PostMapper.xml"/> </mappers>
<!-- 使用映射器接口實現類的徹底限定類名 --> <mappers> <mapper class="org.mybatis.builder.AuthorMapper"/> <mapper class="org.mybatis.builder.BlogMapper"/> <mapper class="org.mybatis.builder.PostMapper"/> </mappers>
<!-- 將包內的映射器接口實現所有註冊爲映射器 --> <mappers> <package name="org.mybatis.builder"/> </mappers>