MyBatis之配置解析

三、配置解析

目录：核心配置文件、环境配置（environments）、属性（properties）、类型别名（typeAliases）、设置（settings）、其它配置、映射器（mappers）、生命周期和作用域、解决解决属性名和字段名不一致的问题（ResultMap）

1.核心配置文件

1）mybatis-config.xml
2）MyBatis 配置文件包含了会深深影响MyBatis行为的设置和属性信息。

• configuration（配置）
• properties（属性）
• settings（设置）
• typeAliases（类型别名）
• typeHandlers（类型处理器）
• objectFactory（对象工厂）
• plugins（插件）
• environments（环境配置）
  • environment（环境变量）
    • transactionManager（事务管理器）
    • dataSource（数据源）
• databaseIdProvider（数据库厂商标识）
• mappers（映射器）

2.环境配置（environments）

MyBatis可以配置成适应多种环境。
不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。

<environments default="development">
  <environment id="development">
    <transactionManager type="JDBC">
      <property name="..." value="..."/>
    </transactionManager>
    <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>

transaction：事务管理器
①JDBC：拥有提交和回滚的事务设置。
②MANAGED：这个几乎没做什么。默认情况下它会关闭连接。然而一些容器并不希望连接被关闭，因此需要将closeConnection属性设置为false来阻止默认的关闭行为。
dataSource：数据源，用于连接数据库，如：DBCP、C3P0，Druid。
它有三种内建的数据源类型（也就是 type="[UNPOOLED|POOLED|JNDI]"）。
①UNPOOLED：这个数据源的实现会每次请求时打开和关闭连接。虽然有点慢。就是没有池的概念，池：用完可以回收。
②POOLED：这种处理方式很流行，能使并发 Web 应用快速响应请求。是有池的。
③JNDI：这个数据源实现是为了能在如 EJB 或应用服务器这类容器中使用。
MyBatis默认的事务管理器就是JDBC， 连接池是POOLED。

3.属性（properties）

可以通过properties属性来实现引用配置文件。
这些属性都是可外部配置且可动态替换的，既可以在典型的Java属性文件中配置，亦可通过properties元素的子元素来传递。主要是db.properties。
注意：在xml中，所有的标签都可以规定其顺序（properties、settings、typeAliases、typeHandlers、objectWrapperFactory、reflectorFactory、plugins、environments、databaseIdProvider、mappers）。
db.properties：

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8
username=root
password=123456

在核心配置文件中引入：
①自闭和

<!-- 引入外部配置文件 -->
<properties resource="db.properties"/>

②没有在配置文件中写入，自己直接添加

<!-- 引入外部配置文件 -->
<properties resource="db.properties">
  <property name="username" value="root"/>
  <property name="password" value="123456"/>
</properties>

总结：Ⅰ可以直接引入外部文件。
Ⅱ可以在其中增加一些属性配置。
Ⅲ如果两个文件有同一个字段，优先使用外部配置文件的。

4.类型别名（typeAliases）

类型别名是为 Java 类型设置一个短的名字。‘
存在的意义仅在于用来减少类完全限定名的冗余。

<!--可以给实体类起别名-->
<typeAliases>
  <typeAlias type="com.kuang.ping.User" alias="User"/>
</typeAliases>

也可以指定一个包名，MyBatis会在包名下面搜索需要的JavaBean，比如：
扫描实体类的包，它的默认别名就为这个类的类名，首字母小写。

<!--可以给实体类起别名-->
<typeAliases>
  <package name="com.kuang.pojo"/>
</typeAliases>

在实体类比较少的时候，使用第一种方式。
如果实体类十分多，建议使用第二种。
第一种可以自定义别名，第二种则不行。如果要改，需要在实体类上增加注解。

@Alias("user")
public class User {…}

5.设置（settings）

MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。

设置名	描述	有效值	默认值
cacheEnabled	缓存是否开启	true/false	true
lazyLoadingEnabled	懒加载	true/false	false
useGeneratedKeys	允许JDBC支持自动生成主键，但需要驱动的支持。	true/false	false
mapUnderscoreToCamelCase	是否开启驼峰命名自动映射，即从经典数据库列名A_COLUMN映射到经典Java属性名aColumn。	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.映射器（mappers）

MapperRegistry：注册绑定我们的Mapper文件。
方式一：使用相对于类路径的资源引用。（推荐使用）

<mappers>
    <mapper resource="com/ping/dao/UserMapper.xml"/>
</mappers>

方式二：使用映射器接口实现类的完全限定类名。

<mappers>
    <mapper class="com.ping.dao.UserMapper"/>
</mappers>

方式三：将包内的映射器接口实现全部注册为映射器。

<mappers>
    <package name="com.ping.dao"/>
</mappers>

每一个mapper.xml都需要在Mybatis核心配置文件中注册.
方式二和三的注意点：①接口和他的Mapper配置文件必须同名。
②接口和他的Mapper配置文件必须在同一个包下。

8.生命周期和作用域

生命周期和作用域是至关重要的，因为错误的使用会导致非常严重的并发问题。

SqlSessionFactoryBuilder：
一旦创建了SqlSessionFactory，就不再需要它了。
局部变量。
SqlSessionFactory：
说白了就是可以想象为 ：数据库连接池。
SqlSessionFactory一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。
因此SqlSessionFactory的最佳作用域是应用作用域。
最简单的就是使用单例模式或者静态单例模式。
SqlSession：
连接到连接池的一个请求。
SqlSession的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。
用完之后需要赶紧关闭，否则资源被占用。

这里面的每一个Mapper，就代表一个具体的业务。

9.解决解决属性名和字段名不一致的问题（ResultMap）

1）问题
数据库中的字段：

<select id="getUserById" resultType="com.ping.pojo.User">
  <!-- 类型处理器 -->
  select id,name,pwd from mybatis.user where id = #{id}
</select>

新建一个实体类，注意与数据库中的字段不完全一致：

public class User {
  private int id;
  private String name;
  private String password;
}

测试出现问题：数据库的字段和类的属性名不一致的为空。
以前的解决方法：起别名

<select id="getUserById" resultType="com.ping.pojo.User">
    select id,name,pwd as password from mybatis.user where id = #{id}
</select>

2）ResultMap
结果集映射：

数据库的字段名	类的属性名
id	id
name	name
pwd	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的设计思想是，对于简单的语句根本不需要配置显式的结果映射，而对于复杂一点的语句只需要描述它们的关系就行了。
ResultMap最优秀的地方在于，虽然已经对它相当了解了，但是根本就不需要显式地用到他们。