1、CRUD
1.namespace
namespace中的包名要和Dao/Mapper 接口的包名一致!
1个Dao接口类对应1个mapper,也对应1个namespace,
1个Dao接口中的方法对应1个namespace中一个SQL语句
2.CRUD
- id:对应的namespace接口中的方法名
- resultType:SQL语句执行的返回值——承载数据的实体类
- parameterType:参数类型
1、编写接口UserMapper(修改UserDao为UserMapper)
public interface UserMapper {// 查询全部用户List<User> getUserList();// 根据id查询用户User getUserById(int id);// 插入一个用户int addUser(User user);// 修改一个用户int updateUser(User user);// 删除一个用户void deleteUser(int id);}
2、编写对应的mapper中的sql语句UserMapper.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--namespace绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.kuang.dao.UserMapper"><select id="getUserList" resultType="com.kuang.pojo.User">select * from mybatis.user</select><select id="getUserById" parameterType="int" resultType="com.kuang.pojo.User">select * from user where id=#{id}</select><!--对象中的属性,可以直接取出来--><insert id="addUser" parameterType="com.kuang.pojo.User">insert into user(id,name,pwd) values(#{id},#{name},#{pwd})</insert><update id="updateUser" parameterType="com.kuang.pojo.User">update user set name=#{name},pwd=#{pwd} where id=#{id}</update><delete id="deleteUser" parameterType="int">delete from user where id=#{id}</delete>
</mapper>
3、将mapper注册到核心配置文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""https://mybatis.org/dtd/mybatis-3-config.dtd">
<!--核心配置文件-->
<configuration><environments default="development"><environment id="development"><transactionManager type="JDBC"/><dataSource type="POOLED"><!--数据库驱动--><property name="driver" value="com.mysql.cj.jdbc.Driver"/><!--&表示转义后的&--><property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai"/><property name="username" value="root"/><property name="password" value="niit1234"/></dataSource></environment></environments><!--注册mapper--><mappers><mapper resource="com/kuang/mapper/UserDaoMapper.xml"/></mappers>
</configuration>
4、测试
package com.kuang.dao;import com.kuang.Utils.MybatisUtils;
import com.kuang.pojo.User;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;import java.util.List;public class UserDaoTest {//对于@Test的方法,光标聚焦在对应方法上右键@Testpublic void test(){//第一步:获取SqlSession对象SqlSession sqlSession= MybatisUtils.getSqlSession();;try{//方式1:getMapper()UserMapper userMapper =sqlSession.getMapper(UserMapper.class);List<User> userList = userMapper.getUserList();for(User user:userList){System.out.println(user);}System.out.println();//方式2:selectList() 不推荐
// List<User> userList2=sqlSession.selectList("com.kuang.dao.UserMapper.getUserList");
// for(User user : userList2){
// System.out.println(user);
// }}catch(Exception e){e.printStackTrace();}finally{//关闭sqlSessionsqlSession.close();}}@Testpublic void getUserById(){SqlSession sqlSession=MybatisUtils.getSqlSession();try{UserMapper mapper=sqlSession.getMapper(UserMapper.class);User user = mapper.getUserById(1);System.out.println(user);}catch(Exception e){e.printStackTrace();}finally {sqlSession.close();}}//增删改必须要提交事务@Testpublic void addUser(){SqlSession sqlSession=MybatisUtils.getSqlSession();try{UserMapper mapper = sqlSession.getMapper(UserMapper.class);//修改Userdao中的该方法返回值为void则没有返回值int res=mapper.addUser(new User(4,"赵六","123489"));if(res>0){System.out.println("插入成功");}//提交事务sqlSession.commit();}catch(Exception e){e.printStackTrace();}finally {sqlSession.close();}}@Testpublic void updateUser(){SqlSession sqlSession = MybatisUtils.getSqlSession();UserMapper mapper=sqlSession.getMapper(UserMapper.class);int res=mapper.updateUser(new User(4,"赵六六","124376"));if(res>0){System.out.println("修改成功");}sqlSession.commit();sqlSession.close();}@Testpublic void deleteUser(){SqlSession sqlSession = MybatisUtils.getSqlSession();UserMapper mapper = sqlSession.getMapper(UserMapper.class);int res=mapper.deleteUser(4);if(res>0) {sqlsession.commit();System.out.println("SUCCESS!");}else {sqlsession.rollback();System.out.println("FAILED!");}sqlSession.commit();sqlSession.close();}
}
注意:增删改必需要提交事务sqlSession.commit()
常见错误
- 标签不要匹配错
- resource绑定mapper,需要使用路径
- 程序配置文件必须符合规范
- 空指针异常,没有注册到资源
- target输出xml文件中存在中文乱码问题
- maven资源没有导出问题
2、万能Map
假设我们的实体类,或者数据库中的表,字段或者参数过多,我们应当考虑使用Map!
1、UserMapper
//万能的mapint addUser2(Map<String,Object> map);
2、UserMapper
<!--传递map的key-->
<insert id="addUser2" parameterType="map" >insert into mybatis.user(id,name,pwd) values (#{userid},#{userName},#{passWord});
</insert>
3、测试
@Test
public void addUser2(){SqlSession sqlSession = MybatisUtils.getSqlSession();UserMapper mapper = sqlSession.getMapper(UserMapper.class);HashMap<String, Object> map = new HashMap<>();map.put("userid",5);map.put("userName","hello");map.put("passWord","976543");mapper.addUser2(map);sqlSession.commit();sqlSession.close();
}
-
Map 传递参数,直接在sql中取出key 【parameterType=“Map”】
-
对象传递参数,直接在sql中取对象的属性即可 【parameterType=“com.kuang.pojo.User”】
-
只有一个基本类型参数的情况下,可以直接在sql中取到
-
多个参数用Map或注解
3、模糊查询
like+通配符
通配符:%——0或多个 ;_——1个
两种方法:
-
在sql拼接中使用通配符(不推荐,有sql注入问题)
<select id="getUserLike">select * from user where name like "%#{value}%" </select>
-
Java代码执行的时候,传递通配符 %%。如下步骤
1、UserMapper
//模糊查询 List<User> getUserLike(String value);
2、UserMapper.xml
<select id="getUserLike" resultType="com.study.pojo.User">select * from user where name like #{value} </select>
3、测试
@Test public void getUserLike(){SqlSession sqlSession = MybatisUtils.getSqlSession();UserMapper mapper = sqlSession.getMapper(UserMapper.class);List<User> userlist = mapper.getUserLike("李%");for(User user:userlist){System.out.println(user);} }
4、配置解析
核心配置文件 mybatis-config.xml
MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。 配置文档的顶层结构如下:
configuration(配置)
-
properties(属性)
-
settings(设置)
-
typeAliases(类型别名)
-
typeHandlers(类型处理器)
-
objectFactory(对象工厂)
-
plugins(插件)
-
environments(环境配置)
- environment(环境变量)
- transactionManager(事务管理器)
- dataSource(数据源)
- environment(环境变量)
-
databaseIdProvider(数据库厂商标识)
-
mappers(映射器)
新建模块
1. 在src/main/resources路径下建立mybatis-config.xml文件2. 在src/main/java/com/study/utils路径下编写工具类MybatisUtils.java读取配置文件获取sqlsessionfactory3. 在src/main/java/com/study/pojo路径下编写实体类User.java4. 在src/main/java/com/study/dao路径下编写接口UserMapper.java和UserMapper.xml5. 编写测试类
环境配置(environments)
-
MyBatis 可以配置成适应多种环境,根据id识别不同环境
-
尽管可以配置多个环境,但每个 SqlSessionFactory 实例只能选择一种环境。
-
学会配置多套运行环境-----更改id
<environments default="id">
-
Mybatis默认的事务管理器就是JDBC,连接池:POOLED
-
连接池:使并发 Web 应用快速响应请求
<!--默认使用的环境 ID(比如:default="development")--><environments default="development"><!--每个 environment 元素定义的环境 ID(比如:id="development")--><environment id="development"><!--事务管理器的配置 type="JDBC(默认)|MANAGED")--><transactionManager type="JDBC"/><!--数据源的配置 type="POOLED(默认)|UNPOOLED|JDN")连接池:使并发 Web 应用快速响应请求--><dataSource type="POOLED"><!--driver – 这是 JDBC 驱动的 Java 类全限定名(并不是 JDBC 驱动中可能包含的数据源类)--><property name="driver" value="com.mysql.jdbc.Driver"/><!--url – 这是数据库的 JDBC URL 地址。 &表示转义后的&--><property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai"/><!--username – 登录数据库的用户名--><property name="username" value="root"/><!--password – 登录数据库的密码--><property name="password" value="123456"/></dataSource></environment></environments>
-
事务管理器
<transactionManager type="[ JDBC | MANAGED ]"/>
-
有三种内建的数据源类型
<dataSource type="[UNPOOLED|POOLED|JNDI]">
- unpooled: 这个数据源的实现只是每次被请求时打开和关闭连接。
- pooled: 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来 , 这是一种使得
并发 Web 应用快速响应请求的流行处理方式。 - jndi:这个数据源的实现是为了能在如 Spring 或应用服务器这类容器中使用,容器可以集中或在外部配置数据源,然后放置一个 JNDI 上下文的引用。
- 数据源也有很多第三方的实现,比如dbcp,c3p0,druid等等…
属性(properties)
-
数据库这些属性都是可外部配置且可动态替换的
-
我们可以通过properties属性来实现引用属性文件
-
这些属性可以在外部进行配置,并可以进行动态替换。你既可以在典型的 Java 属性文件【db.properties】中配置这些属性,也可以在 properties 元素的子元素中设置
我们来优化我们的配置文件
-
编写一个配置文件
db.properties
:driver=com.mysql.cj.jdbc.Driver url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai username=root password=niit1234
-
将
db.properties
文件导入核心 配置文件mybatis-config.xml
-
properties元素要卸载environmens元素前面,否则报错
<!--引入外部属性文件 由于db.properties和mabatis-config.xml都在resource目录下不必考虑路径名--><!--方法1:所有属性都是用db.properties中的--> <!-- <properties resource="db.properties"/>--><!--方法2:既可以在典型的 Java 属性文件中配置这些属性,也可以在 properties 元素的子元素中设置。在mybatis-config.xml中设置property元素不会覆盖db.properties中的值--><properties resource="db.properties"><property name="username" value="root"/><property name="password" value="niit12"/></properties>
也可以在 SqlSessionFactoryBuilder.build() 方法中传入属性值。例如:
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, props);// ... 或者 ...SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment, props);
-
注意事项:
-
可以直接引入外部文件
-
可以在中通过增加一些属性配置
-
如果两个文件有同一个字段,优先使用外部配置文件(db.proerpties)的
-
如果一个属性在不只一个地方进行了配置,那么,MyBatis 将按照下面的顺序来加载:
-
首先读取在 properties 元素体内指定的属性。
-
然后根据 properties 元素中的 resource 属性读取类路径下属性文件(如com/kuang/dao/UserDaoMapper.xml),或根据url 属性指定的路径读取属性文件,并覆盖之前读取过的同名属性。
-
最后读取作为方法参数传递的属性,并覆盖之前读取过的同名属性。
-
-
通过方法参数传递的属性具有最高优先级,resource/url 属性中指定的配置文件次之,最低优先级的则是 properties 元素中指定的属性。
-
类型别名(typeAliases)
- 类型别名可为 Java 类型设置一个缩写名字。
- 它仅用于 XML 配置,意在降低冗余的全限定类名书写。
方法1:<typeAlias>
方法1:<typeAlias>
方法2:<package>
指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean,比如:
即扫描实体类所在的包,包下类的类名就是该类的别名(首字母小写,大写也行)
<!--给实体类起别名--><typeAliases><!--方法1:--><typeAlias type="com.kuang.pojo.User" alias="User"/><!--方法2:--><package name="com.kuang.pojo"/></typeAliases>
每一个在包 com.kuang.pojo.User
中的 Java Bean,在没有注解的情况下,会使用 Bean 的首字母小写的非限定类名来作为它的别名。 比如 com.kuang.pojo.Author
的别名为 author
;若有注解,则别名为其注解值。见下面的例子:
@Alias("author")
public class Author {...
}
两种方法的区别
- 实体类比较少的时候,使用第一种方式
- 如果实体类十分多,建议使用第二种
- 第一种可以DIY别名,第二种则不行,如果非要改,需要在实体类上增加注解
@Alias("Hello")
public class User
<select id="getUserList" resultType="Hello">select * from mybatis.user
</select>
Mybatis自带别名
下面是一些为常见的 Java 类型内建的类型别名。它们都是不区分大小写的,注意,为了应对原始类型的命名重复,采取了特殊的命名风格。(八大基本数据类型前加下划线,对应的包装类小写即可)
别名 | 映射的类型 |
---|---|
_byte | byte |
_char (since 3.5.10) | char |
_character (since 3.5.10) | char |
_long | long |
_short | short |
_int | int |
_integer | int |
_double | double |
_float | float |
_boolean | boolean |
string | String |
byte | Byte |
char (since 3.5.10) | Character |
character (since 3.5.10) | Character |
long | Long |
short | Short |
int | Integer |
integer | Integer |
double | Double |
float | Float |
boolean | Boolean |
date | Date |
decimal | BigDecimal |
bigdecimal | BigDecimal |
biginteger | BigInteger |
object | Object |
date[] | Date[] |
decimal[] | BigDecimal[] |
bigdecimal[] | BigDecimal[] |
biginteger[] | BigInteger[] |
object[] | Object[] |
map | Map |
hashmap | HashMap |
list | List |
arraylist | ArrayList |
collection | Collection |
iterator | Iterator |
设置(settings)
这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为。 下表描述了设置中各项设置的含义、默认值等。(部分重要设置,官网有完整版)
设置名 | 描述 | 有效值 | 默认值 |
---|---|---|---|
cacheEnabled | 全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。 | true | false |
lazyLoadingEnabled | 延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。 | true | false |
mapUnderscoreToCamelCase | 是否开启驼峰命名自动映射,即从经典数据库列名 A_COLUMN 映射到经典 Java 属性名 aColumn。 | true | false |
logImpl | 指定 MyBatis 所用日志的具体实现,未指定时将自动查找。 | SLF4J | LOG4J(3.5.9 起废弃) |
一个配置完整的 settings 元素的示例如下:
<settings><setting name="cacheEnabled" value="true"/><setting name="lazyLoadingEnabled" value="true"/><setting name="aggressiveLazyLoading" 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="safeResultHandlerEnabled" value="true"/><setting name="mapUnderscoreToCamelCase" value="false"/><setting name="localCacheScope" value="SESSION"/><setting name="jdbcTypeForNull" value="OTHER"/><setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/><setting name="defaultScriptingLanguage" value="org.apache.ibatis.scripting.xmltags.XMLLanguageDriver"/><setting name="defaultEnumTypeHandler" value="org.apache.ibatis.type.EnumTypeHandler"/><setting name="callSettersOnNulls" value="false"/><setting name="returnInstanceForEmptyRow" value="false"/><setting name="logPrefix" value="exampleLogPreFix_"/><setting name="logImpl" value="SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING"/><setting name="proxyFactory" value="CGLIB | JAVASSIST"/><setting name="vfsImpl" value="org.mybatis.example.YourselfVfsImpl"/><setting name="useActualParamName" value="true"/><setting name="configurationFactory" value="org.mybatis.example.ConfigurationFactory"/>
</settings>
其它配置
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
- mybatis-generator-core
- mybatis-plus
- 通用mapper
映射器(mappers)
-
MapperRegistry:注册绑定我们的Mapper文件,每写一个dao接口就要写一个Mapper文件
-
映射器 : 定义映射SQL语句文件
-
既然 MyBatis 的行为其他元素已经配置完了,我们现在就要定义 SQL 映射语句了。但是首先我们需要告诉 MyBatis 到哪里去找到这些语句。Java 在自动查找这方面没有提供一个很好的方法,所以最佳的方式是告诉 MyBatis 到哪里去找映射文件。你可以使用相对于类路径的资源引用, 或完全限定资源定位符(包括 file:/// 的 URL),或类名和包名等。映射器是MyBatis中最核心的组件之一,在MyBatis 3之前,只支持xml映射器,即:所有的SQL语句都必须在xml文件中配置。而从MyBatis 3开始,还支持接口映射器,这种映射器方式允许以Java代码的方式注解定义SQL语句,非常简洁。
-
1张表——1个Entity类——1个EntityDao/EntityMapper接口——1个Mapper.xml——核心配置文件中的1个
-
Dao/Maapper接口中的1个方法——Mapper.xml中的1个sql语句
方式1:使用resource属性
使用相对于类路径的资源引用(推荐)
<!-- 每一个Mapper.xml都需要在MyBatis核心配置文件中注册-->
<mappers><mapper resource="com/kuang/dao/UserDaoMapper.xml"/>
</mappers>
方式2:使用class属性
- 使用映射器接口实现类的完全限定类名
- 需要配置文件名称和接口名称一致,并且位于同一目录下
<mappers><!--<mapper class="com.kuang.dao.UserDaoMapper"/>--><!--报错--><mapper class="com.kuang.dao.UserMapper"/>
</mappers>
注意点:
-
接口和它的Mapper配置文件必须同名
-
接口和它的Mapper配置文件必须在同一个包下
方式3:<package>元素
将包内的映射器接口实现全部注册为映射器,但是需要配置文件名称和接口名称一致,并且位于同一目录下
<mappers><package name="com.kuang.dao"/>
</mappers>
注意点同方法二
方式4:url属性
(不常用)
<!-- 使用完全限定资源定位符(URL) -->
<mappers><mapper url="file:///var/mappers/AuthorMapper.xml"/><mapper url="file:///var/mappers/BlogMapper.xml"/><mapper url="file:///var/mappers/PostMapper.xml"/>
</mappers>
5、生命周期
不同作用域和生命周期类别是至关重要的,因为错误的使用会导致非常严重的并发问题。
-
SqlSessionFactoryBuilder
-
作用:创建 SqlSessionFactory
-
一旦创建了 SqlSessionFactory,就不再需要它了。
-
SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域(也就是局部方法变量)。
-
-
SqlSessionFactory
- 可以理解为数据库连接池
- SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例。
- 一般的应用中我们往往希望 SqlSessionFactory 作为一个单例,让它在应用中被共享。
- SqlSessionFactory 的最佳作用域是应用作用域(Application Scope)。
- 最简单的就是使用单例模式或者静态单例模式
-
SqlSession(相当于从连接池中获取一个连接)
-
连接到连接池的一个请求,相当于一个数据库连接(Connnection对象)
-
SqlSession 的实例不是线程安全的,因此是不能被共享的,它的最佳的作用域是请求或方法作用域
-
用完之后需要赶紧关闭,否则资源被占用。用 try…catch…finally… 语句来保证其正确关闭。
可以在一个事务里面执行多条 SQL,然后通过它的 commit、rollback 等方法,提交或者回滚事务。
-
一个 SqlSession 可以多次使用它的 getMapper 方法,获取多个 mapper 接口实例
-
-
打个比方:
-
SqlSessionFactoryBuilder 是造车公司
-
造了 100 台车,然后卖给租车公司(SQLSessionFactory),然后倒闭
-
SQLSession 用户 租车,使用车
-
mapper 用户的使用,用户租到车之后可以开去这,开去那,任凭使用
-
用户(SQLSession) 执行完想做的事之后,必须归还 “汽车” 给租车公司(SQLSessionFactory)
-
这里面的每一个 mapper 就代表一个具体的业务。