如何获得Mybatis?
<dependency>
<groupId>org.mybatisgroupId>
<artifactId>mybatisartifactId>
<version>3.5.3version>
dependency>
数据持久化
为什么需要持久化?
有一些对象,不能让他丢掉。
内存太贵了
Dao层、Service层、Controller层…
思路:搭建环境–>导入Mybatis–>编写代码–>测试!
搭建数据库
新建Maven项目
导入Maven依赖
<dependencies>
<dependency>
<groupId>mysqlgroupId>
<artifactId>mysql-connector-javaartifactId>
<version>8.0.15version>
dependency>
<dependency>
<groupId>org.mybatisgroupId>
<artifactId>mybatisartifactId>
<version>3.5.2version>
dependency>
<dependency>
<groupId>junitgroupId>
<artifactId>junitartifactId>
<version>4.12version>
dependency>
dependencies>
<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=UTC"/>
<property name="username" value="root"/>
<property name="password" value="q1314159"/>
dataSource>
environment>
environments>
<mappers>
<mapper resource="com/atctbu/dao/UserMapper.xml"/>
mappers>
configuration>
package com.atctbu.utils;
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 java.io.IOException;
import java.io.InputStream;
//sqlSessionFactory --> sqlSession
public class MybatisUtils {
private static SqlSessionFactory sqlSessionFactory;
//初试就加载
static{
try {
//官网上拿的,使用Mybatis第一步,获取SqlSessionFactory对象
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
//既然有了 SqlSessionFactory,顾名思义,我们可以从中获得 SqlSession 的实例。
// SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。
// 你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。例如:
public static SqlSession getSqlSession(){
// SqlSession sqlSession = sqlSessionFactory.openSession();
// return sqlSession;
return sqlSessionFactory.openSession();
}
}
package com.atctbu.pojo;
//实体类
public class User {
private int id;
private String name;
private String pwd;
public User() {
}
public User(int id, String name, String pwd) {
this.id = id;
this.name = name;
this.pwd = pwd;
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPwd() {
return pwd;
}
public void setPwd(String pwd) {
this.pwd = pwd;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
", pwd='" + pwd + '\'' +
'}';
}
}
package com.atctbu.dao;
import com.atctbu.pojo.User;
import java.util.List;
public interface UserDao {
List<User> getUserList();
}
<?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=绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.atctbu.dao.UserDao">
<!--select=查询语句:id对应原来的方法名字;resultType:返回结果-->
<select id="getUserList" resultType="com.atctbu.pojo.User">
<!--执行SQL的语句-->
select * from mybatis.user
</select>
</mapper>
注意点:org.apache.ibatis.binding.BindingException: Type interface com.atctbu.dao.UserDao is not known to the MapperRegistry.
绑定异常:MapperRegistry未注册
<mappers>
<mapper resource="com/atctbu/dao/UserMapper.xml"/>
mappers>
The error may exist in com/atctbu/dao/UserMapper.xml
maven由于他的约定大于配置,我们之后可以能遇到我们写的配置文件,无法被导出或者生效的问题,解决方案:
<build>
<resources>
<resource>
<directory>src/main/resourcesdirectory>
<includes>
<include>**/*.propertiesinclude>
<include>**/*.xmlinclude>
includes>
<filtering>falsefiltering>
resource>
<resource>
<directory>src/main/javadirectory>
<includes>
<include>**/*.propertiesinclude>
<include>**/*.xmlinclude>
includes>
<filtering>falsefiltering>
resource>
resources>
build>
package com.atctbu.dao;
import com.atctbu.pojo.User;
import com.atctbu.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.List;
public class UserDaoTest {
@Test
public void test(){
//第一步:获取SqlSession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
//方式一:执行SQL
/*第二种方法有很多优势,首先它不依赖于字符串字面值,会更安全一点;
其次,如果你的 IDE 有代码补全功能,那么代码补全可以帮你快速选择到映射好的 SQL 语句*/
/*UserDao userDao = sqlSession.getMapper(UserDao.class);
List userList = userDao.getUserList();*/
//方式二:不推荐使用
List<User> userList = sqlSession.selectList("com.atctbu.dao.UserDao.getUserList");
for (User user : userList) {
System.out.println(user);
}
//关闭sqlSession
sqlSession.close();
}
}
/*
User{id=1, name='何锦涛', pwd='123456'}
User{id=2, name='严瑶', pwd='123456'}
User{id=3, name='李四', pwd='123456'}
*/
可能遇到的问题:
1.配置文件没有注册
2.绑定接口错误
3.方法名不对
4.返回类型不对
5.Maven导出资源问题
这个类可以被实例化、使用和丢弃,一旦创建了 SqlSessionFactory,就不再需要它了。 因此 SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域(也就是局部方法变量)。 你可以重用 SqlSessionFactoryBuilder 来创建多个 SqlSessionFactory 实例,但最好还是不要一直保留着它,以保证所有的 XML 解析资源可以被释放给更重要的事情。
SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例。 使用 SqlSessionFactory 的最佳实践是在应用运行期间不要重复创建多次,多次重建 SqlSessionFactory 被视为一种代码“坏习惯”。因此 SqlSessionFactory 的最佳作用域是应用作用域。 有很多方法可以做到,最简单的就是使用单例模式或者静态单例模式。
每个线程都应该有它自己的 SqlSession 实例。SqlSession 的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或方法作用域。 绝对不能将 SqlSession 实例的引用放在一个类的静态域,甚至一个类的实例变量也不行。 也绝不能将 SqlSession 实例的引用放在任何类型的托管作用域中,比如 Servlet 框架中的 HttpSession。 如果你现在正在使用一种 Web 框架,考虑将 SqlSession 放在一个和 HTTP 请求相似的作用域中。 换句话说,每次收到 HTTP 请求,就可以打开一个 SqlSession,返回一个响应后,就关闭它。 这个关闭操作很重要,为了确保每次都能执行关闭操作,你应该把这个关闭操作放到 finally 块中。 下面的示例就是一个确保 SqlSession 关闭的标准模式:
try (SqlSession session = sqlSessionFactory.openSession()) {
// 你的应用逻辑代码
}
namespace中的包名要和Dao/Mapper接口的包名一致!
<mapper namespace="com.atctbu.dao.UserMapper">
<select id="getUserList" resultType="com.atctbu.pojo.User">
select * from mybatis.user
select>
mapper>
选择,查询语句;
<mapper namespace="com.atctbu.dao.UserDao">
<select id="getUserList" resultType="com.atctbu.pojo.User">
select * from mybatis.user
select>
mapper>
package com.atctbu.dao;
import com.atctbu.pojo.User;
import com.atctbu.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.List;
public class UserDaoTest {
@Test
public void getUserById(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User userById = mapper.getUserById(1);
System.out.println(userById);
sqlSession.close();
}
}
UserMapper.xml
<mapper namespace="com.atctbu.dao.UserMapper">
<select id="getUserList" resultType="com.atctbu.pojo.User">
select * from mybatis.user
select>
<select id="getUserById" parameterType="int" resultType="com.atctbu.pojo.User">
select * from mybatis.user where id=#{id}
select>
mapper>
接口类UserMapper
package com.atctbu.dao;
import com.atctbu.pojo.User;
import java.util.List;
public interface UserMapper {
//查询全部用户
List<User> getUserList();
//根据ID查询用户
User getUserById(int id);
}
3.3、insert
注意:增删改需要提交事务
接口类
package com.atctbu.dao;
import com.atctbu.pojo.User;
import java.util.List;
public interface UserMapper {
//查询全部用户
List<User> getUserList();
//根据ID查询用户
User getUserById(int id);
//增加一个用户
int addUser(User user);
}
UserMapper.xml
<mapper namespace="com.atctbu.dao.UserMapper">
<select id="getUserList" resultType="com.atctbu.pojo.User">
select * from mybatis.user
select>
<select id="getUserById" parameterType="int" resultType="com.atctbu.pojo.User">
select * from mybatis.user where id=#{id}
select>
<insert id="addUser" parameterType="com.atctbu.pojo.User">
insert into mybatis.user (id, name, pwd) values (#{id},#{name},#{pwd})
insert>
mapper>
测试类:注意需要提交事务
package com.atctbu.dao;
import com.atctbu.pojo.User;
import com.atctbu.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.junit.Test;
import java.util.List;
public class UserDaoTest {
//增删改需要提交事务
@Test
public void addUser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
int number = mapper.addUser(new User(4,"李四","123456"));
if (number>0){
System.out.println("插入成功");
}
//提交事务
sqlSession.commit();
sqlSession.close();
}
}
接口类
package com.atctbu.dao;
import com.atctbu.pojo.User;
import java.util.List;
public interface UserMapper {
//查询全部用户
List<User> getUserList();
//根据ID查询用户
User getUserById(int id);
//增加一个用户
int addUser(User user);
//修改用户
int updateUser(User user);
}
UserMapper.xml
<mapper namespace="com.atctbu.dao.UserMapper">
<select id="getUserList" resultType="com.atctbu.pojo.User">
select * from mybatis.user
select>
<select id="getUserById" parameterType="int" resultType="com.atctbu.pojo.User">
select * from mybatis.user where id=#{id}
select>
<insert id="addUser" parameterType="com.atctbu.pojo.User">
insert into mybatis.user (id, name, pwd) values (#{id},#{name},#{pwd})
insert>
<update id="updateUser" parameterType="com.atctbu.pojo.User">
update mybatis.user set name=#{name},pwd=#{pwd} where id=#{id};
update>
mapper>
测试类
package com.atctbu.dao;
import com.atctbu.pojo.User;
import com.atctbu.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.junit.Test;
import java.util.List;
public class UserDaoTest {
//更新操作
@Test
public void updateUser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
mapper.updateUser(new User(4,"张三","123123"));
//提交事务
sqlSession.commit();
sqlSession.close();
}
}
接口类
package com.atctbu.dao;
import com.atctbu.pojo.User;
import java.util.List;
public interface UserMapper {
//查询全部用户
List<User> getUserList();
//根据ID查询用户
User getUserById(int id);
//增加一个用户
int addUser(User user);
//修改用户
int updateUser(User user);
//删除用户
int deleteUser(int id);
}
UserMapper.xml
<mapper namespace="com.atctbu.dao.UserMapper">
<select id="getUserList" resultType="com.atctbu.pojo.User">
select * from mybatis.user
select>
<select id="getUserById" parameterType="int" resultType="com.atctbu.pojo.User">
select * from mybatis.user where id=#{id}
select>
<insert id="addUser" parameterType="com.atctbu.pojo.User">
insert into mybatis.user (id, name, pwd) values (#{id},#{name},#{pwd})
insert>
<update id="updateUser" parameterType="com.atctbu.pojo.User">
update mybatis.user set name=#{name},pwd=#{pwd} where id=#{id}
update>
<delete id="deleteUser" parameterType="int">
delete from mybatis.user where id=#{id}
delete>
mapper>
测试类
package com.atctbu.dao;
import com.atctbu.pojo.User;
import com.atctbu.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.junit.Test;
import java.util.List;
public class UserDaoTest {
//删除操作
@Test
public void deleteUser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
mapper.deleteUser(4);
//提交事务
sqlSession.commit();
sqlSession.close();
}
}
假设,我们的实体类,或者数据库中的表,字段或者参数过多,我们应当考虑使用map
//万能的Map
User addUser2(Map<String,Object> map);
<insert id="addUser2" parameterType="map">
insert into mybatis.user (id, pwd) values (#{userId},#{password})
insert>
//map
@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("userName","赵六");
map.put("password","23333333");
mapper.addUser2(map);
//提交事务
sqlSession.commit();
sqlSession.close();
}
Map传递参数,直接在sql中取出key即可!【parameterType=“map”】
对象传递参数,直接在sql中取对象的属性即可!【parameterType=“Object”】
只有一个基本类型参数的情况下,可以直接在sql中取到!
多个参数用Map,或者注解!
User getUserById2(Map<String,Object> map);
@Test
public void getUserById2(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
Map<String, Object> map = new HashMap<String, Object>();
map.put("helloId",1);
mapper.addUser2(map);
sqlSession.close();
}
<select id="getUserById2" parameterType="map" resultType="com.atctbu.pojo.User">
select * from mybatis.user where id=#{helloId} and name=#{name}
select>
@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(userList);
}
sqlSession.close();
}
<select id="getUserLike" resultType="com.atctbu.pojo.User">
select * from mybatis.user where name like "%"#{value}"%"
select>
mybatis可以配置成适应多种环境
不过要记住,尽管可以配置多个环境,但每个SqlSessionFactory实例只能选择一种环境
学会使用配置多套运行环境
Mybatis默认事务管理就是JDBC,连接池:POOLED
我们可以通过properties属性来实现引用配置文件
这些属性可以在外部进行配置,并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性,也可以在 properties 元素的子元素中设置。【db.properties】
例如
<properties resource="org/mybatis/example/config.properties">
<property name="username" value="dev_user"/>
<property name="password" value="F2Fa3!33TYyg"/>
properties>
设置好的属性可以在整个配置文件中用来替换需要动态配置的属性值。比如:
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
dataSource>
编写一个配置文件:db.properties(这里需要注意是使用&,而不是&
)
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC
username=root
password=q1314159
在核心配置文件中引入,在xml中,所有的标签都可以规定顺序,必须按照顺序写
<configuration>
<properties resource="db.properties"/>
<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=UTC"/>
<property name="username" value="root"/>
<property name="password" value="q1314159"/>
dataSource>
environment>
environments>
<mappers>
<mapper resource="com/atctbu/hjt/dao/UserMapper.xml"/>
mappers>
configuration>
引入后
<configuration>
<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="com/atctbu/hjt/dao/UserMapper.xml"/>
mappers>
configuration>
还可以这样(把password和username去掉)
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC
通过property引入()
<configuration>
<properties resource="db.properties">
<property name="username" value="root"/>
<property name="password" value="q1314159"/>
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="com/atctbu/hjt/dao/UserMapper.xml"/>
mappers>
configuration>
如果配置文件和property里的密码不同,优先使用配置文件里的
类型别名可为 Java 类型设置一个缩写名字。 它仅用于 XML 配置,意在降低冗余的全限定类名书写。例如:
<typeAliases>
<typeAlias alias="Author" type="domain.blog.Author"/>
<typeAlias alias="Blog" type="domain.blog.Blog"/>
<typeAlias alias="Comment" type="domain.blog.Comment"/>
<typeAlias alias="Post" type="domain.blog.Post"/>
<typeAlias alias="Section" type="domain.blog.Section"/>
<typeAlias alias="Tag" type="domain.blog.Tag"/>
typeAliases>
当这样配置时,Blog
可以用在任何使用 domain.blog.Blog
的地方。
也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean,比如:
扫描实体类的包,它的默认别名就为这个类的类名,首字母小写!(大写也可以,建议小写)
@Alias("author")
public class Author {
...
}
给实体类起别名,第一种方式:
<typeAliases>
<typeAlias type="com.atctbu.hjt.pojo.User" alias="User"/>
typeAliases>
使用别名
<mapper namespace="com.atctbu.hjt.dao.UserMapper">
<select id="getUserList" resultType="User">
select * from mybatis.user
select>
mapper>
给实体类起别名,第二种方式:
<typeAliases>
<package name="com.atctbu.hjt.pojo" />
typeAliases>
使用别名
<mapper namespace="com.atctbu.hjt.dao.UserMapper">
<select id="getUserList" resultType="User">
select * from mybatis.user
select>
mapper>
总结:
实体类比较少的时候,使用第一种方式。
如果实体类十分多,建议使用第二种。
第一种可以DIY别名,第二种不行。(第二种扫描包的时候需要用注解取别名)
例:通过注解DIY别名
package com.atctbu.hjt.pojo;
import org.apache.ibatis.type.Alias;
@Alias("hello")
public class User {
private int id;
private String name;
private String pwd;
使用别名
<mapper namespace="com.atctbu.hjt.dao.UserMapper">
<select id="getUserList" resultType="hello">
select * from mybatis.user
select>
mapper>
下面是一些为常见的 Java 类型内建的类型别名。它们都是不区分大小写的,注意,为了应对原始类型的命名重复,采取了特殊的命名风格。
别名 | 映射的类型 |
---|---|
_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 |
object | Object |
map | Map |
hashmap | HashMap |
list | List |
arraylist | ArrayList |
collection | Collection |
iterator | Iterator |
这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为。 下表描述了设置中各项设置的含义、默认值等。
设置名 | 描述 | 有效值 | 默认值 |
---|---|---|---|
cacheEnabled | 全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。 | true | false | true |
lazyLoadingEnabled | 延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。 |
true | false | false |
aggressiveLazyLoading | 开启时,任一方法的调用都会加载该对象的所有延迟加载属性。 否则,每个延迟加载属性会按需加载(参考 lazyLoadTriggerMethods )。 |
true | false | false (在 3.4.1 及之前的版本中默认为 true) |
multipleResultSetsEnabled | 是否允许单个语句返回多结果集(需要数据库驱动支持)。 | true | false | true |
useColumnLabel | 使用列标签代替列名。实际表现依赖于数据库驱动,具体可参考数据库驱动的相关文档,或通过对比测试来观察。 | true | false | true |
useGeneratedKeys | 允许 JDBC 支持自动生成主键,需要数据库驱动支持。如果设置为 true,将强制使用自动生成主键。尽管一些数据库驱动不支持此特性,但仍可正常工作(如 Derby)。 | true | false | False |
autoMappingBehavior | 指定 MyBatis 应如何自动映射列到字段或属性。 NONE 表示关闭自动映射;PARTIAL 只会自动映射没有定义嵌套结果映射的字段。 FULL 会自动映射任何复杂的结果集(无论是否嵌套)。 | NONE, PARTIAL, FULL | PARTIAL |
autoMappingUnknownColumnBehavior | 指定发现自动映射目标未知列(或未知属性类型)的行为。NONE : 不做任何反应WARNING : 输出警告日志('org.apache.ibatis.session.AutoMappingUnknownColumnBehavior' 的日志等级必须设置为 WARN )FAILING : 映射失败 (抛出 SqlSessionException ) |
NONE, WARNING, FAILING | NONE |
defaultExecutorType | 配置默认的执行器。SIMPLE 就是普通的执行器;REUSE 执行器会重用预处理语句(PreparedStatement); BATCH 执行器不仅重用语句还会执行批量更新。 | SIMPLE REUSE BATCH | SIMPLE |
defaultStatementTimeout | 设置超时时间,它决定数据库驱动等待数据库响应的秒数。 | 任意正整数 | 未设置 (null) |
defaultFetchSize | 为驱动的结果集获取数量(fetchSize)设置一个建议值。此参数只可以在查询设置中被覆盖。 | 任意正整数 | 未设置 (null) |
defaultResultSetType | 指定语句默认的滚动策略。(新增于 3.5.2) | FORWARD_ONLY | SCROLL_SENSITIVE | SCROLL_INSENSITIVE | DEFAULT(等同于未设置) | 未设置 (null) |
safeRowBoundsEnabled | 是否允许在嵌套语句中使用分页(RowBounds)。如果允许使用则设置为 false。 | true | false | False |
safeResultHandlerEnabled | 是否允许在嵌套语句中使用结果处理器(ResultHandler)。如果允许使用则设置为 false。 | true | false | True |
mapUnderscoreToCamelCase | 是否开启驼峰命名自动映射,即从经典数据库列名 A_COLUMN 映射到经典 Java 属性名 aColumn。 | true | false | False |
localCacheScope | MyBatis 利用本地缓存机制(Local Cache)防止循环引用和加速重复的嵌套查询。 默认值为 SESSION,会缓存一个会话中执行的所有查询。 若设置值为 STATEMENT,本地缓存将仅用于执行语句,对相同 SqlSession 的不同查询将不会进行缓存。 | SESSION | STATEMENT | SESSION |
jdbcTypeForNull | 当没有为参数指定特定的 JDBC 类型时,空值的默认 JDBC 类型。 某些数据库驱动需要指定列的 JDBC 类型,多数情况直接用一般类型即可,比如 NULL、VARCHAR 或 OTHER。 | JdbcType 常量,常用值:NULL、VARCHAR 或 OTHER。 | OTHER |
lazyLoadTriggerMethods | 指定对象的哪些方法触发一次延迟加载。 | 用逗号分隔的方法列表。 | equals,clone,hashCode,toString |
defaultScriptingLanguage | 指定动态 SQL 生成使用的默认脚本语言。 | 一个类型别名或全限定类名。 | org.apache.ibatis.scripting.xmltags.XMLLanguageDriver |
defaultEnumTypeHandler | 指定 Enum 使用的默认 TypeHandler 。(新增于 3.4.5) |
一个类型别名或全限定类名。 | org.apache.ibatis.type.EnumTypeHandler |
callSettersOnNulls | 指定当结果集中值为 null 的时候是否调用映射对象的 setter(map 对象时为 put)方法,这在依赖于 Map.keySet() 或 null 值进行初始化时比较有用。注意基本类型(int、boolean 等)是不能设置成 null 的。 | true | false | false |
returnInstanceForEmptyRow | 当返回行的所有列都是空时,MyBatis默认返回 null 。 当开启这个设置时,MyBatis会返回一个空实例。 请注意,它也适用于嵌套的结果集(如集合或关联)。(新增于 3.4.2) |
true | false | false |
logPrefix | 指定 MyBatis 增加到日志名称的前缀。 | 任何字符串 | 未设置 |
logImpl | 指定 MyBatis 所用日志的具体实现,未指定时将自动查找。 | SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING | 未设置 |
proxyFactory | 指定 Mybatis 创建可延迟加载对象所用到的代理工具。 | CGLIB | JAVASSIST | JAVASSIST (MyBatis 3.3 以上) |
vfsImpl | 指定 VFS 的实现 | 自定义 VFS 的实现的类全限定名,以逗号分隔。 | 未设置 |
useActualParamName | 允许使用方法签名中的名称作为语句参数名称。 为了使用该特性,你的项目必须采用 Java 8 编译,并且加上 -parameters 选项。(新增于 3.4.1) |
true | false | true |
configurationFactory | 指定一个提供 Configuration 实例的类。 这个被返回的 Configuration 实例用来加载被反序列化对象的延迟加载属性值。 这个类必须包含一个签名为static Configuration getConfiguration() 的方法。(新增于 3.2.3) |
一个类型别名或完全限定类名。 | 未设置 |
shrinkWhitespacesInSql | 从SQL中删除多余的空格字符。请注意,这也会影响SQL中的文字字符串。 (新增于 3.5.5) | true | false | false |
defaultSqlProviderType | Specifies an sql provider class that holds provider method (Since 3.5.6). This class apply to the type (or value ) attribute on sql provider annotation(e.g. @SelectProvider ), when these attribute was omitted. |
A type alias or fully qualified class name |
一个配置完整的 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>
重要的:
cacheEnabled
全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。
true | false true
lazyLoadingEnabled
延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType
属性来覆盖该项的开关状态。
true | false false
logImpl
指定 MyBatis 所用日志的具体实现,未指定时将自动查找。
SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING
MapperRegistry:注册绑定我们的Mapper文件;官网有四种方式,以下列出三种。
第一种;
<mappers>
<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
<mapper resource="org/mybatis/builder/BlogMapper.xml"/>
<mapper resource="org/mybatis/builder/PostMapper.xml"/>
mappers>
第二种;
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
<mapper class="org.mybatis.builder.BlogMapper"/>
<mapper class="org.mybatis.builder.PostMapper"/>
mappers>
第三种;
<mappers>
<package name="org.mybatis.builder"/>
mappers>
例子:
方式一:
<mappers>
<mapper resource="com/atctbu/hjt/dao/UserMapper.xml"/>
mappers>
方式二:使用class文件绑定注册
<mappers>
<mapper class="com.atctbu.hjt.dao.UserMapper"/>
mappers>
方式三:使用扫描包进行注入
<mappers>
<package name="com.atctbu.hjt.dao"/>
mappers>
注意点:
练习时间:
生命周期和作用域是至关重要的,因为错误的使用会导致非常严重的并发问题。
SqlSessionFactoryBuilder:
SqlSessionFactory
SqlSession
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-TP3THrEg-1616653990846)(https://m.qpic.cn/psc?/V11Mzdsz1sKJyi/ruAMsa53pVQWN7FLK88i5vbYkDGJzw6nA6Bznr71vSsvl6cDmNDgYyYL1s1g7it1jjARwqiDNwmXFVmi92UQttfyJxciDuARfNOM2pnAPmU!/b&bo=nwJWAQAAAAADB.g!&rf=viewer_4)]
这里面每一个Mapper,就代表一个具体
数据库中的字段
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-0FsRENsA-1616653990861)(http://m.qpic.cn/psc?/V11Mzdsz1sKJyi/45NBuzDIW489QBoVep5mcS7ilODLXqehLNre7faJumymKcYEMELp4wReKHmIGdJ*wj6lliKJsU8mj3NLa3K9urJcUZpYXQy12SLYQpGWzlI!/b&bo=1QB8AAAAAAADF5s!&rf=viewer_4)]
新建一个项目,拷贝之前的,测试实体类字段不一致的情况
public class User {
private int id;
private String name;
private String password;
这个时候查出来password
User{
id=1, name='何锦涛', password='null'}
原因
select * from mybatis.user where id=#{id}
//类型处理器,找属性pwd去了,找不到
//完整应该为
select id,name,pwd from mybatis.user where id=#{id}
解决方法:
select id,name,pwd as password from mybatis.user where id=#{id}
结果集映射
resultMap
元素是 MyBatis 中最重要最强大的元素。它可以让你从 90% 的 JDBC ResultSets
数据提取代码中解放出来,并在一些情形下允许你进行一些 JDBC 不支持的操作。
id name pwd
id name password
<mapper namespace="com.atctbu.hjt.dao.UserMapper">
<resultMap id="UserMap" type="User">
<result column="id" property="id"/>
<result column="name" property="name"/>
<result column="pwd" property="password"/>
resultMap>
<select id="getUserById" parameterType="int" resultMap="UserMap">
select * from mybatis.user where id=#{id}
select>
mapper>
resultMap
元素是 MyBatis 中最重要最强大的元素ResultMap
的优秀之处——你完全可以不用显式地配置它们(相同的可以不写)。resultMap
属性就行了(注意我们去掉了 resultType
属性)。比如:<mapper namespace="com.atctbu.hjt.dao.UserMapper">
<resultMap id="UserMap" type="User">
<result column="pwd" property="password"/>
resultMap>
<select id="getUserById" parameterType="int" resultMap="UserMap">
select * from mybatis.user where id=#{id}
select>
mapper>
如果一个数据库操作,出现了异常,我们需要排错。日志就是最好的助手!
曾经:sout、debug
现在:日志工厂
设置名 | 描述 | 有效值 | 默认值 |
---|---|---|---|
logImpl | 描述指定 MyBatis 所用日志的具体实现,未指定时将自动查找。 | SLF4J | LOG4J | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING | 未设置 |
在Mybatis中具体使用哪一日志实现,在设置中设定!
STDOUT_LOGGING标准日志输出:什么都不用配,拿过去就能用
<configuration>
<properties resource="db.properties">
<property name="username" value="root"/>
<property name="password" value="q1314159"/>
properties>
<settings>
<setting name="logImpl" value="STDOUT_LOGGING"/>
settings>
<typeAliases>
<package name="com.atctbu.hjt.pojo" />
typeAliases>
<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>
<package name="com.atctbu.hjt.dao"/>
mappers>
configuration>
打印的日志:
Opening JDBC Connection
Created connection 612097453.
Setting autocommit to false on JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@247bddad]
==> Preparing: select * from mybatis.user where id=?
==> Parameters: 1(Integer)
<== Columns: id, name, pwd
<== Row: 1, 何锦涛, 123456
<== Total: 1
User{id=1, name='何锦涛', password='123456'}
Resetting autocommit to true on JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@247bddad]
Closing JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@247bddad]
Returned connection 612097453 to pool.
什么是log4j:
在pom.xml导入依赖
<dependency>
<groupId>log4jgroupId>
<artifactId>log4jartifactId>
<version>1.2.17version>
dependency>
#将等级为DEBUG的日志信息输出到console和file这两个目的地,console和file的定义在下面的代码
log4j.rootLogger=DEBUG,console,file
#控制台输出的相关设置
log4j.appender.console = org.apache.log4j.ConsoleAppender
log4j.appender.console.Target = System.out
log4j.appender.console.Threshold=DEBUG
log4j.appender.console.layout = org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=[%c]-%m%n
#文件输出的相关设置
log4j.appender.file = org.apache.log4j.RollingFileAppender
log4j.appender.file.File=./log/hjt.log
log4j.appender.file.MaxFileSize=10mb
log4j.appender.file.Threshold=DEBUG
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=[%p][%d{yy-MM-dd}][%c]%m%n
#日志输出级别
log4j.logger.org.mybatis=DEBUG
log4j.logger.java.sql=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.ResultSet=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG
<configuration>
<properties resource="db.properties">
<property name="username" value="root"/>
<property name="password" value="q1314159"/>
properties>
<settings>
<setting name="logImpl" value="LOG4J"/>
settings>
<typeAliases>
<package name="com.atctbu.hjt.pojo" />
typeAliases>
configuration>
直接测试运行刚才的查询
[org.apache.ibatis.logging.LogFactory]-Logging initialized using 'class org.apache.ibatis.logging.log4j.Log4jImpl' adapter.
[org.apache.ibatis.logging.LogFactory]-Logging initialized using 'class org.apache.ibatis.logging.log4j.Log4jImpl' adapter.
[org.apache.ibatis.io.VFS]-Class not found: org.jboss.vfs.VFS
[org.apache.ibatis.io.JBoss6VFS]-JBoss 6 VFS API is not available in this environment.
[org.apache.ibatis.io.VFS]-Class not found: org.jboss.vfs.VirtualFile
[org.apache.ibatis.io.VFS]-VFS implementation org.apache.ibatis.io.JBoss6VFS is not valid in this environment.
[org.apache.ibatis.io.VFS]-Using VFS adapter org.apache.ibatis.io.DefaultVFS
[org.apache.ibatis.io.DefaultVFS]-Find JAR URL: file:/F:/CTBU/Mybatis_Test/mybatis-04/mybatis-04-1/target/classes/hjt/pojo
[org.apache.ibatis.io.DefaultVFS]-Not a JAR: file:/F:/CTBU/Mybatis_Test/mybatis-04/mybatis-04-1/target/classes/hjt/pojo
[org.apache.ibatis.io.DefaultVFS]-Reader entry: User.class
[org.apache.ibatis.io.DefaultVFS]-Listing file:/F:/CTBU/Mybatis_Test/mybatis-04/mybatis-04-1/target/classes/hjt/pojo
[org.apache.ibatis.io.DefaultVFS]-Find JAR URL: file:/F:/CTBU/Mybatis_Test/mybatis-04/mybatis-04-1/target/classes/hjt/pojo/User.class
[org.apache.ibatis.io.DefaultVFS]-Not a JAR: file:/F:/CTBU/Mybatis_Test/mybatis-04/mybatis-04-1/target/classes/hjt/pojo/User.class
[org.apache.ibatis.io.DefaultVFS]-Reader entry: ���� 1 <
[org.apache.ibatis.io.ResolverUtil]-Checking to see if class hjt.pojo.User matches criteria [is assignable to Object]
[org.apache.ibatis.datasource.pooled.PooledDataSource]-PooledDataSource forcefully closed/removed all connections.
[org.apache.ibatis.datasource.pooled.PooledDataSource]-PooledDataSource forcefully closed/removed all connections.
[org.apache.ibatis.datasource.pooled.PooledDataSource]-PooledDataSource forcefully closed/removed all connections.
[org.apache.ibatis.datasource.pooled.PooledDataSource]-PooledDataSource forcefully closed/removed all connections.
[org.apache.ibatis.io.DefaultVFS]-Find JAR URL: file:/F:/CTBU/Mybatis_Test/mybatis-04/mybatis-04-1/target/classes/hjt/dao
[org.apache.ibatis.io.DefaultVFS]-Not a JAR: file:/F:/CTBU/Mybatis_Test/mybatis-04/mybatis-04-1/target/classes/hjt/dao
[org.apache.ibatis.io.DefaultVFS]-Reader entry: UserMapper.class
[org.apache.ibatis.io.DefaultVFS]-Reader entry: UserMapper.xml
[org.apache.ibatis.io.DefaultVFS]-Listing file:/F:/CTBU/Mybatis_Test/mybatis-04/mybatis-04-1/target/classes/hjt/dao
[org.apache.ibatis.io.DefaultVFS]-Find JAR URL: file:/F:/CTBU/Mybatis_Test/mybatis-04/mybatis-04-1/target/classes/hjt/dao/UserMapper.class
[org.apache.ibatis.io.DefaultVFS]-Not a JAR: file:/F:/CTBU/Mybatis_Test/mybatis-04/mybatis-04-1/target/classes/hjt/dao/UserMapper.class
[org.apache.ibatis.io.DefaultVFS]-Reader entry: ���� 1 getUserById (I)Lhjt/pojo/User;
[org.apache.ibatis.io.DefaultVFS]-Find JAR URL: file:/F:/CTBU/Mybatis_Test/mybatis-04/mybatis-04-1/target/classes/hjt/dao/UserMapper.xml
[org.apache.ibatis.io.DefaultVFS]-Not a JAR: file:/F:/CTBU/Mybatis_Test/mybatis-04/mybatis-04-1/target/classes/hjt/dao/UserMapper.xml
[org.apache.ibatis.io.DefaultVFS]-Reader entry:
[org.apache.ibatis.io.ResolverUtil]-Checking to see if class hjt.dao.UserMapper matches criteria [is assignable to Object]
[org.apache.ibatis.transaction.jdbc.JdbcTransaction]-Opening JDBC Connection
[org.apache.ibatis.datasource.pooled.PooledDataSource]-Created connection 1995250556.
[org.apache.ibatis.transaction.jdbc.JdbcTransaction]-Setting autocommit to false on JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@76ed1b7c]
[hjt.dao.UserMapper.getUserById]-==> Preparing: select * from mybatis.user where id=?
[hjt.dao.UserMapper.getUserById]-==> Parameters: 1(Integer)
[hjt.dao.UserMapper.getUserById]-<== Total: 1
User{id=1, name='何锦涛', password='123456'}
[org.apache.ibatis.transaction.jdbc.JdbcTransaction]-Resetting autocommit to true on JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@76ed1b7c]
[org.apache.ibatis.transaction.jdbc.JdbcTransaction]-Closing JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@76ed1b7c]
[org.apache.ibatis.datasource.pooled.PooledDataSource]-Returned connection 1995250556 to pool.
简单使用
import org.apache.log4j.Logger;
static Logger logger = Logger.getLogger(UserDaoTest.class);
@Test
public void testlog4j(){
logger.info("info:进入了testLog4j方法");
logger.debug("debug:进入了testLog4j方法");
logger.error("error:进入了testLog4j方法");
}
[dao.UserDaoTest]-info:进入了testLog4j方法
[dao.UserDaoTest]-debug:进入了testLog4j方法
[dao.UserDaoTest]-error:进入了testLog4j方法