MyBatis-02：CRUD操作配置解析

標籤

1. select 標籤

• select標籤是mybatis中最常用的標籤之一

• select語句有很多屬性可以詳細配置每一條SQL語句

• • SQL語句返回值型別。【完整的類名或者別名】
  • 傳入SQL語句的引數型別 。【萬能的Map，可以多嘗試使用】
  • 名稱空間中唯一的識別符號
  • 介面中的方法名與對映檔案中的SQL語句ID 一一對應
  • id
  • parameterType
  • resultType

• 練習1：根據 id 查詢使用者

• 1.在 UserMapper 中新增對應方法

• public interface UserMapper {
     //查詢全部使用者
     List<User> selectUser();
     //根據id查詢使用者
     User selectUserById(int id);
  }
   
  

• 2.在UserMapper.xml中新增 select語句

• <select id="selectUserById" resultType="com.anti.pojo.User">
  	select * from user where id = #{id}
  </select>
  

• 3.在測試類中測試

• @Test
  public void tsetSelectUserById() {
     SqlSession session = MybatisUtils.getSession();  //獲取SqlSession連線
     UserMapper mapper = session.getMapper(UserMapper.class);
     User user = mapper.selectUserById(1);
     System.out.println(user);
     session.close();
  }
   
  

• 執行結果：

• 練習2：根據 密碼 和名字 查詢使用者

• 方法一：直接在方法中傳遞引數

• 1.在介面方法中的引數前加 @Param 屬性。

• 2.SQL 語句編寫的時候，直接取 @Param 中設定的值即可，不需要到單獨設定引數型別。

• //通過密碼和名字查詢使用者
  User selectUserByNP(@Param("username") String username,@Param("pwd") String pwd);
  
  /*
     <select id="selectUserByNP" resultType="com.kuang.pojo.User">
       select * from user where name = #{username} and pwd = #{pwd}
     </select>
  */
   
  

• 方法二：萬能Map

• 1.在介面方法中，引數數直接傳遞Map。

• User selectUserByNP2(Map<String,Object> map);
  

• 2.在編寫SQL語句的時候，需要傳遞引數型別 parameterType="map"

• <select id="selectUserByNP2" parameterType="map" resultType="com.kuang.pojo.User">
  select * from user where name = #{username} and pwd = #{pwd}
  </select>
  

• 3.在使用方法的時候，Map 的 key 為 SQL 中取的值即可。

•     @Test
      public void test03(){
          SqlSession session = MybatisUtils.getSession();
          UserMapper mapper = session.getMapper(UserMapper.class);
          HashMap<String, Object> map = new HashMap<String, Object>();
          map.put("username","張三");
          map.put("pwd","abcdef");
          User user = mapper.selectUserByNP2(map);
          System.out.println(user);
      }
  

• 總結：

• ​ 如果引數過多，我們可以考慮直接使用 Map 實現，如果引數比較少，直接傳遞引數即可。

2. insert 標籤

我們一般使用 insert 標籤進行插入操作，它的配置和 select 標籤差不多.

練習1：增加一個使用者

1.在 UserMapper 介面中新增對應的方法

//新增一個使用者
int addUser(User user);

2、在UserMapper.xml中新增insert語句

<insert id="addUser" parameterType="com.anti.pojo.User">
    insert into user (id,name,pwd) values (#{id},#{name},#{pwd})
</insert>

3.測試

@Test
public void testAddUser() {
   SqlSession session = MybatisUtils.getSession();
   UserMapper mapper = session.getMapper(UserMapper.class);
   User user = new User(5,"王五","zxcvbn");
   int i = mapper.addUser(user);
   System.out.println(i);
   session.commit(); //提交事務,重點!不寫的話不會提交到資料庫
   session.close();
}

注意點：增、刪、改操作需要提交事務！

3. update 標籤

我們一般使用update標籤進行更新操作，它的配置和select標籤差不多。

練習：修改使用者的資訊

1、同理，編寫介面方法

//修改一個使用者
int updateUser(User user);

2、編寫對應的配置檔案SQL

<update id="updateUser" parameterType="com.kuang.pojo.User">
  update user set name=#{name},pwd=#{pwd} where id = #{id}
</update>

3、測試

@Test
public void testUpdateUser() {
   SqlSession session = MybatisUtils.getSession();
   UserMapper mapper = session.getMapper(UserMapper.class);
   User user = mapper.selectUserById(1);
   user.setPwd("asdfgh");
   int i = mapper.updateUser(user);
   System.out.println(i);
   session.commit(); //提交事務,重點!不寫的話不會提交到資料庫
   session.close();
}

4. delete 標籤

需求：根據id刪除一個使用者

1、同理，編寫介面方法

//根據id刪除使用者
int deleteUser(int id);

2、編寫對應的配置檔案SQL

<delete id="deleteUser" parameterType="int">
  delete from user where id = #{id}
</delete>

3、測試

@Test
public void testDeleteUser() {
   SqlSession session = MybatisUtils.getSession();
   UserMapper mapper = session.getMapper(UserMapper.class);
   int i = mapper.deleteUser(5);
   System.out.println(i);
   session.commit(); //提交事務,重點!不寫的話不會提交到資料庫
   session.close();
}

小結：

• 所有的 增、刪、改操作都需要提交事務！
• 所有的普通引數，儘量都寫上 @Param 引數，尤其是多個引數時，必須寫上！
• 有時候根據業務的需求，可以考慮使用 map 傳遞引數！
• 為了規範操作， 在 SQL 的配置檔案中，我們儘量將 parameterType 和 resultType 都寫上！

5.模糊查詢

第1種（推薦）：在 Java程式碼中新增 SQL萬用字元。

String name = "%朱%";
List<User> users = mapper.selectLikeUser(name);

<select id="selectLikeUser">
	select * from user where name like #{name}
</select>

第2種（不推薦）：在 SQL 語句中拼接萬用字元，會引起 SQL 注入。

String name = "朱";
List<User> users = mapper.selectLikeUser(name);

<select id="selectLikeUser">
	select * from user where name like "%" #{name} "%"
</select>

配置解析

1. mybatis-config.xml - 核心配置檔案

• MyBatis 的配置檔案包含了會深深影響 MyBatis 行為的設定和屬性資訊。
• 能配置的內容如下：

configuration（配置）
properties（屬性）
settings（設定）
typeAliases（類型別名）
typeHandlers（型別處理器）
objectFactory（物件工廠）
plugins（外掛）
environments（環境配置）
environment（環境變數）
transactionManager（事務管理器）
dataSource（資料來源）
databaseIdProvider（資料庫廠商標識）
mappers（對映器）
<!-- 注意元素節點的順序！順序不對會報錯 -->

我們可以閱讀 mybatis-config.xml 上面的dtd的標頭檔案！

2. environments 元素

   <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?useSSL=true&amp;useUnicode=true&amp;characterEncoding=utf8"/>
               <property name="username" value="root"/>
               <property name="password" value="123456"/>
           </dataSource>
       </environment>
   </environments>

• 配置 MyBatis 的多套執行環境，將 SQL 對映到多個不同的資料庫上，必須指定其中一個為預設執行環境（通過default指定）

• 子元素節點：environment

  • dataSource 元素使用標準的 JDBC 資料來源介面來配置 JDBC 連線物件的資源。

  • 資料來源是必須配置的。

  • 有三種內建的資料來源型別

    type="[UNPOOLED|POOLED|JNDI]"）
    

  • UNPOOLED：這個資料來源的實現只是每次被請求時開啟和關閉連線。

  • POOLED：這種資料來源的實現利用“池”的概念將 JDBC 連線物件組織起來 , 這是一種使得併發 Web 應用快速響應請求的流行處理方式。

  • JNDI：這個資料來源的實現是為了能在如 Spring 或應用伺服器這類容器中使用，容器可以集中或在外部配置資料來源，然後放置一個 JNDI 上下文的引用。

  • 資料來源也有很多第三方的實現，比如dbcp，c3p0，druid等等....

• 子元素節點：transactionManager - [ 事務管理器 ]

<!-- 語法 -->
<transactionManager type="[ JDBC | MANAGED ]"/>

3. mappers 元素

mappers

• 對映器 : 定義對映SQL語句檔案

• 既然 MyBatis 的行為其他元素已經配置完了，我們現在就要定義 SQL 對映語句了。但是首先我們需要告訴 MyBatis 到哪裡去找到這些語句。Java 在自動查詢這方面沒有提供一個很好的方法，所以最佳的方式是告訴 MyBatis 到哪裡去找對映檔案。你可以使用相對於類路徑的資源引用， 或完全限定資源定位符（包括 file:/// 的 URL），或類名和包名等。對映器是MyBatis中最核心的元件之一，在MyBatis 3之前，只支援xml對映器，即：所有的SQL語句都必須在xml檔案中配置。而從MyBatis 3開始，還支援介面對映器，這種對映器方式允許以Java程式碼的方式註解定義SQL語句，非常簡潔。

<!-- 使用相對於類路徑的資源引用 -->
<mappers>
	<mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>

<!-- 使用完全限定資源定位符（URL） -->
<mappers>
	<mapper url="file:///var/mappers/AuthorMapper.xml"/>
</mappers>

<!--
使用對映器介面實現類的完全限定類名
需要配置檔名稱和介面名稱一致，並且位於同一目錄下
-->
<mappers>
	<mapper class="org.mybatis.builder.AuthorMapper"/>
</mappers>

<!--
將包內的對映器介面實現全部註冊為對映器
但是需要配置檔名稱和介面名稱一致，並且位於同一目錄下
-->
<mappers>
	<package name="org.mybatis.builder"/>
</mappers>

Mapper 檔案

<?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.kuang.mapper.UserMapper">
   
</mapper>

• namespace 中文意思：名稱空間，作用如下：

• • namespace 的命名必須跟某個介面同名
  • 介面中的方法與對映檔案中 sql 語句 id 應該一 一對應
• 1. namespace 和子元素的 id 聯合保證唯一 , 區別不同的mapper
  2. 繫結 DAO 介面
  3. namespace 命名規則 : 包名 + 類名

4.properties優化

資料庫這些屬性都是可外部配置且可動態替換的，既可以在典型的 Java 屬性檔案中配置，亦可通過 properties 元素的子元素來傳遞。具體的請參考官方文件

我們來優化我們的配置檔案

第一步 ; 在resources資源目錄下新建一個 db.properties

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf8&serverTimezone=UTC
username=root
password=123456

第二步 : 將檔案匯入 properties 配置檔案

<configuration>
   <!--匯入properties檔案-->
   <properties resource="db.properties"/>

   <environments default="development">
       <environment id="development">
           <transactionManager type="JDBC"/>
           <dataSource type="POOLED">
               <property name="driver" value="${driver}"/>
               <property name="url" value="${url}"/>
               <property name="username" value="${username}"/>
               <property name="password" value="${password}"/>
           </dataSource>
       </environment>
   </environments>
   <mappers>
       <mapper resource="mapper/UserMapper.xml"/>
   </mappers>
</configuration>

5. typeAliases優化

類型別名是為 Java 型別設定一個短的名字。它只和 XML 配置有關，存在的意義僅在於用來減少類完全限定名的冗餘。

<!--配置別名,注意順序-->
<typeAliases>
   <typeAlias type="com.anti.pojo.User" alias="User"/>
</typeAliases>

當這樣配置時，User 可以用在任何使用 com.kuang.pojo.User 的地方。

也可以指定一個包名，MyBatis 會在包名下面搜尋需要的 Java Bean，比如:

<typeAliases>
   <package name="com.anti.pojo"/>
</typeAliases>

每一個在包 com.anti.pojo 中的 Java Bean，在沒有註解的情況下，會使用 Bean 的首字母小寫的非限定類名來作為它的別名。

若有註解，則別名為其註解值。見下面的例子：

@Alias("user")
public class User {
  ...
}

去官網檢視一下Mybatis預設的一些類型別名: https://mybatis.org/mybatis-3/zh/configuration.html#typeAliases

其他配置瀏覽

1.設定

• 設定（settings）相關 => 檢視幫助文件

• • 懶載入
  • 日誌實現
  • 快取開啟關閉

• 一個配置完整的 settings 元素的示例如下：

  <settings>
   <setting name="cacheEnabled" value="true"/>
   <setting name="lazyLoadingEnabled" value="true"/>
   <setting name="multipleResultSetsEnabled" value="true"/>
   <setting name="useColumnLabel" value="true"/>
   <setting name="useGeneratedKeys" value="false"/>
   <setting name="autoMappingBehavior" value="PARTIAL"/>
   <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
   <setting name="defaultExecutorType" value="SIMPLE"/>
   <setting name="defaultStatementTimeout" value="25"/>
   <setting name="defaultFetchSize" value="100"/>
   <setting name="safeRowBoundsEnabled" value="false"/>
   <setting name="mapUnderscoreToCamelCase" value="false"/>
   <setting name="localCacheScope" value="SESSION"/>
   <setting name="jdbcTypeForNull" value="OTHER"/>
   <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
  </settings>
  

2.型別處理器

• 無論是 MyBatis 在預處理語句（PreparedStatement）中設定一個引數時，還是從結果集中取出一個值時， 都會用型別處理器將獲取的值以合適的方式轉換成 Java 型別。
• 你可以重寫型別處理器或建立你自己的型別處理器來處理不支援的或非標準的型別。【瞭解即可】

3.物件工廠

• MyBatis 每次建立結果物件的新例項時，它都會使用一個物件工廠（ObjectFactory）例項來完成。
• 預設的物件工廠需要做的僅僅是例項化目標類，要麼通過預設構造方法，要麼在引數對映存在的時候通過有參構造方法來例項化。
• 如果想覆蓋物件工廠的預設行為，則可以通過建立自己的物件工廠來實現。【瞭解即可】

生命週期和作用域

理解我們目前已經討論過的不同作用域和生命週期類是至關重要的，因為錯誤的使用會導致非常嚴重的併發問題。

我們可以先畫一個流程圖，分析一下Mybatis的執行過程！

1.作用域理解

• SqlSessionFactoryBuilder 的作用在於建立 SqlSessionFactory，建立成功後，SqlSessionFactoryBuilder 就失去了作用，所以它只能存在於建立 SqlSessionFactory 的方法中，而不要讓其長期存在。因此 SqlSessionFactoryBuilder 例項的最佳作用域是方法作用域（也就是區域性方法變數）。
• SqlSessionFactory 可以被認為是一個數據庫連線池，它的作用是建立 SqlSession 介面物件。因為 MyBatis 的本質就是 Java 對資料庫的操作，所以 SqlSessionFactory 的生命週期存在於整個 MyBatis 的應用之中，所以一旦建立了 SqlSessionFactory，就要長期儲存它，直至不再使用 MyBatis 應用，所以可以認為 SqlSessionFactory 的生命週期就等同於 MyBatis 的應用週期。
• 由於 SqlSessionFactory 是一個對資料庫的連線池，所以它佔據著資料庫的連線資源。如果建立多個 SqlSessionFactory，那麼就存在多個數據庫連線池，這樣不利於對資料庫資源的控制，也會導致資料庫連線資源被消耗光，出現系統宕機等情況，所以儘量避免發生這樣的情況。
• 因此在一般的應用中我們往往希望 SqlSessionFactory 作為一個單例，讓它在應用中被共享。所以說 SqlSessionFactory 的最佳作用域是應用作用域。
• 如果說 SqlSessionFactory 相當於資料庫連線池，那麼 SqlSession 就相當於一個數據庫連線（Connection 物件），你可以在一個事務裡面執行多條 SQL，然後通過它的 commit、rollback 等方法，提交或者回滾事務。所以它應該存活在一個業務請求中，處理完整個請求後，應該關閉這條連線，讓它歸還給 SqlSessionFactory，否則資料庫資源就很快被耗費精光，系統就會癱瘓，所以用 try...catch...finally... 語句來保證其正確關閉。
• 所以 SqlSession 的最佳的作用域是請求或方法作用域。