1. 程式人生 > 實用技巧 >Mybatis 小談 (中篇 Ⅰ)

Mybatis 小談 (中篇 Ⅰ)

寫在前面:分享技術,共同進步,有不足請見諒,相關意見可評論告知 ~

程式設計路漫之遠兮,運架構體之帷幄;
勸君專注案前事,亦是杯酒敬蒼生;

目錄

CRUD

前序

namespace : namespace中的包名要和 Dao/mapper 介面的包名一致,id對應其中的方法。
如圖:

習慣:UserDao.java ---> UserMapper.java

Select

選擇,查詢語句;

  • id : 就是對應的namespace中的方法名;
  • resultType:Sql語句執行的返回值!
  • parameterType : 引數型別!
  1. 編寫介面

    //根據ID查詢使用者
    User getUserById(int id);
    
  2. 編寫對應的mapper中的sql語句

    <select id="getUserById" parameterType="int" resultType="com.kuang.pojo.User">
            select * from mybatis.user where id = #{id}
    </select>
    
    
  3. 測試

        @Test
        public void getUserById() {
            SqlSession sqlSession = MybatisUtils.getSqlSession();
    
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    
            User user = mapper.getUserById(1);
            System.out.println(user);
    
            sqlSession.close();
        }
    
    

Insert

  <!--物件中的屬性,可以直接取出來-->
   <insert id="addUser" parameterType="com.kuang.pojo.User">
    insert into mybatis.user (id, name, pwd) values (#{id},#{name},#{pwd});
</insert>

Update

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

Delete

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

模糊查詢

  1. Java程式碼執行的時候,傳遞萬用字元 % %
    UserDaoTest.java

    List<User> userList = mapper.getUserLike("%李%");
    
  2. 在sql拼接中使用萬用字元!
    UserMapper.xml

    select * from mybatis.user where name like "%"#{value}"%"
    

注意:字串拼接sql注入問題

CRUD常見錯誤分析

  • 標籤不要匹配錯
  • resource 繫結mapper,需要使用路徑!
  • 程式配置檔案必須符合規範!
  • NullPointerException,沒有註冊到資源!
  • 輸出的xml檔案中存在中文亂碼問題!
  • maven資源沒有匯出問題!

萬能Map構造器

假設,我們的實體類,或者資料庫中的表,欄位或者引數過多,我們應當考慮使用Map!

UserDao.java

    //萬能的Map
    int addUser2(Map<String,Object> map);

UserMapper.xml

    <!--物件中的屬性,可以直接取出來    傳遞map的key-->
    <insert id="addUser" parameterType="map">     //核心
        insert into mybatis.user (id, pwd) values (#{userid},#{passWord});
    </insert>

UserDaoTest.java

    @Test
    public void addUser2(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        UserMapper mapper = sqlSession.getMapper(UserMapper.class); 


        Map<String, Object> map = new HashMap<String, Object>();   //核心

        map.put("userid",5);
        map.put("passWord","2222333");

        mapper.addUser2(map);

        sqlSession.close();
    }

Map傳遞引數,直接在sql中取出key即可! 【parameterType="map"】

物件傳遞引數,直接在sql中取物件的屬性即可!【parameterType="Object"】

只有一個基本型別引數的情況下,可以直接在sql中取到!

多個引數用Map,或者註解!

配置分析

核心配置檔案

mybatis-config.xml MyBatis 的配置檔案包含了會深深影響 MyBatis 行為的設定和屬性資訊。

環境配置(environments)

MyBatis 可以配置成適應多種環境

不過要記住:儘管可以配置多個環境,但每個 SqlSessionFactory 例項只能選擇一種環境。

學會使用配置多套執行環境!

Mybatis預設的事務管理器就是 JDBC , 連線池 : POOLED

xml標籤順序


在xml 標籤中各標籤的順序,不能顛倒,xml語法嚴格

屬性

配置檔案db.properties

編寫配置檔案db.properties

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8
username=root
password=

在核心配置檔案中映入

    <!--引入外部配置檔案-->
    <properties resource="db.properties">
        <property name="username" value="root"/>
        <property name="pwd" value="11111"/>
    </properties>

  • 可以直接引入外部檔案
  • 可以在其中增加一些屬性配置
  • 如果兩個檔案有同一個欄位,優先使用外部配置檔案的!

類型別名(typeAliases)

  • 類型別名是為 Java 型別設定一個短的名字。‘
  • 存在的意義僅在於用來減少類完全限定名的冗餘。

法一:可以給實體類起別名

    
    <typeAliases>
        <typeAlias type="com.kuang.pojo.User" alias="User"/>
    </typeAliases>

法二:指定一個包名,MyBatis 會在包名下面搜尋需要的 Java Bean,比如:

掃描實體類的包,它的預設別名就為這個類的 類名,首字母小寫!

<!--可以給實體類起別名-->
<typeAliases>
    <package name="com.kuang.pojo"/>
</typeAliases>

在實體類比較少的時候,使用第一種方式。

如果實體類十分多,建議使用第二種。

第一種可以DIY別名(自定義),第二種則·不行·,如果非要改,需要在實體上增加註解

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

設定

這是 MyBatis 中極為重要的調整設定,它們會改變 MyBatis 的執行時行為。
一個配置完整的 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>

下圖為重要掌握:

其他配置

瞭解即可
(1)typeHandlers(型別處理器)
(2)objectFactory(物件工廠)
(3)plugins外掛

  • mybatis-generator-core
  • mybatis-plus
  • 通用mapper

對映器(mappers)

MapperRegistry:註冊繫結我們的Mapper檔案;
每一個Mapper.XML都需要在Mybatis核心配置檔案中註冊

方式一: 【推薦使用】

<!--每一個Mapper.XML都需要在Mybatis核心配置檔案中註冊!-->
<mappers>
    <mapper resource="com/kuang/dao/UserMapper.xml"/>
</mappers>

方式二:使用class檔案繫結註冊

<!--每一個Mapper.XML都需要在Mybatis核心配置檔案中註冊!-->
<mappers>
    <mapper class="com.kuang.dao.UserMapper"/>
</mappers>

注意點:

  • 介面和他的Mapper配置檔案必須同名!
  • 介面和他的Mapper配置檔案必須在同一個包下!

方式三:使用掃描包進行注入繫結

<!--每一個Mapper.XML都需要在Mybatis核心配置檔案中註冊!-->
<mappers>
    <package name="com.kuang.dao"/>
</mappers>

注意點:

  • 介面和他的Mapper配置檔案必須同名!
  • 介面和他的Mapper配置檔案必須在同一個包下!

生命週期和作用域

生命週期和作用域,是至關重要的,因為錯誤的使用會導致非常嚴重的併發問題

SqlSessionFactoryBuilder:

  • 一旦建立了 SqlSessionFactory,就不再需要它了
  • 區域性變數

SqlSessionFactory:

  • 類似於:資料庫連線池
  • SqlSessionFactory 一旦被建立就應該在應用的執行期間一直存在,沒有任何理由丟棄它或重新建立另一個例項。
  • 因此 SqlSessionFactory 的最佳作用域是應用作用域。
  • 最簡單的就是使用單例模式或者靜態單例模式。

SqlSession

  • 連線到連線池的一個請求!
  • SqlSession 的例項不是執行緒安全的,因此是不能被共享的,所以它的最佳的作用域是請求或方法作用域。
  • 用完之後需要趕緊關閉,否則資源被佔用!

這裡面的每一個Mapper,就代表一個具體的業務

ResultMap

解決屬性名和欄位名不一致的問題

Q1:

資料庫中的欄位

新建一個專案,拷貝之前的,測試實體類欄位不一致的情況

public class User {
    
    private int id;
    private String name;
    private String password;
}

測試出現問題

//    select * from mybatis.user where id = #{id}
//型別處理器
//    select id,name,pwd from mybatis.user where id = #{id}

解決方法

  • 起別名

    <select id="getUserById" resultType="com.kuang.pojo.User">
        select id,name,pwd as password from mybatis.user where id = #{id}
    </select>
    

resultMap

結果集對映

id   name   pwd
id   name   password
<!--結果集對映-->
<resultMap id="UserMap" type="User">
    <!--column資料庫中的欄位,property實體類中的屬性-->
    <result column="id" property="id"/>
    <result column="name" property="name"/>
    <result column="pwd" property="password"/>
</resultMap>

<select id="getUserById" resultMap="UserMap">
    select * from mybatis.user where id = #{id}
</select>
  • resultMap 元素是 MyBatis 中最重要最強大的元素
  • ResultMap 的設計思想是,對於簡單的語句根本不需要配置顯式的結果對映,而對於複雜一點的語句只需要描述它們的關係就行了。

官方文件

常見異常總結

①mapper.xml 檔案引數問題

org.apache.ibatis.builder.IncompleteElementException


注意:增刪改查需要提交事務

②新增引數異常


原因:User.java 缺少方法

 public User(int id, String name, String pwd) {
        this.id = id;
        this.name = name;
        this.pwd = pwd;
    }

③ 返回Null

org.apache.ibatis.binding.BindingException: Mapper method 'com.lzh.dao.UserDao.addUser attempted to return null from a method with a primitive return type (int).


原因:UserMapper.xml 中sql 部分標籤未改

<select></select>    --->  <insert></insert>

④沒有引數

Error:(86, 37) java: 無法將介面 com.lzh.dao.UserDao中的方法 getUserLike應用到給定型別;
  需要: 沒有引數
  找到: java.lang.String
  原因: 實際引數列表和形式引數列表長度不同

原因:
(1)User.java set,get,toString 方法缺少
(2) UserDao.java 沒有傳入值

List<User> getUserLike()    --->  List<User> getUserLike(String name) 

基於實戰中學習,學習快樂中成長
.
時間會回答成長,成長會回答夢想