全部章節 >>>>

本章目錄

1.1 初識MyBatis

1.1.1 持久化技術介紹

1.1.2 MyBatis簡介

1.1.2 Mybatis優點

1.1.3 利用Maven添加MyBatis依賴包

1.1.4 實踐練習

1.2 開發一個簡單的MyBatis應用

1.2.1 mybatis核心組態檔

1.2.2 定義物體類

1.2.2 定義介面映射

1.2.3 配置Log4j日志

1.2.4 測驗MyBatis

1.2.5 實踐練習

1.3 MyBatis單表查詢

1.3.1 分析權限控制需求

1.3.2 MyBatis單表查詢實作方法

1.3.3 實踐練習

1.4 無嵌套的MyBatis多表查詢

1.4.1 resultMap和resultType

1.4.2 mapUnderscoreToCamelCase屬性

1.4.3 MyBatis多表查詢實作方法

1.4.4 實踐練習

總結

1.1 初識MyBatis

1.1.1 持久化技術介紹

資料持久化就是將記憶體中的資料模型轉換為存盤模型，以及將存盤模型轉換為記憶體中的資料模型的統稱，

狹義的講就是將記憶體中的資料存盤到資料庫或其他介質的程序，

Dao層將資料存盤到資料庫中

Java如何實作資料持久化？

JDBC編程操作：

• 代碼重復繁瑣、開發效率低

Mybatis、Hibernate等框架技術

• 企業級應用開發
• 支持多種資料庫切換
• 封裝了傳統JDBC提高開發效率
• 插件豐富、安全性高、支持快取等

1.1.2 MyBatis簡介

MyBatis的前身是iBatis，是在2001年發起的一個開源專案，2010年更名為MyBatis，是目前企業級資料庫操作使用最多的框架之一，

MyBatis是一款優秀的支持自定義SQL查詢、存盤程序和高級映射的持久層框架，幾乎封裝所有的JDBC代碼和引數的手動設定以及結果集的檢索，通過XML或注解的方式進行配置映射實作資料庫操作，大大提高了開發效率，

1.1.2 Mybatis優點

MyBatis優勢：

• 易于學習，易于使用，豐富的檔案和源代碼
• 提供了資料映射功能（ORM），消除了繁瑣的JDBC代碼
• 降低了程式和SQL陳述句的耦合
• 提供了連接管理，快取支持，執行緒支持，（分布式）事務管理等

1.1.3 利用Maven添加MyBatis依賴包

在Eclipse中創建一個基本的Maven專案，操作步驟如下：

• 新建Maven專案，點擊Next
• 選擇 Create a simple project
• 輸入專案包名、工程名、版本資訊
• 點擊Finish完成構建Maven專案
• 修改專案下maven組態檔pom.xml

• 在pom.xml中添加mybatis依賴支持
• 繼續在pom.xml中添加JUnit、log4j、slf4j和MySQL驅動的依賴
• 右鍵專案在【Maven】中選擇【Update Project...】來更新外部依賴的jar包（此時會先從本地maven配置的倉庫去尋找jar，如果沒有則會上網下載）

查找地址：https://mvnrepository.com/

1.1.4 實踐練習

1.2 開發一個簡單的MyBatis應用

1.2.1 mybatis核心組態檔

要使用Mybatis實作資料庫操作，首先需要在 src/main/resources 目錄下創建mybatis核心組態檔mybatis-config.xml，

別名配置：

<typeAliases>
       <package name="jack.mybatis.simple.model" />
</typeAliases>

專案中物體類包名，配置后mybatis才識別物體類名稱

操作具體表的SQL陳述句映射檔案：

<mappers>
        <mapper resource="jack/mybatis/mapper/CountryMapper.xml"/> 
</mappers>

映射檔案完整路徑

具體資料源配置（可以配置多個，選擇其中一個使用）：

<environments default=“development”>  <!-定義資料源，默認使用第一個-->

<environment id="development"> <!-- 每個environment元素定義的環境id-->
	<dataSource type="UNPOOLED"> <!-- 資料源配置 -->
		<property name="driver" value="com.mysql.jdbc.Driver" />				
        <property name="url" value="jdbc:mysql://localhost:3306/db_mybatis" />			                    
        <property name="username" value="root" />
    	<property name="password" value="abc123" />
	</dataSource>
</environment>
</environments>

1.2.2 定義物體類

MyBatis是一個結果映射框架，創建一個和資料庫表對應的物體類，

在物體類包（jack.mybatis.simple.model）下新建物體類 Country

public class Country {
	private String countrycode;
	private String countryname;
	private Long id;
	// 屬性getter()方法和setter()方法
}

1.2.2 定義介面映射

在src/main/resources下面創建 jack/mybatis/simple/mapper 目錄，該目錄下面創建與物體類Country對應的映射檔案CountryMapper.xml檔案

<!-- 映射器名字空間，即CountryMapper類的全限定名稱 -->
<mapper namespace="jack.mybatis.simple.mapper.CountryMapper">
	<select id="selectAll" resultType="Country">
		select id,countryname,countrycode from country
	</select>
</mapper>

id="selectAll" id和介面方法名對應

resultType="Country" resultType代表回傳的結果型別，和物體類對應

namespace="jack.mybatis.simple.mapper.CountryMapper" mybatis會自動產生該介面

CountryMapper名稱必須是物體類+Mapper組合 <select>標簽對應查詢陳述句，還有insert、update、delete標簽對應

1.2.3 配置Log4j日志

Log4j用于將MyBatis執行程序中的SQL和其他資訊輸出到控制臺：

在src/main/resources中添加log4j.properties組態檔，代碼如下：

#全域配置
log4j.rootLogger=ERROR, stdout
#MyBatis日志配直
log4j.logger.jack.mybatis.simple.mapper=TRACE
#控制臺輸出配置
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

1.2.4 測驗MyBatis

在src/test/java中創建jack.mybatis.simple.mapper包，然后創建CountryMapperTest測驗類，以下為測驗類初始化方法：

1、完成mybatis配置的加載，創建得到SqlSessionFactory

@BeforeClass
public static void init () {
         try {
	Reader reader = Resources.getResourceAsReader("mybatis-config.xml");
	sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
	reader.close();
          } catch (IOException e) {
	e.printStackTrace();
          }
}	

Reader reader = Resources.getResourceAsReader("mybatis-config.xml"); 加載組態檔，創建SqlSessionFactory

2、從SqlSessionFactory物件中獲取SqlSession物件，用于呼叫方法得到資料：

@Test
public void testSelectAll() {
		SqlSession sqlSession = sqlSessionFactory.openSession();
		try {
			List<Country> countryList = sqlSession.selectList("selectAll");
			//呼叫列印資料方法，也可以這里輸出
			printCountryList(countryList);
		} finally {
			// 不要忘記關閉sqlSession
			sqlSession.close();
		}
}

SqlSession sqlSession = sqlSessionFactory.openSession(); 得到SqlSession物件

List<Country> countryList = sqlSession.selectList("selectAll"); 呼叫方法查詢資料 selectAll為xml映射檔案中定義的查詢id

1.2.5 實踐練習

1.3 MyBatis單表查詢

1.3.1 分析權限控制需求

權限控制系統中，一個用戶擁有若干角色，一個角色擁有若干權限，權限就是對某個資源（模塊）的某種操作（增、刪、改、查），這樣就構成了“用戶—角色—權限”的授權模型，

• 用戶表 sys_user
• 角色表 sys_role
• 用戶角色關聯表 sys_user_role
• 權限表 sys_privilege
• 角色權限關聯表 sys_role_privilege

1.3.2 MyBatis單表查詢實作方法

使用MyBatis實作根據用戶id獲取用戶資訊的步驟如下：

1. 創建maven專案，添加mybatis依賴支持

2. 創建物體類包和用戶物體類SysUser.java

package entity;

public class SysRole {
	private long id;
	private String roleName;
	private int enabled;
	private String createBy;
	private String createTime;
	public SysRole() {
		super();
	}
	public SysRole(long id, String roleName, int enabled, String createBy, String createTime) {
		super();
		this.id = id;
		this.roleName = roleName;
		this.enabled = enabled;
		this.createBy = createBy;
		this.createTime = createTime;
	}
	@Override
	public String toString() {
		return "SysRole [id=" + id + ", roleName=" + roleName + ", enabled=" + enabled + ", createBy=" + createBy
				+ ", createTime=" + createTime + "]";
	}
	public long getId() {
		return id;
	}
	public void setId(long id) {
		this.id = id;
	}
	public String getRoleName() {
		return roleName;
	}
	public void setRoleName(String roleName) {
		this.roleName = roleName;
	}
	public int getEnabled() {
		return enabled;
	}
	public void setEnabled(int enabled) {
		this.enabled = enabled;
	}
	public String getCreateBy() {
		return createBy;
	}
	public void setCreateBy(String createBy) {
		this.createBy = createBy;
	}
	public String getCreateTime() {
		return createTime;
	}
	public void setCreateTime(String createTime) {
		this.createTime = createTime;
	}
	
}

一般表中int在實際中會使用Integer和Long

byte[]一般對應blob等二進制流型別

創建對物體進行DAO操作的映射器介面

public interface UserMapper {
	// 根據用戶id查詢一個用戶物體
	public SysUser selectById(Long id);
}

id是查詢的引數條件值

這里自己定義了操作的介面，介面中方法無需實作，由mybatis運行時進行實作

在resources對應目錄下定義介面的映射組態檔：UserMapper.xml

<mapper namespace="jack.mybatis.authority.mapper.UserMapper">
<resultMap type="SysUser" id="userMap">
     詳細映射說明
</resultMap>
<select id="selectById" resultMap="userMap">
	select * from sys_user where id = #{id}	 
</select>
</mapper>

如果物體類中屬性名和表列名一致，resultMap="userMap">可以直接寫resultType

id為介面定義傳入的引數名

<resultMap type="SysUser" id="userMap">
	<id property="id" column="id"/>
	<result property="userName" column="user_name"/>
	<result property="userPassword" column="user_password"/>
	<result property="userEmail" column="user_email"/>
	<result property="userInfo" column="user_info"/>
	<result property="headImg" column="head_img" jdbcType="blob"/>
	<result property="createTime" column="create_time" jdbcType="timestamp"/>
</resultMap>

物體類中的屬性名和資料表的列名不對應，運行會直接報錯，需要添加映射說明

配置mybatis-config.xml核心組態檔

<environment id="development"> <!-- 每個environment元素定義的環境id-->
	<dataSource type="UNPOOLED"> <!-- 資料源配置 -->
		<property name=“driver” value=“com.mysql.jdbc.Driver” />
        <property name=“url” value=“jdbc:mysql://localhost:3306/資料庫名" />			
        <property name="username" value="root" />
		<property name="password" value="abc123" />
	</dataSource>
</environment>

<!--加入對介面映射檔案的注冊識別，否則mybatis無法正常運行-->
<mappers>
		<mapper resource="jack/mybatis/authority/mapper/UserMapper.xml" />
</mappers>

一定要將介面映射xml檔案注冊到mybatis核心配置中

測驗實作，關鍵代碼如下：

//加載mybatis組態檔代碼略
//獲取SqlSessionFactory物件
//獲取介面
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 呼叫selectByid方法，查詢id=1的用戶
SysUser user = userMapper.selectById(1L);
printUser(user);

自己定義介面的方式需要獲取介面代理物件

1.3.3 實踐練習

1.4 無嵌套的MyBatis多表查詢

1.4.1 resultMap和resultType

resultType用于定義回傳或者引數的型別，如果回傳的是集合則只需要定義集合中的物體型別即可，如果未在核心配置中指明typeAliases，則需要寫全路徑名，

public List<SysUser> selectUsers();   

resultMap用于定義當查詢的結果欄位和接收的物體類欄位不一致時，進行映射說明，如下：

<resultMap type="SysUser" id="userMap">
	<id property="id" column="id"/>
	<result property="userName" column="user_name"/>
	<result property="userPassword" column="user_password"/>
	<result property="userEmail" column="user_email"/>
</resultMap>

property="userName" 對應物體中屬性名

column="user_name" 對應表中的列名

1.4.2 mapUnderscoreToCamelCase屬性

資料庫中下劃線方式的命名很常見，但是Java中而是使用駝峰式命名，如userName、userEmail等，這樣mybatis在結果回傳和物體類對應時無法直接關聯，需要定義resultMap增加了復雜度，

MyBatis提供了一個全域屬性mapUnderscoreToCamelCase，通過配置該屬性為true可以自動將以下劃線方式命名的資料庫列映射到Java物件的駝峰式命名屬性中，

<settings>
<!—其他配置-->
<!--將以下劃線方式命名的資料庫列映射到Java物件的駝峰式命名屬性中-->
	   <setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>

1.4.3 MyBatis多表查詢實作方法

實際業務中還需要多表關聯查詢，關聯查詢結果的型別也會有多種情況：

情況1：多表查詢結果只包含一個表的資訊 根據用戶id獲取用戶擁有的所有角色，雖然查詢時關聯三個表，但是回傳的結果為角色集合，查詢結果只有角色的資訊，

// 根據用戶id獲取角色資訊
List<SysRole> selectRolesByUserid(Long id);

<!—對應映射xml中的sql和配置-->
<select id="selectRolesByUserid" resultType="SysRole">
select r.id,r.role_name roleName,r.enabled,r.create_by createBy,r.create_time createTime
from sys_role r join sys_user_role ur on r.id=ur.role_id join sys_user u on u.id=ur.user_id 
where u.id=#{userId}
</select>

情況2：多表查詢結果包含多個表的資訊

根據用戶id獲取用戶擁有的所有角色，假設查詢的結果不僅要包含角色資訊，還要包含當前用戶的部分資訊（不考慮嵌套的情況）

• 解決1：在SysRole物件中直接添加userName屬性，這樣仍然使用SysRole作為回傳值

• 解決2：創建一個新類SysRoleExtend繼承SysRole，如下：

public class SysRoleExtend extends SysRole{
             	private String userName;   //添加SysRole中沒有的屬性，而查詢結果中需要包含的
                  …. 其他需要包含的
                  //產生get和set方法
}

將resultType設定為擴展屬性后的SysRoleExtend物件，通過這種方式來接收多余的值，如果需要其他表中大量列的值時，這種方式就不適用了，因為我們不能將一個類的屬性都照搬到另一個類中，

情況3： 使用物件作為成員屬性的方式接收多表資料，需要角色SysRole的資料，還需要SysUser的資料，而SysRole中無法存盤SysUser的資料，所以直接將一個SysUser物件放入SysRole中作為成員屬性，

public class SysRole {
	// 其他原有屬性
	private SysUser user; // 用戶資訊
	...
}

該屬性是一個用戶物件， 可以將查詢的用戶資訊封裝進去

修改UserMapper.xml中selectRolesByUserid的SQL，達到能夠將用戶的資料放入SysUser成員屬性物件中，代碼如下：

<select id="selectRolesByUserid" resultType="SysRole">
select r.id,r.role_name,r.enabled,r.create_by,r.create_time,u.user_name as "user.userName"  from sys_role r join sys_user_role ur on r.id=ur.role_id join sys_user u on u.id=ur.user_id   where u.id=#{userId}
 </select>

紅色的為列的別名，user則對應SysRole物體中的user物體物件名

1.4.4 實踐練習

總結

• MyBatis是一款優秀的支持自定義SQL查詢、存盤程序和高級映射的持久層框架技術，能夠根據配置自動產生操作資料庫的JDBC代碼，從而大大提高了Java資料庫操作的開發效率，
• 使用Mybatis需要添加相關依賴，創建mybatis-config.xml核心組態檔，配置全域屬性、資料源和物體包的別名，并匯入定義SQL陳述句的Mapper.xml，
• 具體操作時需要加載MyBatis相關組態檔，創建SqlSessionFactory，然后獲取SqlSession物件，拿到相關Mapper介面，從而實作呼叫，