致敬MyBatis官方開放文檔讓大家翻譯,不用看書直接看文檔就行了,mybatis的中文文檔還需要完備的地方 簡介 什麼是 MyBatis ? MyBatis 是支持定製化 SQL、存儲過程以及高級映射的優秀的持久層框架。MyBatis 避免了幾乎所有的 JDBC 代碼和手動設置參數以及獲取結果集。 ...
----致敬MyBatis官方開放文檔讓大家翻譯,不用看書直接看文檔就行了,mybatis的中文文檔還需要完備的地方
簡介
什麼是 MyBatis ?
MyBatis 是支持定製化 SQL、存儲過程以及高級映射的優秀的持久層框架。MyBatis 避免了幾乎所有的 JDBC 代碼和手動設置參數以及獲取結果集。MyBatis 可以對配置和原生Map使用簡單的 XML 或註解,將介面和 Java 的 POJOs(Plain Old Java Objects,普通的 Java對象)映射成資料庫中的記錄。
mysql資料庫
CREATE DATABASE mybatis; USE mybatis; CREATE TABLE users( id INT PRIMARY KEY AUTO_INCREMENT, NAME VARCHAR(25), age INT ) INSERT INTO users(NAME,age) VALUES("林彪",26); INSERT INTO users(NAME,age) VALUES("平頭哥",33); INSERT INTO users(NAME,age) VALUES("小明",49); INSERT INTO users(NAME,age) VALUES("二哥",26); INSERT INTO users(NAME,age) VALUES("紋身哥",56); INSERT INTO users(NAME,age) VALUES("大力哥",13); INSERT INTO users(NAME,age) VALUES("大B",23),("小A",45),("李白",32);
XML 定義
結構
User.java
package com.ij34.model; public class User { private int id; private String name; private int age; 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 String toString() { return "User [id=" + id + ", name=" + name + ", age=" + age + "]"; } }View Code
mybatis-config.xml
<?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> <environments default="development"> <environment id="development"> <transactionManager type="JDBC"/> <dataSource type="POOLED"> <property name="driver" value="com.mysql.jdbc.Driver"/> <property name="url" value="jdbc:mysql://localhost:3306/mybatis?seSSL=true"/> <property name="username" value="root"/> <property name="password" value="123456"/> </dataSource> </environment> </environments> <mappers> <mapper resource="com/ij34/mybatis/UserMapper.xml"/> </mappers> </configuration>
UserMapper.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="com.ij34.mybatis.UserMapper"> <select id="selectUser" parameterType="int" resultType="com.ij34.model.User"> select * from users where id = #{id} </select> </mapper>
Test.java
package com.ij34.bean; import java.io.IOException; import java.io.InputStream; 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 com.ij34.model.User; public class Test { public static void main(String[] args) throws IOException { String resource = "com/ij34/mybatis/mybatis-config.xml"; InputStream inputStream = Resources.getResourceAsStream(resource); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); SqlSession session=sqlSessionFactory.openSession(); try { User user=session.selectOne("com.ij34.mybatis.UserMapper.selectUser", 1); //對應於UserMapper.xml選擇id名selectUser
// UserMapper mapper=session.getMapper(UserMapper.class);
// User user=mapper.selectUser(1);
System.out.println(user);
} finally { // TODO: handle finally clause session.close(); } } }
結果
註解定義
下麵
還有另一招來處理,它們的映射的語句可以不需要用 XML 來做,取而代之的是可以使用 Java 註解。
比如,上面的 UserMapper.xml 可被替換如下:
package com.ij34.model; import org.apache.ibatis.annotations.Select; public interface UserMapper { @Select("select * from users where id= #{id}") public User selectUser(int id); }
mybatis-config.xml
<mapper resource="com/ij34/mybatis/UserMapper.xml"/>
替換成
<mapper class="com.ij34.model.UserMapper"/>
Test.java
User user=session.selectOne("com.ij34.mybatis.UserMapper.selectUser", 1);
替換成
UserMapper mapper=session.getMapper(UserMapper.class); User user=mapper.selectUser(1);
第二種方法有很多優勢,首先它不是基於字元串常量的,就會更安全;其次,如果你的 IDE 有代碼補全功能,那麼你可以在有了已映射 SQL 語句的基礎之上利用這個功能。
其他知識
:
命名空間(Namespaces)在之前版本的 MyBatis 中是可選的,容易引起混淆因此是沒有益處的。現在的命名空間則是必須的,目的是希望能比只是簡單的使用更長的完全限定名來區分語句更進一步。
命名解析:為了減少輸入量,MyBatis 對所有的命名配置元素(包括語句,結果映射,緩存等)使用瞭如下的命名解析規則。
SqlSessionFactoryBuilder
這個類可以被實例化、使用和丟棄,一旦創建了 SqlSessionFactory,就不再需要它了。因此 SqlSessionFactoryBuilder 實例的最佳作用域是方法作用域(也就是局部方法變數)。你可以重用 SqlSessionFactoryBuilder 來創建多個 SqlSessionFactory 實例,但是最好還是不要讓其一直存在以保證所有的 XML 解析資源開放給更重要的事情。
SqlSessionFactory
SqlSessionFactory 一旦被創建就應該在應用的運行期間一直存在,沒有任何理由對它進行清除或重建。使用 SqlSessionFactory 的最佳實踐是在應用運行期間不要重覆創建多次,多次重建 SqlSessionFactory 被視為一種代碼“壞味道(bad smell)”。因此 SqlSessionFactory 的最佳作用域是應用作用域。有很多方法可以做到,最簡單的就是使用單例模式或者靜態單例模式。
SqlSession
每個線程都應該有它自己的 SqlSession 實例。SqlSession 的實例不是線程安全的,因此是不能被共用的,所以它的最佳的作用域是請求或方法作用域。絕對不能將 SqlSession 實例的引用放在一個類的靜態域,甚至一個類的實例變數也不行。也絕不能將 SqlSession 實例的引用放在任何類型的管理作用域中,比如 Serlvet 架構中的 HttpSession。如果你現在正在使用一種 Web 框架,要考慮 SqlSession 放在一個和 HTTP 請求對象相似的作用域中。換句話說,每次收到的 HTTP 請求,就可以打開一個 SqlSession,返回一個響應,就關閉它。這個關閉操作是很重要的,你應該把這個關閉操作放到 finally 塊中以確保每次都能執行關閉。
映射器實例(Mapper Instances)
映射器是創建用來綁定映射語句的介面。映射器介面的實例是從 SqlSession 中獲得的。因此從技術層面講,映射器實例的最大作用域是和 SqlSession 相同的,因為它們都是從 SqlSession 里被請求的。儘管如此,映射器實例的最佳作用域是方法作用域。也就是說,映射器實例應該在調用它們的方法中被請求,用過之後即可廢棄。並不需要顯式地關閉映射器實例,儘管在整個請求作用域(request scope)保持映射器實例也不會有什麼問題,但是很快你會發現,像 SqlSession 一樣,在這個作用域上管理太多的資源的話會難於控制。所以要保持簡單,最好把映射器放在方法作用域(method scope)內。