mybatis generator tools配置文件解析

这是mybatis3 generator 配置文件，包括了主要的配置参数，具体的配置说明请在文章结尾处下载 完整的配置应用。

应用是基于myeclipse的java应用。

文章中的MBG指的就是MybatisGenerator这个工具。



<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE generatorConfiguration PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN" "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd" >
<generatorConfiguration >
<!-- 配置属性文件 用来在配置文件中引入变量 El表达式 -->
<!-- 如果是用cmd方式运行 这里应该写url方式写全路径 因为找不到classpath 对于resource来说 -->
<properties url="file:///D:/workspaces/mybatisGen/bin/generatorConfig.properties"/>
<!-- 设置sqlServer驱动路径 -->
<classPathEntry location="${sqljdbcPath}" />
<!-- 此处指定生成针对MyBatis3的DAO-->
<!-- 
id: 必须配置。这个上下文的惟一标识符。该值将被用在一些错误消息。

defaultModelType:用来定义生成模型类型策略。
1.conditional 默认策略，为每个表生成一个Model class
2.flat:将所有的表中生成一个Model class，即这个类将保存所有表中字段
3.hierarchical ：如果表有一个主键，该模型将生成一个主键类,另一个类,用于容纳任何BLOB列在表中,和另一个类,用于容纳其余的字段。这个是一个适当的继承类之间的关系。

targetRuntime：此属性用于指定运行时目标生成的代码。
1.MyBatis3 默认值 将生成对象兼容MyBatis版本3.0和更高版本,和JSE 5.0和更高版本
(例如Java模型和mapper接口将使用泛型类型)。
“by example”方法在这些生成的对象支持几乎无限的动态where子句。
此外,Java对象与这些生成器生成支持许多JSE 5.0特性包括参数化的类型和注释。

2.Ibatis2Java2
3.Ibatis2Java5

-->
  <context id="context1"  targetRuntime="MyBatis3" defaultModelType="conditional">

<!--

<plugin type="org.mybatis.generator.plugins.EqualsHashCodePlugin" />
  <!-- 用来生成注释
   1. suppressAllComments 默认是false  此属性用于指定在生成的代码是否将包括任何注释。如果设置为true 则不生成注释
   2.  suppressDate 默认是false       此属性用于指定在生成的注释是否将包括MBG代时间戳。
  -->
  <commentGenerator>
   <property name="suppressAllComments" value="true" />
  </commentGenerator>
  <!-- jdbc连接信息 -->
  <!--
   jdbcConnection  必须配置 用来连接数据库的 无需解释
   -->
    <jdbcConnection driverClass="${driverClass}" 
    connectionURL="${connectionURL}"
    userId="${userId}" password="${password}" />
    <!-- java类型解析器 可选配置 -->
    <!--
     <javaTypeResolver type=""> type属性： 这可用于指定一个用户提供的Java类型解析器。这个类必须实现接口org.mybatis.generator.api。JavaTypeResolver,必须有一个公共的默认构造函数。属性还可以接受特殊的值默认在这种情况下,将使用默认的实现(这同样的效果不指定类型)。
     该标签支持的属性：
     forceBigDecimals：默认是false 是否强制使用BigDecimal来表示所有的十进制和数值字段。
     •如果规模更大•然后零,或长度大于18,那么不只。将使用BigDecimal类型
  •如果其长度为10到18岁,则Java类型解析器将java.lang.Long来代替了。
  •如果长度为5到9,然后Java类型解析器将替换一个Java.lang.integer。
  •如果其长度小于5,则Java类型解析器将java.lang.Short替代。
     
     -->
    <javaTypeResolver >
     <property name="" value=""/>
    </javaTypeResolver>
    <!-- 生成vo对象 -->
    <!--
    < javaModelGenerator >元素用于定义Java模型生成的属性。
    Java模型生成器建立主键类,记录类,和查询示例类相匹配的表进行自省。这个元素是所需的子元素<上下文>元素。
   
    支持的属性：
    constructorBased：
    此属性用于选择是否MyBatis生成器将生成一个类的构造函数,它接受一个值类中的每个字段。同时,SQL结果地图将建成投入使用构造函数而不是“setter”为每个字段。
    这个属性是只适用于MyBatis3和将被忽略了iBATIS2。
    这个属性可以被相应的属性在< table >元素。
    默认值是false。
   
    immutable:不可变，此属性用于选择是否MyBatis生成器将产生不可变模型类——这意味着类不会有“setter”方法和构造函数会接受类中每个字段的值。默认为false.
    trimStrings:
    此属性用于选择是否MyBatis生成器添加代码来修剪的白色空间从字符字段从数据库返回的。这可以是很有用的,如果您的数据库将数据存储在字符字段而不是VARCHAR字段。当真正的,MyBatis生成器将插入代码来削减字符字段。
    默认值是false。
     -->
    <javaModelGenerator targetPackage="${modelPackage}" targetProject="${targetProject}" />
    <!-- 生成用于查询的Example对象 -->
    <sqlMapGenerator targetPackage="${sqlMapperPackage}" targetProject="${targetProject}" />
    <!-- 生成DAO的类文件以及配置文件 -->
    <!--
    < javaClientGenerator >元素是用来定义Java客户机代码生成器的属性。
    Java客户机生成器用来建立Java接口和类,以便可以方便地使用生成的Java模型和XML映射文件。
    对于iBATIS2目标环境,这些生成的对象采用的形式DAO接口和实现类。
    对于MyBatis,生成的对象采用的形式mapper接口。
    这个元素是一个可选的子元素<上下文>元素。
    如果你不指定这个元素,然后MyBatis生成器(MBG)不会生成Java客户端接口和类。
   
    其中的type属性：
    如果targetRuntime 为MyBatis3
    XMLMAPPER：生成的对象将Java接口MyBatis 3。x mapper基础设施。接口将会依赖生成的XML映射器文件。一般都是使用这个XMLMAPPER.
     -->
    <javaClientGenerator targetPackage="${daoMapperPackage}" targetProject="${targetProject}" type="XMLMAPPER" />
       <!--
    <table>元素用于选择数据库中的一个表。选择的表将导致生成以下对象为每个表:
     •一个MyBatis / iBATIS•格式化的SQL的映射文件
     •一组类,形成了“模型”表包括:
     •一个类来匹配•表的主键(如果表有一个主键)。
     •班表中字段匹配的,不是在主键,而非BLOB字段。这个类将扩展主键,如果有一个。
     •一个类来持有任何表中的BLOB字段(如果有的话)。这个类将扩展其中一个的前面两个类取决于表的配置。
     •一个类,用于生成动态where子句,在不同的“by Example”方法(selectByExample,deleteByExample)。
     •(可选)DAO接口和类
    
     tableName:必须配置  指定表的名称
    
     domainObjectName：生成javabean对象的基本名称。如果未指定,MBG将自动基于表名生成。

     这个名字(无论是在这里指定,或自动生成)将被用来作为域类名和DAO类的名字。
    
     enableInsert：是否生成插入语句。默认是true
     enableSelectByPrimaryKey：是否通过主键生成选择语句。不管是否有这种设置,如果该表没有一个主键将不会生成。
     enableUpdateByPrimaryKey：是否通过主键生成更新语句。如果该表没有主键，不管是否设置该属性,语句将不会生成。
     enableDeleteByPrimaryKey：是否通过主键生成删除语句。如果该表没有主键，不管这种设置该属性,语句将不会生成。
     enableDeleteByExample：是否通过example对象生成删除语句。这个声明使得许多不同的动态删除在运行时生成。
     enableCountByExample：是否通过example对象生成计算行数语句。该语句将返回一个表中的行数相匹配的example。
     enableUpdateByExample：是否通过example对象生成更新语句。该语句将更新一个表中相匹配的记录。

    selectByPrimaryKeyQueryId：这个值将被添加到选择列表中选择通过主键的声明在本表格:“' <值>作为QUERYID”。这可以用于识别查询在DBA在运行时跟踪工具。如果你使用这样的价值,你应该指定一个唯一的id为每个不同的查询生成MBG。
     selectByExampleQueryId：这个值将被添加到选择列表中选择通过例子的声明在本表格:“' <值>作为QUERYID”。这可以用于识别查询在DBA在运行时跟踪工具。如果你使用这样的价值,你应该指定一个唯一的id为每个不同的查询生成MBG。
     enableSelectByExample:是否应该生成通过example的选择语句。这个声明使得许多不同的动态查询是在运行时生成。
    
    
     modelType：此属性用于覆盖默认的模型类型,如果你想对这张表这么做。如果未指定,MBG将生成的域对象基于上下文默认的模型类型。
     该模型类型定义了如何将生成MBG域类。
     一些模型类型MBG将生成一个单一的域类为每个表,和其他可能产生不同的类MBG取决于表的结构。
     escapeWildcards：排除通配符。这意味着无论SQL通配符(' _ '和' % ')的模式和表名都应该避免在搜寻列。这是一些驱动要求如果模式或表包含一个SQL通配符(例如,如果一个表的名字是MY_TABLE,一些驱动要求的下划线字符进行转义)。
       -->
    <table schema="" tableName="base_user" >
    </table>
  </context>
</generatorConfiguration>