jndi数据源配置_Mybatis~03~配置文件解析

一、核心配置文件

• MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。

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

注意：注意元素节点的顺序！顺序不对会报错

1、environments元素

<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>

• 配置MyBatis的多套运行环境，将SQL映射到多个不同的数据库上，必须指定其中一个为默认运行环境(通过default指定)

• 子元素节点：environment

  • 数据源是必须配置的。

  • dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。

  • unpooled：这个数据源的实现只是每次被请求时打开和关闭连接。

  • pooled：这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来 , 这是一种使得并发 Web 应用快速响应请求的流行处理方式。

  • 具体的一套环境，通过设置id进行区别，id保证唯一！

  • 子元素节点：transactionManager - [ 事务管理器 ]

  • 子元素节点：数据源(dataSource)

    type="[UNPOOLED|POOLED|JNDI]")

2、mappers元素

• 映射器 : 定义映射SQL语句文件

• 既然 MyBatis 的行为其他元素已经配置完了，我们现在就要定义 SQL 映射语句了。但是首先我们需要告诉 MyBatis 到哪里去找到这些语句。Java 在自动查找这方面没有提供一个很好的方法，所以最佳的方式是告诉 MyBatis 到哪里去找映射文件。

• 可以使用相对于类路径的资源引用， 或完全限定资源定位符(包括 file:/// 的 URL)，或类名和包名等。映射器是MyBatis中最核心的组件之一

• 在MyBatis 3之前，只支持xml映射器，即：所有的SQL语句都必须在xml文件中配置。而从MyBatis 3开始，还支持接口映射器，这种映射器方式允许以Java代码的方式注解定义SQL语句，非常简洁。

引入资源方式

方式一：

<mappers>  <mapper resource="org/mybatis/builder/PostMapper.xml"/>mappers>

方式二：

<mappers>  <mapper class="org.mybatis.builder.AuthorMapper"/>mappers>

方式三：(推荐，包下所有mapper都会被扫描到)

<mappers>  <package name="org.mybatis.builder"/>mappers>

Mapper.xml文件编写注意

• 可当做模板

<?xml version="1.0" encoding="UTF-8" ?>/span>        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"        "http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="com.kuang.mapper.UserMapper">mapper>

• namespace，即命名空间

  • namespace的命名必须跟某个接口同名

  • 接口中的方法与映射文件中sql语句id应该一一对应

  • namespace和子元素的id联合保证唯一 , 区别不同的mapper

  • namespace命名规则 : 包名+类名

  • 绑定DAO接口

  MyBatis 的真正强大在于它的映射语句，这是它的魔力所在。由于它的异常强大，映射器的 XML 文件就显得相对简单。MyBatis 为聚焦于 SQL 而构建，以尽可能地为你减少麻烦。

3、properties元素

  数据库这些属性都是可外部配置且可动态替换的，既可以在典型的 Java 属性文件中配置，亦可通过 properties 元素的子元素来传递。步骤：

(1)在resources目录下新建一个db.properties

driver=com.mysql.jdbc.Driverurl=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf8username=rootpassword=123456

(2)在核心配置文件中导入db.properties文件

<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="mapper/UserMapper.xml"/>    mappers>

• 配置文件优先级问题

4、typeAliases元素

  类型别名是为 Java 类型设置一个短的名字。它只和 XML 配置有关，存在的意义仅在于用来减少类完全限定名的冗余。

方法一：

<typeAliases>    <typeAlias type="com.kuang.pojo.User" alias="User"/>typeAliases>

当这样配置时，User可以用在任何使用com.kuang.pojo.User的地方。

方法二：  

也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean，比如:

<typeAliases>    <package name="com.kuang.pojo"/>typeAliases>

  每一个在包 com.kuang.pojo 中的 Java Bean，在没有注解的情况下，会使用 Bean 的首字母小写的非限定类名来作为它的别名。

方法三：

若有注解，则别名为其注解值。

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

5、settings元素

• setting相关，具体参见官网

  • 懒加载

  • 日志实现

  • 缓存的开启与关闭

• 完整的setting元素的实例：

<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>

6、typeHandlers元素

• 了解即可

7、objectFactory元素

• 了解即可

• MyBatis 每次创建结果对象的新实例时，它都会使用一个对象工厂(ObjectFactory)实例来完成。

• 默认的对象工厂需要做的仅仅是实例化目标类，要么通过默认构造方法，要么在参数映射存在的时候通过有参构造方法来实例化。

二、声明周期与作用域

• SqlSessionFactoryBuilder 的作用在于创建SqlSessionFactory，创建成功后，SqlSessionFactoryBuilder 就失去了作用，所以它只能存在于创建 SqlSessionFactory 的方法中，而不要让其长期存在。因此 SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域(也就是局部方法变量)。

• SqlSessionFactory 可以被认为是一个数据库连接池，它的作用是创建 SqlSession 接口对象。因为 MyBatis 的本质就是 Java 对数据库的操作，所以 SqlSessionFactory 的生命周期存在于整个 MyBatis 的应用之中，所以一旦创建了 SqlSessionFactory，就要长期保存它，直至不再使用 MyBatis 应用，所以可以认为 SqlSessionFactory 的生命周期就等同于 MyBatis 的应用周期。因此在一般的应用中我们往往希望 SqlSessionFactory 作为一个单例，让它在应用中被共享。所以说 SqlSessionFactory 的最佳作用域是应用作用域。

• 如果说 SqlSessionFactory 相当于数据库连接池，那么 SqlSession 就相当于一个数据库连接(Connection 对象)，你可以在一个事务里面执行多条 SQL，然后通过它的 commit、rollback 等方法，提交或者回滚事务。所以它应该存活在一个业务请求中，处理完整个请求后，应该关闭这条连接，让它归还给 SqlSessionFactory，否则数据库资源就很快被耗费精光，系统就会瘫痪，所以用 try…catch…finally… 语句来保证其正确关闭。所以 SqlSession 的最佳的作用域是请求或方法作用域。

三、手动编写MybatisUtils，加深理解

package com.tiko.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 --->sqlSessionpublic class MybatisUtils {  private static SqlSessionFactory sqlSessionFactory;  //使用mybatis，第一步：获取sqlSessionFactory  static {    try {    String resource = "mybatis-config.xml";    InputStream inputstream = Resources.getResourceAsStream(resource);        sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputstream);    }    catch (IOException e) {    e.printStackTrace();    }  }  //既然有了sqlSessionFactory，我们就可以从中获取sqlSession了  //sqlSession完全包含面向数据库执行的SQL命令的所有方法  //获取sqlSession连接  public static SqlSession getSqlSession() {  SqlSession sqlSession = sqlSessionFactory.openSession();  return sqlSession;  }}

-------- end --------