Mybatis 小談 (中篇 Ⅰ)
寫在前面:分享技術,共同進步,有不足請見諒,相關意見可評論告知 ~
程式設計路漫之遠兮,運架構體之帷幄;
勸君專注案前事,亦是杯酒敬蒼生;
目錄
CRUD
前序
namespace : namespace中的包名要和 Dao/mapper 介面的包名一致,id對應其中的方法。
如圖:
習慣:UserDao.java
---> UserMapper.java
Select
選擇,查詢語句;
- id : 就是對應的namespace中的方法名;
- resultType:Sql語句執行的返回值!
- parameterType : 引數型別!
-
編寫介面
//根據ID查詢使用者 User getUserById(int id);
-
編寫對應的mapper中的sql語句
<select id="getUserById" parameterType="int" resultType="com.kuang.pojo.User"> select * from mybatis.user where id = #{id} </select>
-
測試
@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>
模糊查詢
-
Java程式碼執行的時候,傳遞萬用字元 % %
UserDaoTest.javaList<User> userList = mapper.getUserLike("%李%");
-
在sql拼接中使用萬用字元!
UserMapper.xmlselect * 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)
基於實戰中學習,學習快樂中成長
.
時間會回答成長,成長會回答夢想