Mybatis学习--XML配置文件详解

标签：mybatis   xml配置   sessionfactory   mapper   handler   

在配置的Mybatis的时候,我们可以通过一个XML来配置,也可以嵌入到其他配置文件中,

比如Spring的applicationContext.xml中。

MyBatis 的 XML 配置文件包含了影响 MyBatis 行为甚深的设置和属性信息。 XML 文档 的高层级结构如下:

configuration 配置

properties 属性

settings 设置

typeAliases 类型命名

typeHandlers 类型处理器

objectFactory 对象工厂

plugins 插件

environments 环境

environment 环境变量

transactionManager 事务管理器

dataSource 数据源

databaseIdProvider chinese?

mappers 映射器

Properties

这些是外部化的, 可替代的属性, 这些属性也可以配置在典型的 Java 属性配置文件中, 或者通过 properties 元素的子元素来传递。例如:

<properties resource="org/mybatis/example/jdbc.properties">

</properties>

上面我们就引入了我们配置连接数据源的jdbc.properties连接属性然后我们就可以通过引用来使用,这一点和我们在使用spring配置数据源是一致的：

<dataSource type="POOLED">

  <property name="driver" value="${driver}"/>

  <property name="url" value="${url}"/>

  <property name="username" value="${username}"/>

  <property name="password" value="${password}"/>

</dataSource>

settings

settings是极其重要的配置, 它们会修改 MyBatis 在运行时的行为方式。 下面这个表格描述了一些设置信息的含义和默认值：

其实在很多时候,我们不需要去配置这么多信息,你只需要使用默认的值就可以了，除非你需要自定义状态。

typeAliases

 类型别名和其他语言一样，就是用一个别名来代替你所指的对象,就好似Map的key和value一样,只不过两个都指的是一个东西,了解数据库同义词的朋友可能会更有体会。

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

这些别名的使用在官方文档中说的是仅仅在配置文件中使用。

别名的另外一种是自动扫描包中的注释来得到bean（我觉得spring里面用的多），比如：

<typeAliases>

  <package name="domain"/>

</typeAliases>

这里domain指的是我们的实体包,我们的实体类定义如下：

@Alias("student")

public class Student{

    ...

}

如果说你的实体类中注解没有使用参数student，那么会创建一个Student bean对象,如果说你注解中定义了Alias(“student”)，那么就会创建一个student bean ，我们在程序中就可以使用这个实体类

typeHandlers

这个是用来处理参数和格式化参数的,即查询SQL的输入参数和返回结果集的参数,他会根据你设置的类型来转换。

此外,Mybatis也提供了自定义类型处理，你可以实现org.apache.ibatis.type.TypeHandler

这个接口或者继承org.apache.ibatis.type.BaseTypeHandler类。例如：

// ExampleTypeHandler.java

@MappedJdbcTypes(JdbcType.VARCHAR)

public class ExampleTypeHandler extends BaseTypeHandler<String> {

  @Override

  public void setNonNullParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) throws SQLException {

    ps.setString(i, parameter);

  }

  @Override

  public String getNullableResult(ResultSet rs, String columnName) throws SQLException {

    return rs.getString(columnName);

  }

  @Override

  public String getNullableResult(ResultSet rs, int columnIndex) throws SQLException {

    return rs.getString(columnIndex);

  }

  @Override

  public String getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {

    return cs.getString(columnIndex);

  }

}

然后在配置文件中配置：

<!-- mybatis-config.xml -->

<typeHandlers>

  <typeHandler handler="org.mybatis.example.ExampleTypeHandler"/>

</typeHandlers>

就可以使用了。

Handing Enums

如果你想使用枚举型，你可以使用EnumTypeHandler or EnumOrdinalTypeHandler，

EnumTypeHandler和其他handler不一样，他只处理继承enum的特殊类。

environments

MyBatis 可以配置多种环境。这会帮助你将 SQL 映射应用于多种数据库之中。例如, 你也许为开发要设置不同的配置, 测试和生产环境。 或者你可能有多种生产级数据库却共享 相同的模式,所以你会想对不同数据库使用相同的 SQL 映射。这种用例是很多的。

一个很重要的问题要记得:你可以配置多种环境,但你只能为每个 SqlSessionFactory 实例选择一个。

所以,如果你想连接两个数据库,你需要创建两个 SqlSessionFactory 实例,每个数据库 对应一个。而如果是三个数据库,你就需要三个实例,以此类推。记忆起来很简单:

· 每个数据库对应一个 SqlSessionFactory

databaseIdProvider

Mybatis能够根据你的数据库提供执行不同statemaent,这种多数据源提供功能是基于映射数据库ID来实现的。如我们这样配置：

<databaseIdProvider type="DB_VENDOR">

  <property name="SQL Server" value="sqlserver"/>

  <property name="DB2" value="db2"/>        

  <property name="Oracle" value="oracle" />

</databaseIdProvider>

mappers

既然 MyBatis 的行为已经由上述元素配置完了,我们现在就要定义 SQL 映射语句了。 但是, 首先我们需要告诉 MyBatis 到哪里去找到这些语句。 Java 在这方面没有提供一个很好 的方法, 所以最佳的方式是告诉 MyBatis 到哪里去找映射文件。 你可以使用相对于类路径的 资源引用,或者字符表示,或 url 引用的完全限定名(包括 file:///URLs) 。例如:

<!-- Using classpath relative resources -->

<mappers>

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

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

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

</mappers>

以上内容源自Mybatis官网,部分地方有自己添加的见解和翻译

Mybatis学习--XML配置文件详解

标签：mybatis   xml配置   sessionfactory   mapper   handler   

原文地址：http://blog.csdn.net/blue_rem/article/details/38756217