1 MyBatis簡介
1.1 MyBatis
MyBatis 本是apache的一個(gè)開源項(xiàng)目iBatis, 2010年這個(gè)項(xiàng)目由apache software foundation 遷移到了google code螟凭,并且改名為MyBatis,實(shí)質(zhì)上Mybatis對ibatis進(jìn)行一些改進(jìn)它呀。
MyBatis是一個(gè)優(yōu)秀的持久層框架螺男,它對jdbc的操作數(shù)據(jù)庫的過程進(jìn)行封裝,使開發(fā)者只需要關(guān)注 SQL 本身钟些,而不需要花費(fèi)精力去處理例如注冊驅(qū)動烟号、創(chuàng)建connection绊谭、創(chuàng)建statement政恍、手動設(shè)置參數(shù)、結(jié)果集檢索等jdbc繁雜的過程代碼达传。
對jdbc的封裝框架有哪些:Hibernate,dbutils,jdbcTemplate[spring]篙耗,mybatis
原理:Mybatis通過xml或注解的方式將要執(zhí)行的各種statement(statement、preparedStatemnt宪赶、CallableStatement)配置起來宗弯,并通過java對象和statement中的sql進(jìn)行映射生成最終執(zhí)行的sql語句,最后由mybatis框架執(zhí)行sql并將結(jié)果映射成java對象并返回搂妻。
1.2 jdbc程序代碼
- 存在的問題
- 數(shù)據(jù)庫連接頻繁開啟和關(guān)閉蒙保,會嚴(yán)重影響數(shù)據(jù)庫的性能。
- 代碼中存在硬編碼欲主,分別是數(shù)據(jù)庫部分的硬編碼和SQL執(zhí)行部分的硬編碼邓厕。
1.3 MyBatis的框架核心
- mybatis配置文件逝嚎,包括Mybatis全局配置文件和Mybatis映射文件,其中全局配置文件配置了數(shù)據(jù)源详恼、事務(wù)等信息补君;映射文件配置了SQL執(zhí)行相關(guān)的 信息。
- mybatis通過讀取配置文件信息(全局配置文件和映射文件)昧互,構(gòu)造出SqlSessionFactory挽铁,即會話工廠。
- 通過SqlSessionFactory敞掘,可以創(chuàng)建SqlSession即會話叽掘。Mybatis是通過SqlSession來操作數(shù)據(jù)庫的。
- SqlSession本身不能直接操作數(shù)據(jù)庫玖雁,它是通過底層的Executor執(zhí)行器接口來操作數(shù)據(jù)庫的够掠。Executor接口有兩個(gè)實(shí)現(xiàn)類,一個(gè)是普通執(zhí)行器茄菊,一個(gè)是緩存執(zhí)行器(默認(rèn))疯潭。
- Executor執(zhí)行器要處理的SQL信息是封裝到一個(gè)底層對象MappedStatement中。該對象包括:SQL語句面殖、輸入?yún)?shù)映射信息竖哩、輸出結(jié)果集映射信息。其中輸入?yún)?shù)和輸出結(jié)果的映射類型包括HashMap集合對象脊僚、POJO對象類型相叁。
2 MyBatis入門
2.1 環(huán)境準(zhǔn)備
-
創(chuàng)建數(shù)據(jù)庫表
image.png 下載MyBatis
mybaits的代碼由github.com管理,下載地址:<u>https://github.com/mybatis/mybatis-3/releases</u>-
創(chuàng)建項(xiàng)目導(dǎo)包
-
導(dǎo)入下面的包
image.png
image.png
-
-
添加log4j.properties
- Mybatis使用的日志包是log4j的辽幌,所以需要添加log4j.properties增淹。
在classpath下創(chuàng)建log4j.properties如下:【文件內(nèi)容可以從mybatis-3.2.7.pdf中拷貝】 - 日志級別在開發(fā)階段設(shè)置成DEBUG,在生產(chǎn)階段設(shè)置成INFO或者ERROR
- Mybatis使用的日志包是log4j的辽幌,所以需要添加log4j.properties增淹。
# Global logging configuration
log4j.rootLogger=DEBUG, stdout
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n
2.2 開發(fā)步驟
1乌企、創(chuàng)建PO(model)類虑润,根據(jù)需求創(chuàng)建;
2加酵、創(chuàng)建全局配置文件SqlMapConfig.xml拳喻;
3、編寫映射文件猪腕;
4冗澈、加載映射文件,在SqlMapConfig.xml中進(jìn)行加載陋葡;
5亚亲、編寫測試程序,即編寫Java代碼,連接并操作數(shù)據(jù)庫捌归。
思路:
a)讀取配置文件颊亮;
b)通過SqlSessionFactoryBuilder創(chuàng)建SqlSessionFactory會話工廠。
c)通過SqlSessionFactory創(chuàng)建SqlSession陨溅。
d)調(diào)用SqlSession的操作數(shù)據(jù)庫方法终惑。
e)關(guān)閉SqlSession。
-
創(chuàng)建PO類
image.png -
創(chuàng)建SqlMapConfig.xml
- 在classpath(src)下门扇,創(chuàng)建SqlMapConfig.xml文件【SqlMapConfig.xml(文件頭可以從mybatis-3.2.7.pdf文檔的2.1.2小節(jié)中拷貝)】
<configuration>
<!-- 配置mybatis的環(huán)境信息 -->
<environments default="development">
<environment id="development">
<!-- 配置JDBC事務(wù)控制雹有,由mybatis進(jìn)行管理 -->
<transactionManager type="JDBC"></transactionManager>
<!-- 配置數(shù)據(jù)源,采用dbcp連接池 -->
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatisday01?useUnicode=true&characterEncoding=utf8"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
</configuration>
- 映射文件
- 在classpath下臼寄,創(chuàng)建sqlmap文件夾霸奕。在sqlmap目錄下,創(chuàng)建User.xml映射文件吉拳。
【Mybatis的映射文件頭(可以從mybatis-3.2.7.pdf文件中拷貝)】
- 在classpath下臼寄,創(chuàng)建sqlmap文件夾霸奕。在sqlmap目錄下,創(chuàng)建User.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">
<!--
namespace:命名空間质帅,它的作用就是對SQL進(jìn)行分類化管理,可以理解為SQL隔離
注意:使用mapper代理開發(fā)時(shí)留攒,namespace有特殊且重要的作用
-->
<mapper namespace="test">
<!--
[id]:statement的id煤惩,要求在命名空間內(nèi)唯一
[parameterType]:入?yún)⒌膉ava類型
[resultType]:查詢出的單條結(jié)果集對應(yīng)的java類型
[#{}]: 表示一個(gè)占位符?
[#{id}]:表示該占位符待接收參數(shù)的名稱為id。注意:如果參數(shù)為簡單類型時(shí)炼邀,#{}里面的參數(shù)名稱可以是任意定義
-->
<select id="findUserById" parameterType="int" resultType="com.gyf.domain.User">
SELECT * FROM USER WHERE id = #{id}
</select>
</mapper>
- 配置文件加載映射文件
<!--告訴MyBatis加載映射文件-->
<mappers>
<mapper resource="com/kdj/sqlmap/User.xml"></mapper>
</mappers>
- 測試類
@Test
public void test1() throws IOException {
//a)讀取配置文件魄揉;
InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
//b)通過SqlSessionFactoryBuilder創(chuàng)建SqlSessionFactory會話工廠。
SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(is);
//c)通過SqlSessionFactory創(chuàng)建SqlSession拭宁。
SqlSession session = sessionFactory.openSession();
//d)調(diào)用SqlSession的操作數(shù)據(jù)庫方法洛退。
User user = session.selectOne("findUserById", 10);
System.out.println(user);
//e)關(guān)閉SqlSession。
session.close();
}
2.3 更多案例講解
- 模糊查詢用戶信息
<!--
[${}]:表示拼接SQL字符串
[${value}]:表示要拼接的是簡單類型參數(shù)杰标。
注意:
1兵怯、如果參數(shù)為簡單類型時(shí),${}里面的參數(shù)名稱必須為value
2腔剂、${}會引起SQL注入媒区,一般情況下不推薦使用。但是有些場景必須使用${}桶蝎,比如order by ${colname}
-->
<select id="findUserByName" parameterType="String" resultType="com.kdj.model.User">
SELECT * FROM user WHERE username like '%${value}%'
</select>
List<User> users = session.selectList("findUserByName", "張");
System.out.println(users);
- 插入用戶信息
- 增刪改要commit事務(wù)
<!--插入數(shù)據(jù)
這里的占位是寫模型的屬性
-->
<insert id="insertUser" parameterType="com.kdj.model.User">
INSERT INTO user (username, sex, birthday, address)
VALUE (#{username},#{sex},#{birthday},#{address});
</insert>
@Test
public void test2() {
User user = new User("kdj04", "2", new Date(), "上海");
session.insert("insertUser", user);
//增刪改要提交事務(wù)
session.commit();
}
- 刪除用戶
<!--刪除-->
<delete id="deleteUser" parameterType="int">
DELETE FROM user where id = #{id};
</delete>
/**
* 刪除用戶
*/
@Test
public void test3() {
int affectRows = session.delete("deleteUser", 34);
session.commit();//事務(wù)
System.out.println("受影響的行數(shù):" + affectRows);
}
- 更新用戶
<!--更新-->
<update id="updateUser" parameterType="com.kdj.model.User">
UPDATE user SET sex = #{sex},address = #{address}
WHERE id = #{id}
</update>
/**
* 更新用戶
*/
@Test
public void test4() {
User user = new User();
user.setId(32);
user.setSex("男");
user.setAddress("香港");
int affectRows = session.update("updateUser", user);
session.commit();//事務(wù)
System.out.println("受影響的行數(shù):" + affectRows);
}
- 主鍵返回之MySQL自增主鍵
- 思路:
- MySQL自增主鍵驻仅,是指在insert之前MySQL會自動生成一個(gè)自增的主鍵谅畅。
- 我們可以通過MySQL的函數(shù)獲取到剛插入的自增主鍵:
LAST_INSERT_ID() - 這個(gè)函數(shù)是在insert語句之后去調(diào)用登渣。
- 思路:
<!--插入時(shí)自動返回主鍵id-->
<insert id="insertUser2" parameterType="com.kdj.model.User">
<!--
[selectKey標(biāo)簽]:通過select查詢來生成主鍵
[keyProperty]:指定存放生成主鍵的屬性
[resultType]:生成主鍵所對應(yīng)的Java類型
[order]:指定該查詢主鍵SQL語句的執(zhí)行順序,相對于insert語句
[last_insert_id]:MySQL的函數(shù)毡泻,要配合insert語句一起使用 -->
<selectKey keyProperty="id" resultType="int" order="AFTER">
SELECT LAST_INSERT_ID()
</selectKey>
<!-- 如果主鍵的值是通過MySQL自增機(jī)制生成的胜茧,那么我們此處不需要再顯示的給ID賦值 -->
INSERT INTO user (username, sex, birthday, address)
VALUE (#{username},#{sex},#{birthday},#{address});
</insert>
/**
* 插入后,往模型里設(shè)置id
*/
@Test
public void test5() {
User user = new User("kdj07", "2", new Date(), "上海");
session.insert("insertUser2", user);
//增刪改要提交事務(wù)
session.commit();
System.out.println("用戶的ID" + user.getId());
}
- 主鍵返回之MySQL自增UUID
<insert id="insertUser" parameterType="com.gyf.domain.User">
<selectKey keyProperty="id" resultType="String" order="BEFORE">
SELECT UUID()
</selectKey>
INSERT INTO USER (username,sex,birthday,address)
VALUES(#{username},#{sex},#{birthday},#{address})
-
ORCLE主鍵
- SELECT user_seq.nextval() FROM dual
小結(jié)
parameterType和resultType
parameterType指定輸入?yún)?shù)的java類型,可以填寫別名或Java類的全限定名。
resultType指定輸出結(jié)果的java類型呻顽,可以填寫別名或Java類的全限定名雹顺。
#{}和${}
#{}:相當(dāng)于預(yù)處理中的占位符?廊遍。
#{}里面的參數(shù)表示接收java輸入?yún)?shù)的名稱嬉愧。
#{}可以接受HashMap、POJO類型的參數(shù)喉前。
當(dāng)接受簡單類型的參數(shù)時(shí)没酣,#{}里面可以是value,也可以是其他卵迂。
#{}可以防止SQL注入裕便。
${}:相當(dāng)于拼接SQL串,對傳入的值不做任何解釋的原樣輸出见咒。
${}會引起SQL注入偿衰,所以要謹(jǐn)慎使用。
${}可以接受HashMap改览、POJO類型的參數(shù)牛曹。
當(dāng)接受簡單類型的參數(shù)時(shí),${}里面只能是value岩喷。
selectOne和selectList
selectOne:只能查詢0或1條記錄荚坞,大于1條記錄的話,會報(bào)錯(cuò):
selectList:可以查詢0或N條記錄
2.4 MyBatis的Dao編寫 【一般不用今妄,有更多好方式】
- DAO
package com.kdj.dao;
import com.kdj.model.User;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
public class UserDaoImpl implements UserDao {
private SqlSessionFactory ssf;
public UserDaoImpl(SqlSessionFactory ssf) {
this.ssf = ssf;
}
public UserDaoImpl() {
}
@Override
public void save(User user) {
//獲取session
SqlSession session = ssf.openSession();
//插入數(shù)據(jù)
session.insert("insertUser", user);
session.commit();
session.close();
}
@Override
public User findUserById(int id) {
//獲取session
SqlSession session = ssf.openSession();
//插入數(shù)據(jù)
User user = session.selectOne("findUserById", id);
session.close();
return user;
}
}
- 測試
package com.kdj.test;
import com.kdj.dao.UserDao;
import com.kdj.dao.UserDaoImpl;
import com.kdj.model.User;
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 org.junit.After;
import org.junit.Before;
import org.junit.Test;
import java.io.IOException;
import java.io.InputStream;
import java.util.Date;
import java.util.List;
public class Demo03 {
SqlSessionFactory sessionFactory;
@Before
public void before() throws IOException {
System.out.println("before........獲取session");
//a)讀取配置文件郑口;
InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
//b)通過SqlSessionFactoryBuilder創(chuàng)建SqlSessionFactory會話工廠。
sessionFactory = new SqlSessionFactoryBuilder().build(is);
}
@Test
public void test1() throws IOException {
//調(diào)用dao
//1.創(chuàng)建dao
UserDao userDao = new UserDaoImpl(sessionFactory);
User user1 = userDao.findUserById(1);
System.out.println(user1);
User user2 = new User("xxxx", "x", new Date(), "xx");
userDao.save(user2);
}
}
2.5 MyBatis的Dao編寫【mapper代理方式實(shí)現(xiàn)】
- Mapper代理的開發(fā)方式盾鳞,程序員只需要編寫mapper接口(相當(dāng)于dao接口)即可犬性。Mybatis會自動的為mapper接口生成動態(tài)代理實(shí)現(xiàn)類。
不過要實(shí)現(xiàn)mapper代理的開發(fā)方式腾仅,需要遵循一些開發(fā)規(guī)范乒裆。 - 開發(fā)規(guī)范
1.mapper接口的全限定名要和mapper映射文件的namespace的值相同。
2.mapper接口的方法名稱要和mapper映射文件中的statement的id相同推励;
3.mapper接口的方法參數(shù)只能有一個(gè)鹤耍,且類型要和mapper映射文件中statement的parameterType的值保持一致。
4.mapper接口的返回值類型要和mapper映射文件中statement的resultType值或resultMap中的type值保持一致验辞;
通過規(guī)范式的開發(fā)mapper接口稿黄,可以解決原始dao開發(fā)當(dāng)中存在的問題:
模板代碼已經(jīng)去掉;
剩下去不掉的操作數(shù)據(jù)庫的代碼跌造,其實(shí)就是一行代碼杆怕。這行代碼中硬編碼的部分族购,通過第一和第二個(gè)規(guī)范就可以解決。
編寫步驟
第一步
-
重新寫個(gè)UserMapper配置文件和定義mapper映射文件UserMapper.xml(內(nèi)容同Users.xml陵珍,除了namespace的值)寝杖,放到新創(chuàng)建的目錄mapper下。
image.png 第二步:【添加映射配置文件】
<!--告訴MyBatis加載映射文件-->
<mappers>
<!--<mapper resource="com/kdj/sqlmap/User.xml"></mapper>-->
<mapper resource="com/kdj/mapper/UserMapper.xml"></mapper>
</mappers>
- 第三步:測試
package com.kdj.test;
import com.kdj.dao.UserDao;
import com.kdj.dao.UserDaoImpl;
import com.kdj.mapper.UserMapper;
import com.kdj.model.User;
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 org.junit.After;
import org.junit.Before;
import org.junit.Test;
import java.io.IOException;
import java.io.InputStream;
import java.util.Date;
public class Demo04 {
SqlSession session;
@Before
public void before() throws IOException {
System.out.println("before........獲取session");
//a)讀取配置文件互纯;
InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
//b)通過SqlSessionFactoryBuilder創(chuàng)建SqlSessionFactory會話工廠瑟幕。
SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(is);
session = sessionFactory.openSession();
}
@After
public void after(){
session.close();
}
@Test
public void test1() throws IOException {
UserMapper userMapper = session.getMapper(UserMapper.class);
//獲取數(shù)據(jù)
System.out.println(userMapper.findUserById(1));
//保存
User user2 = new User("xxOOxx", "x", new Date(), "xx");
int affectRows = userMapper.save(user2);
session.commit();
System.out.println("affectRows:" + affectRows);
}
}
3 全局配置文件其它配置
3.1 properties數(shù)據(jù)庫文件配置
- 在src下配置個(gè)db.properties文件
driverClass=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatisday1?useUnicode=true&characterEncoding=utf8
username=root
password=root
-
修改全局的配置文件
image.png
3.2 setting【了解】
-
具體配置詳解
image.png
image.png
3.3 typeAliases
- 別名是使用是為了在映射文件中,更方便的去指定參數(shù)和結(jié)果集的類型留潦,不再用寫很長的一段全限定名收苏。
- mybatis支持的別名
別名 映射的類型
_byte byte
_long long
_short short
_int int
_integer int
_double double
_float float
_boolean boolean
string String
byte Byte
long Long
short Short
int Integer
integer Integer
double Double
float Float
boolean Boolean
date Date
decimal BigDecimal
bigdecimal BigDecimal
-
自定義別名
image.png
3.4 加載映射文件的幾種方式
<mapper resource=’’/>
使用相對于類路徑的資源
如:<mapper resource="sqlmap/User.xml" />
<mapper url=’’/> 【不用】
使用完全限定路徑
如:<mapper url="file:///D:\workspace_spingmvc\mybatis_01\config\sqlmap\User.xml" />
<mapper class=’’/>
使用mapper接口的全限定名
如:<mapper class="cn.gyf.mybatis.mapper.UserMapper"/>
-
也可使用注解開發(fā),把xml文件刪除
image.png 注意:此種方法要求mapper接口和mapper映射文件要名稱相同愤兵,且放到同一個(gè)目錄下
<package name=’’/>(推薦)
注冊指定包下的所有映射文件
如:<package name="cn.gyf.mybatis.mapper"/>
4 Mybatis的映射文件
4.1 輸入映射ParameterType
指定輸入?yún)?shù)的java類型鹿霸,可以使用別名或者類的全限定名。它可以接收簡單類型,POJO對象秆乳、HashMap懦鼠。
傳遞簡單類型
-
根據(jù)用戶ID查詢用戶信息。
image.png -
傳遞POJO對象
image.png 傳遞POJO包裝對象
開發(fā)中通過pojo傳遞查詢條件 屹堰,查詢條件是綜合的查詢條件肛冶,不僅包括用戶查詢條件還包括其它的查詢條件(比如將用戶購買商品信息也作為查詢條件),這時(shí)可以使用包裝對象傳遞輸入?yún)?shù)扯键。
需求
綜合查詢用戶信息睦袖,需要傳入查詢條件復(fù)雜,比如(用戶信息荣刑、訂單信息馅笙、商品信息)。
vo:鍵值對對象厉亏,相對于kv
po:persist object 持久化對象
pojo:簡單的java對象
entity:實(shí)體-
定義POJO包裝類
image.png -
修改UserMapper.java
image.png -
修改UsrMappler.xml
image.png -
測試
image.png 傳遞Map對象
-
修改UserMapper.java
image.png -
修改UserMapper.xml
image.png 測試
@Test
public void test2() throws IOException {
UserMapper userMapper = session.getMapper(UserMapper.class);
// 通過Map查詢
Map<String, Object> map = new HashMap<String, Object>();
map.put("name", "張");
map.put("sex", "1");
List<User> list = userMapper.findUserByMap(map);
System.out.println(list);
}
- 注意點(diǎn):
${}
不要使用username,會與db.properties中的root沖突
4.2 輸出映射 resultType/resultMap
resultType
使用resultType進(jìn)行結(jié)果映射時(shí)董习,查詢的列名和映射的pojo屬性名完全一致,該列才能映射成功爱只。
如果查詢的列名和映射的pojo屬性名全部不一致皿淋,則不會創(chuàng)建pojo對象;
如果查詢的列名和映射的pojo屬性名有一個(gè)一致恬试,就會創(chuàng)建pojo對象窝趣。
- 輸出簡單類型
當(dāng)輸出結(jié)果只有一列時(shí),可以使用ResultType指定簡單類型作為輸出結(jié)果類型训柴。 案例:輸出一個(gè)count(*)
- UserMapper.java
/**
* 返回用戶的個(gè)數(shù)
* @param vo
* @return
*/
public int findUserCount(UserQueryVO vo);
- UserMapper.xml
<!--第二天內(nèi)容-->
<!--1 設(shè)置返回?cái)?shù)據(jù)為基本類型,int ,double-->
<!--查詢用戶的個(gè)數(shù)-->
<select id="findUserCount" parameterType="userQueryVO" resultType="int">
SELECT COUNT(*) FROM user WHERE sex = #{user.sex}
</select>
- 測試
@Test
public void test1() {
UserMapper userMapper = session.getMapper(UserMapper.class);
// 通過模型的包裝類來查詢用戶
UserQueryVO query = new UserQueryVO();
User user = new User();
user.setSex("2"); //男性
query.setUser(user);
int count = userMapper.findUserCount(query);
System.out.println("男性用戶的人數(shù):" + count);
}
-
輸出POJO單個(gè)對象
image.png
-
輸出POJO列表
image.png
image.png 總結(jié):
輸出單個(gè)pojo對象和pojo列表時(shí)哑舒,mapper映射文件中的resultType的類型是一樣的,mapper接口的方法返回值不同畦粮。
同樣的mapper映射文件散址,返回單個(gè)對象和對象列表時(shí)乖阵,mapper接口在生成動態(tài)代理的時(shí)候宣赔,會根據(jù)返回值的類型预麸,決定調(diào)用selectOne方法還是selectList方法。