配置解析
1. 核心配置文件
- mybatis-config.xml
configuration(配置)
properties(属性)
settings(设置)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境配置)
environment(环境变量)
transactionManager(事务管理器)
dataSource(数据源)
databaseIdProvider(数据库厂商标识)
mappers(映射器)
2. 环境配置(environments)
MyBatis 可以配置成适应多种环境
不过要记住:尽管可以配置多个环境,但每个 SqlSessionFactory 实例只能选择一种环境。
Mybatis 默认的事务管理器是JDBC,连接池:POOLED
3. 属性
我们可以通过properties属性来引用配置文件
这些属性可以在外部进行配置,并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性,也可以在 properties 元素的子元素中设置。 (db.properties)
编写一个配置文件
db.properties
driver=com.mysql.jdbc.Driver
url=jdbc:mysql:///java02?characterEncoding=utf8
username=root
password=123456
在核心配置文件中引入
mybatis-config.xml (同时有的话,优先走外面properties)
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!--引入外部配置文件-->
<!--<properties resource="db.properties"/>-->
<properties resource="db.properties">
<property name="username" value="root"></property>
<property name="password" value="hdk123"></property>
</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>
<!--每一个mapper.xml都需要注册-->
<mappers>
<mapper resource="com/hou/dao/UserMapper.xml"/>
</mappers>
</configuration>
4. 类型别名(typeAliases)
类型别名可为 Java 类型设置一个缩写名字。
<typeAliases>
<typeAlias type="com.hou.pogo.User" alias="User"></typeAlias>
</typeAliases>
扫描实体类的包,默认别名就为这个类的类名首字母小写
<typeAliases>
<package name="com.hou.pogo"></package>
</typeAliases>
在实体类,比较少的时候使用第一种,实体类多使用第二种。
第一种可以自定义,第二则不行,但是 若有注解,则别名为其注解值 。
@Alias("hello")
public class User {
}
5. 设置
设置名 | 描述 | 有效值 | 默认值 |
---|---|---|---|
cacheEnabled | 全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。 | true | false | true |
lazyLoadingEnabled | 延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。 | true | false | false |
logImpl | 指定 MyBatis 所用日志的具体实现,未指定时将自动查找。 | SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING | 未设置 |
6. 其他
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
- mybatis-generator-core
- mybatis-plus
- 通用mapper
7. 映射器
ResultMap:结果集映射
id name pwd
id name passwrord
解决属性名和字段名不一致的问题
数据库名和实体类名不一致
resultMap
元素是 MyBatis 中最重要最强大的元素。
ResultMap 的设计思想是,对简单的语句做到零配置,对于复杂一点的语句,只需要描述语句之间的关系就行了。
举例:对于简单的语句,比如数据库字段和属性一致不用管,复杂:描述语句之间的关系就行
方式一: [推荐使用]
<mappers>
<mapper resource="com/hou/dao/UserMapper.xml"/>
</mappers>
方式二:
<mappers>
<mapper class="com.hou.dao.UserMapper" />
</mappers>
- 接口和它的Mapper必须同名
- 接口和他的Mapper必须在同一包下
方式三:
<mappers>
<!--<mapper resource="com/hou/dao/UserMapper.xml"/>-->
<!--<mapper class="com.hou.dao.UserMapper" />-->
<package name="com.hou.dao" />
</mappers>
- 接口和它的Mapper必须同名
- 接口和他的Mapper必须在同一包下
8.生命周期和作用域
作用域和生命周期类别是至关重要的,因为错误的使用会导致非常严重的并发问题。
SqlSessionFactoryBuilder:
- 一旦创建了 SqlSessionFactory,就不再需要它了 。
- 局部变量
SqlSessionFactory:
- 就是数据库连接池。
- 一旦被创建就应该在应用的运行期间一直存在 ,没有任何理由丢弃它或重新创建另一个实例 。 多次重建 SqlSessionFactory 被视为一种代码“坏习惯”。
- 因此 SqlSessionFactory 的最佳作用域是应用作用域。
- 最简单的就是使用单例模式或者静态单例模式。
SqlSession:
- 每个线程都应该有它自己的 SqlSession 实例。
- 连接到连接池的请求!
- SqlSession 的实例不是线程安全的,因此是不能被共享的 ,所以它的最佳的作用域是请求或方法作用域。
- 用完之后赶紧关闭,否则资源被占用。
4. 解决属性名和字段名不一致的问题
数据库中的字段
新建一个项目,拷贝之前,测试实体字段不一致的情况
User
package com.hou.pogo;
public class User {
private int id;
private String name;
private String password;
}
问题:
User{id=2, name='wang', password='null'}
解决方法:
核心配置文件
- 起别名
<select id="getUserById" resultType="User"
parameterType="int">
select id,name,pwd as password from mybatis.user where id = #{id}
</select>
- resultMap 结果集映射
<?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绑定一个对应的mapper接口-->
<mapper namespace="com.hou.dao.UserMapper">
<select id="getUserById" resultMap="UserMap" parameterType="int">
select * from mybatis.user where id = #{id}
</select>
<!--结果集映射-->
<resultMap id="UserMap" type="User">
<!--colunm 数据库中的字段,property实体中的属性-->
<result column="id" property="id"></result>
<result column="name" property="name"></result>
<result column="pwd" property="password"></result>
</resultMap>
</mapper>
-
resultMap
元素是 MyBatis 中最重要最强大的元素。 -
ResultMap 的设计思想是,对简单的语句做到零配置,对于复杂一点的语句,只需要描述语句之间的关系就行了。
<resultMap id="UserMap" type="User">
<!--colunm 数据库中的字段,property实体中的属性-->
<!--<result column="id" property="id"></result>-->
<!--<result column="name" property="name"></result>-->
<result column="pwd" property="password"></result>
</resultMap>
5. 日志
1. 日志工厂
如果一个数据库操作出现了异常,我们需要排错。日志就是最好的助手。
曾经:sout,debug
现在:日志工厂
logImpl
- SLF4J
- LOG4J [掌握]
- LOG4J2
- JDK_LOGGING
- COMMONS_LOGGING
- STDOUT_LOGGING [掌握]
- NO_LOGGING
具体使用哪一个,在设置中设定
STDOUT_LOGGING 标志日志输出
mybatis-confi中
<settings>
<setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
2. Log4j
-
先导包
pom.xml下
<dependencies> <!-- https://mvnrepository.com/artifact/log4j/log4j --> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency> </dependencies>
-
新建log4j.properties文件
### set log levels ###
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/hou.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
- 配置实现
<settings>
<setting name="logImpl" value="LOG4J"/>
</settings>
- Log4j使用
package com.hou.dao;
import com.hou.pojo.User;
import com.hou.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.apache.log4j.Logger;
import org.junit.Test;
public class UserDaoTest {
static Logger logger = Logger.getLogger(UserDaoTest.class);
@Test
public void test(){
// 获得sqlsession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
try{
// 1.执行 getmapper
UserMapper userDao = sqlSession.getMapper(UserMapper.class);
logger.info("测试");
User user = userDao.getUserById(2);
System.out.println(user);
}catch(Exception e){
e.printStackTrace();
}finally{
//关闭
sqlSession.close();
}
}
@Test
public void testLog4j(){
logger.info("info:进入了testlog4j");
logger.debug("debug:进入了testlog4j");
logger.error("error:进入了testlog4j");
}
}
6. 分页
1. Limit 分页
语法:
SELECT * from user limit startIndex,pageSize;
SELECT * from user limit 0,2;
package com.hou.dao;
import com.hou.pojo.User;
import java.util.List;
import java.util.Map;
public interface UserMapper {
//根据id查询用户
User getUserById(int id);
List<User> getUserByLimit(Map<String, Integer> map);
}
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绑定一个对应的mapper接口-->
<mapper namespace="com.hou.dao.UserMapper">
<select id="getUserById" resultMap="UserMap"
parameterType="int">
select * from mybatis.user where id = #{id}
</select>
<!--结果集映射-->
<resultMap id="UserMap" type="User">
<!--colunm 数据库中的字段,property实体中的属性-->
<!--<result column="id" property="id"></result>-->
<!--<result column="name" property="name"></result>-->
<result column="pwd" property="password"></result>
</resultMap>
<select id="getUserByLimit" parameterType="map"
resultType="User" resultMap="UserMap">
select * from mybatis.user limit #{startIndex},#{pageSize}
</select>
</mapper>
test类
@Test
public void getByLimit(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
Map<String, Integer> map = new HashMap<String, Integer>();
map.put("startIndex", 1);
map.put("pageSize", 2);
List<User> userList = mapper.getUserByLimit(map);
for(User user:userList){
System.out.println(user);
}
sqlSession.close();
}
2. RowBounds分页
@Test
@Test
public void getUserByRow(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
//RowBounds实现
RowBounds rowBounds = new RowBounds(1, 2);
//通过java代码层面
List<User> userList = sqlSession.selectList
("com.hou.dao.UserMapper.getUserByRowBounds",
null,rowBounds);
for (User user : userList) {
System.out.println(user);
}
sqlSession.close();
}
3. 分页插件
- pageHelper