Mybatis常用配置属性

Mybatis常用配置属性

1、properties（属性）

• 第一种配置方式：直接配置

<!--    *************************************第一种配置方式*********************************-->
    可以配置多套环境
    MyBatis默认的事务管理器就是JDBC，连接池默认是POOLED
    <environments default="development">
        <environment id="development">
<!--            事务管理-->
            <transactionManager type="JDBC"/>
<!--            数据库相关的东西-->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="xbh123"/>
            </dataSource>
        </environment>
    </environments>

• 第二种配置方式：引入外部文件

 <!--    **************************************第二种配置方式:引入外部配置文件**************************************-->
    <properties resource="db.properties">

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

• 第三种配置方式：在其中增加一些属性配置

 <!--    **************************************第三种配置方式:在 properties 元素的子元素中设置**************************************-->
<properties resource="db.properties">
    <property name="username" value="root"/>
    <property name="password" value="xbh123"/>
</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>

如果一个属性在不只一个地方进行了配置，那么，MyBatis 将按照下面的顺序来加载：

1、首先读取在 properties 元素体内指定的属性。 然后根据 properties 元素中的 resource
2、属性读取类路径下属性文件，或根据 url 属性指定的路径读取属性文件，并覆盖之前读取过的同名属性。
3、最后读取作为方法参数传递的属性，并覆盖之前读取过的同名属性。 因此，通过方法参数传递的属性具有最高优先级，resource/url
*注意属性中指定的配置文件次之，最低优先级的则是 properties 元素中指定的属性。

2、typeAliases（类型别名）

• 类型别名可为 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，比如：


<typeAliases>
  <package name="domain.blog"/>
</typeAliases>

每一个在包 domain.blog 中的 Java Bean，在没有注解的情况下，
会使用 Bean 的首字母小写的非限定类名来作为它的别名。 比如 domain.blog.Author 的别名为 author；
若有注解，则别名为其注解值。见下面的例子：



@Alias("author")
public class Author {
    ...
}

• 注意属性的顺序问题，必须按照指定的顺序插入属性，否则会提示如下错误

The content of element type “configuration” must match
“(properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,reflectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?)”.

1. 注意

   1. 在实体类比较少的时候，使用第一种方式，如果实体类非常多，建议使用包名的方式
   2. 第一种可以DIY别名，第二种则不行，如果非要改，需要在实体类上增加注解

3、设置（settings）

1. cacheEnabled 全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。

2. useGeneratedKeys 允许 JDBC 支持自动生成主键，需要数据库驱动支持。如果设置为 true，将强制使用自动生成主键。尽管一些数据库驱动不支持此特性，但仍可正常工作（如 Derby）。

3. mapUnderscoreToCamelCase 是否开启驼峰命名自动映射，即从经典数据库列名 A_COLUMN 映射到经典 Java 属性名 aColumn。

4. logImpl 指定 MyBatis 所用日志的具体实现，未指定时将自动查找。可以指定SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING

4、映射器（mappers）

• 首先，我们需要告诉 MyBatis 到哪里去找到这些语句。 在自动查找资源方面，Java 并没有提供一个很好的解决方案，所以最好的办法是直接告诉 MyBatis 到哪里去找映射文件。
• 每一个Mapper.xml都需要在Mybatis核心配置文件中注册

1、方式一【推荐使用这种方式】
<!-- 使用相对于类路径的资源引用 -->
<mappers>
  <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
  <mapper resource="org/mybatis/builder/BlogMapper.xml"/>
  <mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>
2、方式二
<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
  <mapper class="org.mybatis.builder.AuthorMapper"/>
  <mapper class="org.mybatis.builder.BlogMapper"/>
  <mapper class="org.mybatis.builder.PostMapper"/>
</mappers>
3、方式三
<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
  <package name="org.mybatis.builder"/>
</mappers>
这些配置会告诉 MyBatis 去哪里找映射文件，剩下的细节就应该是每个 SQL 映射文件了

• 方式二，方式三需要注意
  1. 接口和它的Mapper配置文件必须同名
  2. 接口和它的Mapper配置文件必须在同一个包下