14.MyBatis的核心对象及配置文件

1.MyBatis的核心 对象

主要包含两个核心 对象：SqlSessionFactory和SqlSession

1.1 SqlSessionFactory

SqlSessionFactory是MyBatis框架中十分重要的对象，它是单个数据库映射关系经过编译后的内存镜像，其主要作用是创建SqlSession。
SqlSessionFactory对象的实例可以通过SqlSessionFactoryBuilder对象来构建，而SqlSessionFactoryBuilder则可以通过XML配置文件或一个预先定义好的Configuration实例构建出SqlSessionFactory的实例。
通过XML配置文件构建出的SqlSessionFactory实例现代码如下

InputStream inputStream = Resources.getResourceAsStream("配置文件位置");
SqlSessionFactory sqlSessionFactory = 
                              new SqlSessionFactoryBuilder().build(inputStream);

SqlSessionFactory对象是线程安全的，它一旦被创建，在整个应用执行期间都会存在。如果我们多次的创建同一个数据库的SqlSessionFactory，那么此数据库的资源将很容易被耗尽。为此，通常每一个数据库都会只对应一个SqlSessionFactory，所以在构建SqlSessionFactory实例时，建议使用单例模式。

1.2 SqlSession

SqlSession是MyBatis框架中另一个重要的对象，它是应用程序与持久层之间执行交互操作的一个单线程对象，其主要作用是执行持久化操作。
使用完SqlSession对象后要及时关闭，通常可以将其放在finally块中关闭。

SqlSession sqlSession = sqlSessionFactory.openSession();
try {
       // 此处执行持久化操作
} finally {
      sqlSession.close();
}

1.2.1 查询方法：

查询方法：
T selectOne(String statement);
statement是在配置文件中定义的select元素的id。返回执行sql语句查询结果的一条泛型对象。

T selectOne(String statement, Object parameter);

statement是在配置文件中定义的select元素的id。parameter是所需要的参数。返回执行sql语句查询结果的一条泛型对象。

List selectList(String statement);

statement是在配置文件中定义的select元素的id。返回执行sql语句查询结果的一条泛型对象的集合

List selectList(String statement, Object parameter);

statement是在配置文件中定义的select元素的id。parameter是所需要的参数。返回执行sql语句查询结果的一条泛型对象的集合.

List selectList(String statement, Object parameter, RowBounds rowBounds);

statement是在配置文件中定义的select元素的id。parameter是所需要的参数。RowBounds是用于分页的参数对象。返回执行sql语句查询结果的一条泛型对象的集合.

void select(String statement, Object parameter, ResultHandler handler);

statement是在配置文件中定义的select元素的id。parameter是所需要的参数。handler对象用于处理查询返回的复杂结果集。

1.2.2 插入、更新和删除方法

int insert(String statement);
插入方法。参数statement是在配置文件中定义的insert元素的id。使用该方法后，会返回执行sql语句所影响的行数。

int insert(String statement, Object parameter);
插入方法。参数statement是在配置文件中定义的insert元素的id。parameter是插入所需的参数。使用该方法后，会返回执行sql语句所影响的行数。

int update(String statement);

更新方法。参数statement是在配置文件中定义的update元素的id。使用该方法后，会返回执行sql语句所影响的行数。

int update(String statement, Object parameter);

更新方法。参数statement是在配置文件中定义的update元素的id。parameter是更新所需的参数。使用该方法后，会返回执行sql语句所影响的行数。

int delete(String statement);

删除方法。参数statement是在配置文件中定义的delete元素的id。使用该方法后，会返回执行sql语句所影响的行数。

int delete(String statement, Object parameter);
删除方法。参数statement是在配置文件中定义的delete元素的id。parameter是删除所需的参数.使用该方法后，会返回执行sql语句所影响的行数。

1.2.3 其他方法：

void commit(); 提交事务的方法。
void rollback(); 回滚事务的方法。
void close(); 关闭SqlSession对象。
T getMapper(Class type); 返回Mapper接口的代理对象。
Connection getConnection(); 获取JDBC数据库连接对象的方法

1.3 使用工具类创建SqlSession

 public class MybatisUtils {
      private static SqlSessionFactory sqlSessionFactory = null;
      static {
          try {
    Reader reader = Resources.getResourceAsReader("mybatis-config.xml");
    sqlSessionFactory =  new SqlSessionFactoryBuilder().build(reader);
          } catch (Exception e) {
    e.printStackTrace();
          }
      }
      public static SqlSession getSession() {
           return sqlSessionFactory.openSession();
      }
}

这样我们在使用时就只创建了一个SqlSessionFactory对象，并且可以通过工具类的getSession()方法来获取SqlSession对象

2. 配置文件

在MyBatis框架的核心配置文件中，元素是配置文件的根元素，其他元素都要在元素内配置.

2.1 <properties>元素

<properties>是一个配置属性的元素，该元素通常用来将内部的配置外在化，即通过外部的配置来动态的替换内部定义的属性。例如，数据库的连接等属性，就可以通过典型的Java属性文件中的配置来替换，具体方式如下： <properties>是一个配置属性的元素，该元素通常用来将内部的配置外在化，即通过外部的配置来动态的替换内部定义的属性。例如，数据库的连接等属性，就可以通过典型的Java属性文件中的配置来替换，具体方式如下：
1.编写db.properties
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis
jdbc.username=root
jdbc.password=root
2…配置<properties… />属性

<properties resource="db.properties" />

3.修改配置文件中数据库连接的信息

<dataSource type="POOLED">
    <!-- 数据库驱动 -->
    <property name="driver" value="${jdbc.driver}" />
    <!-- 连接数据库的url -->
    <property name="url" value="${jdbc.url}" />
    <!-- 连接数据库的用户名 -->
    <property name="username" value="${jdbc.username}" />
    <!-- 连接数据库的密码 -->
    <property name="password" value="${jdbc.password}" />
</dataSource>

2.2 <settings>元素

<settings>元素主要用于改变MyBatis运行时的行为，例如开启二级缓存、开启延迟加载等
<settings>元素中的常见配置请参见教材表7-1，这些配置在配置文件中的使用方式如下：

 <!-- 设置 -->
 <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" />
     ...
 </settings>

小提示：上述配置通常不需要开发人员去配置，作为了解即可。

2.3 <typeAliases>元素

<typeAliases>元素用于为配置文件中的Java类型设置一个简短的名字，即设置别名。别名的设置与XML配置相关，其使用的意义在于减少全限定类名的冗余。

1.使用元素配置别名的方法如下

<typeAliases>
             <typeAlias alias="user" type="cn.lctvu..po.User"/>
 </typeAliases>

2.当POJO类过多时，可以通过自动扫描包的形式自定义别名，具体如下：

<typeAliases>
             <package name="com.itheima.po"/>
     </typeAliases>

注意：如果在程序中使用了注解，则别名为其注解的值。
MyBatis框架默认为许多常见的Java类型提供了相应的类型别名，如下表所示。

2.4 <typeHandler>元素

typeHandler的作用就是将预处理语句中传入的参数从javaType（Java类型）转换为jdbcType（JDBC类型），或者从数据库取出结果时将jdbcType转换为javaType。
元素可以在配置文件中注册自定义的类型处理器，它的使用方式有两种。

1.注册一个类的类型处理器

 <typeHandlers> 
      <typeHandler handler="com.itheima.type.CustomtypeHandler" />
 </typeHandlers>

2.注册一个包中所有的类型处理器

<typeHandlers> 
          <package name="com.itheima.type" />
     </typeHandlers>

2.5 元素

MyBatis允许在已映射语句执行过程中的某一点进行拦截调用，这种拦截调用是通过插件来实现的。元素的作用就是配置用户所开发的插件。
如果用户想要进行插件开发，必须要先了解其内部运行原理，因为在试图修改或重写已有方法的行为时，很可能会破坏MyBatis原有的核心模块。
关于插件的使用，不做详细讲解，同学们只需了解元素的作用即可，有兴趣的同学可以查找官方文档等资料自行学习。

2.6 <environments>元素

<environments>元素用于对环境进行配置。MyBatis的环境配置实际上就是数据源的配置，我们可以通过<environments>元素配置多种数据源，即配置多种数据库。

1.使用<environments>元素进行环境配置的示例如下：

 <environments default="development">
      <environment id="development">
  <transactionManager type="JDBC" />
        <dataSource type="POOLED">
               <property name="driver" value="${jdbc.driver}" />
               <property name="url" value="${jdbc.url}" />
               <property name="username" value="${jdbc.username}" />
               <property name="password" value="${jdbc.password}" />
     </dataSource>
      </environment>
        ...
 </environments>

2.事务管理器的配置
在MyBatis中，可以配置两种类型的事务管理器，分别是JDBC和MANAGED。关于这两个事务管理器的描述如下：
JDBC：此配置直接使用了JDBC的提交和回滚设置，它依赖于从数据源得到的连接来管理事务的作用域。

MANAGED：此配置从来不提交或回滚一个连接，而是让容器来管理事务的整个生命周期。默认情况下，它会关闭连接，但一些容器并不希望这样，为此可以将closeConnection属性设置为false来阻止它默认的关闭行为。
注意： 如果项目中使用的是Spring+ MyBatis，则没有必要在MyBatis中配置事务管理器，因为实际开发中，会使用Spring自带的管理器来实现事务管理。

3.数据源的配置

（1）.UNPOOLED
配置此数据源类型后，在每次被请求时会打开和关闭连接。它对没有性能要求的简单应用程序是一个很好的选择。在使用时，需要配置5种属性

（2）POOLED
此数据源利用“池”的概念将JDBC连接对象组织起来，避免了在创建新的连接实例时所需要初始化和认证的时间。这种方式使得并发Web应用可以快速的响应请求，是当前流行的处理方式。在使用时，可以配置更多的属性。

3.JNDI
可以在EJB或应用服务器等容器中使用。容器可以集中或在外部配置数据源，然后放置一个JNDI上下文的引用。在使用时，需要配置2个属性。

2.7 <mappers>元素

<mappers>元素用于指定MyBatis映射文件的位置，一般可以使用以下4种方法引入映射器文件，具体如下
1.使用类路径引入

<mappers>
   <mapper resource="cn/lctvu/mapper/UserMapper.xml" />
</mappers>

2.使用本地文件路径引入

<mappers>
    <mapper url="file:///D:/com/itheima/mapper/UserMapper.xml"/>
</mappers>

3.使用接口类引入

<mappers>
    <mapper class="com.itheima.mapper.UserMapper"/>
</mappers>

4.使用包名引入

<mappers>
   <package name="cn.lctvu.mapper"/>
</mappers>