Spring boot Mybatis-XML方式通用Mapper插件之MyBatis Geneator详解(六)

MyBatis通用Mapper3介绍

通用Mapper都可以极大的方便开发人员。可以随意的按照自己的需要选择通用方法,还可以很方便的开发自己的通用方法。极其方便的使用MyBatis单表的增删改查。支持单表操作,不支持通用的多表联合查询。

MyBatis Geneator

在使用通用Mapper插件之前先介绍使用MyBatis Geneator(简称MBG)。
通用Mapper在1.0.0版本的时候增加了MyBatis Generator(以下简称MBG)插件,使用该插件可以很方便的生成实体类、Mapper接口以及对应的XML文件。

用java写一个MGB工具

引入MGB的依赖jar(用pom.xml引入)

<dependencies>
    <dependency>
      <groupId>tk.mybatis</groupId>
      <artifactId>mapper</artifactId>
      <!-- 建议使用最新版本 -->
      <version>3.4.6</version>
    </dependency>

    <dependency>
      <groupId>org.mybatis.generator</groupId>
      <artifactId>mybatis-generator-core</artifactId>
      <version>1.3.5</version>
    </dependency>

    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>5.1.25</version>
    </dependency>

    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>3.4.5</version>
    </dependency>

</dependencies>

配置文件generatorConfig.xml(后期如果有更新会更新此文件)

<?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>
   <!-- <context>元素用于指定生成一组对象的环境。例如指定要连接的数据库,要生成对象的类型和要处理的数据库中的表。运行MBG的时候还可以指定要运行的<context>-->
    <context id="Mysql" targetRuntime="MyBatis3Simple" defaultModelType="flat">
        <!--plugin指定插件-->
        <plugin type="tk.mybatis.mapper.generator.MapperPlugin">
            <property name="mappers" value="tk.mybatis.mapper.common.Mapper"/>
            <!-- caseSensitive默认false,当数据库表名区分大小写时,可以将该属性设置为true -->
            <property name="caseSensitive" value="true"/>
        </plugin>
        <!--<jdbcConnection>用于指定数据库连接信息,该元素必选,并且只能有一个。-->
        <jdbcConnection driverClass="com.mysql.jdbc.Driver"
                        connectionURL="jdbc:mysql://localhost:3306/test"
                        userId="root"
                        password="root">
        </jdbcConnection>
        <!--生成实体类-->
        <javaModelGenerator targetPackage="com.springboot.backstage.entity" targetProject="E:\MyProject\src\main\java"/>
        <!--生成mapper文件-->
        <sqlMapGenerator targetPackage="mapper"  targetProject="E:\MyProject\src\main\resources"/>
        <!--生成Mapper接口-->
        <javaClientGenerator targetPackage="com.springboot.backstage.dao" targetProject="E:\MyProject\src\main\java" type="XMLMAPPER" />
        <!--该元素至少要配置一个,可以配置多个。只有配置的才会生成实体类和其他文件。该元素有一个必选属性:tableName:指定要生成的表名,可以使用SQL通配符匹配多个表。例如要生成全部的表,可以按如下配置-->
        <table tableName="%" >
            <generatedKey column="id" sqlStatement="Mysql" identity="true"/>
        </table>
    </context>
</generatorConfiguration>

main方法

import org.mybatis.generator.api.MyBatisGenerator;
import org.mybatis.generator.config.Configuration;
import org.mybatis.generator.config.xml.ConfigurationParser;

import org.mybatis.generator.internal.DefaultShellCallback;
import sun.nio.cs.Surrogate;



import java.util.ArrayList;
import java.util.List;

public class GeneratorMain {
    public static void main(String[] args) throws Exception {
        List<String> warnings = new ArrayList<String>();
        boolean overwrite = true;
        ConfigurationParser cp = new ConfigurationParser(warnings);
        Configuration config = cp.parseConfiguration(
                Surrogate.Generator.class.getResourceAsStream("/generatorConfig.xml"));
        DefaultShellCallback callback = new DefaultShellCallback(overwrite);
        MyBatisGenerator myBatisGenerator = new MyBatisGenerator(config, callback, warnings);
        myBatisGenerator.generate(null);
    }
}

MGB工具gitHub地址

我把我写好的已经放到github上大家可以直接下载下来改里面的参数

Github地址:https://github.com/AlanWalkerGuo/GeneratorMapper

注意:在运行main函数的时候先把targetProject属性后面的路径文件夹建好

MyBatis Geneator 详解

配置文件头

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

generatorConfiguration节点没有任何属性,直接写节点即可,如下:

<generatorConfiguration>
    <!-- 具体配置内容 -->
</generatorConfiguration>  

generatorConfiguration子元素

properties元素

元素用于指定一个需要在配置中解析使用的外部属性文件,引入属性文件后,可以在配置中使用 ${property}这种形式的引用,通过这种方式引用属性文件中的属性值。 对于后面需要配置的jdbc信息和targetProject属性会很有用。
这个属性可以通过resource或者url来指定属性文件的位置,这两个属性只能使用其中一个来指定,同时出现会报错。

  • resource:指定classpath下的属性文件,使用类似com/myproject/generatorConfig.properties这样的属性值。
  • url:可以指定文件系统上的特定位置,例如file:///C:/myfolder/generatorConfig.properties

classPathEntry元素

这个元素可以0或多个,不受限制。这个元素的作用是将MBG运行时需要用到的jar包(或zip格式)添加到classpath下。最常见的用法是,当classpath下面没有JDBC驱动的时候,我们通常通过这个属性指定驱动的路径,例如:

<classPathEntry location="E:\mysql\mysql-connector-java-5.1.29.jar"/>

context元素

在MBG的配置中,至少需要有一个<context>元素。
<context>元素用于指定生成一组对象的环境。例如指定要连接的数据库,要生成对象的类型和要处理的数据库中的表。运行MBG的时候还可以指定要运行的<context>。
该元素只有一个必选属性id,用来唯一确定一个<context>元素,该id属性可以在运行MBG的使用。
此外还有几个可选属性:

  • defaultModelType:这个属性很重要,这个属性定义了MBG如何生成实体类。这个属性有以下可选值:
  1. conditional:这是默认值,这个模型和下面的hierarchical类似,除了如果那个单独的类将只包含一个字段,将不会生成一个单独的类。 因此,如果一个表的主键只有一个字段,那么不会为该字段生成单独的实体类,会将该字段合并到基本实体类中。
  2. flat:该模型为每一张表只生成一个实体类。这个实体类包含表中的所有字段。这种模型最简单,推荐使用。
  3. hierarchical:如果表有主键,那么该模型会产生一个单独的主键实体类,如果表还有BLOB字段, 则会为表生成一个包含所有BLOB字段的单独的实体类,然后为所有其他的字段生成一个单独的实体类。 MBG会在所有生成的实体类之间维护一个继承关系。
  • targetRuntime:此属性用于指定生成的代码的运行时环境。该属性支持以下可选值:
  1. MyBatis3:默认的值,生成基于MyBatis3.x以上版本的内容,包括XXXBySample
  2. MyBatis3Simple:类似MyBatis3,只是不生成XXXBySample
  • introspectedColumnImpl:该参数可以指定扩展org.mybatis.generator.api.IntrospectedColumn该类的实现类。该属性的作用

一般情况下,我们使用如下的配置即可:
<context id="Mysql" defaultModelType="flat">

如果你希望不生成和Example查询有关的内容,那么可以按照如下进行配置:
<context id="Mysql" targetRuntime="MyBatis3Simple" defaultModelType="flat">

context子元素

MBG配置中的其他几个元素,基本上都是<context>的子元素,这些子元素(有严格的配置顺序)包括:

  • <property> (0个或多个)
  • <plugin> (0个或多个)
  • <commentGenerator> (0个或1个)
  • <jdbcConnection> (1个)
  • <javaTypeResolver> (0个或1个)
  • <javaModelGenerator> (1个)
  • <sqlMapGenerator> (0个或1个)
  • <javaClientGenerator> (0个或1个)
  • <table> (1个或多个)
property

其中<property>属性比较特殊,后面讲解的时候都会和父元素一起进行讲解。在讲解<property>属性前,我们先看看什么是分隔符?。

这里通过一个例子说明。假设在Mysql数据库中有一个表名为user info,你没有看错,中间是一个空格,这种情况下如果写出select * from user info这样的语句,肯定是要报错的,在Mysql中的时候我们一般会写成如下的样子:

select * from `user info`

这里的使用的反单引号(`)就是分隔符,分隔符可以用于表名或者列名。

下面继续看<property>支持的属性:

  • autoDelimitKeywords
  • beginningDelimiter
  • endingDelimiter
  • javaFileEncoding
  • javaFormatter
  • xmlFormatter
    由于这些属性比较重要,这里一一讲解。
  • 首先是autoDelimitKeywords,当表名或者字段名为SQL关键字的时候,可以设置该属性为true,MBG会自动给表名或字段名添加分隔符。
  • 然后这里继续上面的例子来讲beginningDelimiter和endingDelimiter属性。由于beginningDelimiter和endingDelimiter的默认值为双引号("),在Mysql中不能这么写,所以还要将这两个默认值改为反单引号(`),配置如下:
 <property name="beginningDelimiter" value="`"/>
 <property name="endingDelimiter" value="`"/>  
  • 属性javaFileEncoding设置要使用的Java文件的编码,默认使用当前平台的编码,只有当生产的编码需要特殊指定时才需要使用,一般用不到。
  • 最后两个javaFormatter和xmlFormatter属性可能会很有用,如果你想使用模板来定制生成的java文件和xml文件的样式,你可以通过指定这两个属性的值来实现。
public元素

该元素可以配置0个或者多个,不受限制。

<plugin>元素用来定义一个插件。插件用于扩展或修改通过MyBatis Generator (MBG)代码生成器生成的代码。
插件将按在配置中配置的顺序执行。

jdbcConnection元素

<jdbcConnection>用于指定数据库连接信息,该元素必选,并且只能有一个。

配置该元素只需要注意如果JDBC驱动不在classpath下,就需要通过<classPathEntry>元素引入jar包,这里推荐将jar包放到classpath下。

该元素有两个必选属性:

  • driverClass:访问数据库的JDBC驱动程序的完全限定类名
  • connectionURL:访问数据库的JDBC连接URL

该元素还有两个可选属性:

  • userId:访问数据库的用户ID
  • password:访问数据库的密码

此外该元素还可以接受多个<property>子元素,这里配置的<property>属性都会添加到JDBC驱动的属性中。

这个元素配置起来最容易,这里举个简单例子:

<jdbcConnection driverClass="com.mysql.jdbc.Driver"
                connectionURL="jdbc:mysql://localhost:3306/test"
                userId="root"
                password="">
</jdbcConnection>
javaModelGenerator元素

该元素必须配置一个,并且最多一个。

该元素用来控制生成的实体类,根据<context>中配置的defaultModelType,一个表可能会对应生成多个不同的实体类。一个表对应多个类实际上并不方便,所以前面也推荐使用flat,这种情况下一个表对应一个实体类。

该元素只有两个属性,都是必选的。

  • targetPackage:生成实体类存放的包名,一般就是放在该包下。实际还会受到其他配置的影响(<table>中会提到)。
  • targetProject:指定目标项目路径,使用的是文件系统的绝对路径。

该元素支持以下几个<property>子元素属性:

  • constructorBased:该属性只对MyBatis3有效,如果true就会使用构造方法入参,如果false就会使用setter方式。默认为false
  • enableSubPackages:如果true,MBG会根据catalogschema来生成子包。如果false就会直接用targetPackage属性。默认为false
  • immutable:该属性用来配置实体类属性是否可变,如果设置为true,那么constructorBased不管设置成什么,都会使用构造方法入参,并且不会生成setter方法。如果为false,实体类属性就可以改变。默认为false
  • rootClass:设置所有实体类的基类。如果设置,需要使用类的全限定名称。并且如果MBG能够加载rootClass,那么MBG不会覆盖和父类中完全匹配的属性。匹配规则:
*   属性名完全相同
*   属性类型相同
*   属性有`getter`方法
*   属性有`setter`方法
  • trimStrings:是否对数据库查询结果进行trim操作,如果设置为true就会生成类似这样public void setUsername(String username) {this.username = username == null ? null : username.trim();}setter方法。默认值为false

配置示例如下:

<javaModelGenerator targetPackage="test.model" targetProject="E:\MyProject\src\main\java">
    <property name="enableSubPackages" value="true" />
    <property name="trimStrings" value="true" />
</javaModelGenerator>
sqlMapGenerator元素

该元素可选,最多配置一个。但是有如下两种必选的特殊情况:

  • 如果targetRuntime目标是iBATIS2,该元素必须配置一个。
  • 如果targetRuntime目标是MyBatis3,只有当<javaClientGenerator>需要XML时,该元素必须配置一个。 如果没有配置
    <javaClientGenerator>,则使用以下的规则:
  • 如果指定了一个<sqlMapGenerator>,那么MBG将只生成XML的SQL映射文件和实体类。
  • 如果没有指定<sqlMapGenerator>,那么MBG将只生成实体类。
  • targetPackage:生成实体类存放的包名,一般就是放在该包下。实际还会受到其他配置的影响(<table>中会提到)。
  • targetProject:指定目标项目路径,使用的是文件系统的绝对路径。

该元素支持<property>子元素,只有一个可以配置的属性:

  • enableSubPackages:如果true,MBG会根据catalogschema来生成子包。如果false就会直接用targetPackage属性。默认为false

配置示例:

<sqlMapGenerator targetPackage="test.xml"  targetProject="E:\MyProject\src\main\resources">
    <property name="enableSubPackages" value="true" />
</sqlMapGenerator>
javaClientGenerator元素

该元素可选,最多配置一个。如果不配置该元素,就不会生成Mapper接口。
该元素有3个必选属性:

  • type:该属性用于选择一个预定义的客户端代码(可以理解为Mapper接口)生成器,用户可以自定义实现,需要继承org.mybatis.generator.codegen.AbstractJavaClientGenerator类,必选有一个默认的构造方法。 该属性提供了以下预定的代码生成器,首先根据<context>targetRuntime分成三类:
  • MyBatis3:
  • ANNOTATEDMAPPER:基于注解的Mapper接口,不会有对应的XML映射文件
  • MIXEDMAPPER:XML和注解的混合形式,(上面这种情况中的)SqlProvider注解方法会被XML替代。
  • XMLMAPPER:所有的方法都在XML中,接口调用依赖XML文件。
  • MyBatis3Simple:
  • ANNOTATEDMAPPER:基于注解的Mapper接口,不会有对应的XML映射文件
  • XMLMAPPER:所有的方法都在XML中,接口调用依赖XML文件。
  • Ibatis2Java2Ibatis2Java5:
  • IBATIS:生成的对象符合iBATIS的DAO框架(不建议使用)。
  • GENERIC-CI:生成的对象将只依赖于SqlMapClient,通过构造方法注入。
  • GENERIC-SI:生成的对象将只依赖于SqlMapClient,通过setter方法注入。
  • SPRING:生成的对象符合Spring的DAO接口
  • targetPackage:生成实体类存放的包名,一般就是放在该包下。实际还会受到其他配置的影响(<table>中会提到)。
  • targetProject:指定目标项目路径,使用的是文件系统的绝对路径。

该元素还有一个可选属性:

  • implementationPackage:如果指定了该属性,实现类就会生成在这个包中。

该元素支持<property>子元素设置的属性:

  • enableSubPackages
  • exampleMethodVisibility
  • methodNameCalculator
  • rootInterface
  • useLegacyBuilder

这几个属性不太常用,具体作用请看完整的文档,这里对rootInterface做个简单介绍。rootInterface用于指定一个所有生成的接口都继承的父接口。 这个值可以通过<table>配置的rootInterface属性覆盖。这个属性对于通用Mapper来说,可以让生成的所有接口都继承该接口。

配置示例:

<javaClientGenerator type="XMLMAPPER" targetPackage="test.dao" targetProject="E:\MyProject\src\main\java"/>
table元素

该元素至少要配置一个,可以配置多个。
该元素用来配置要通过内省的表。只有配置的才会生成实体类和其他文件。
该元素有一个必选属性:

  • tableName:指定要生成的表名,可以使用[SQL通配符]匹配多个表。

例如要生成全部的表,可以按如下配置:

<table tableName="%" />

该元素包含多个可选属性:

  • schema:数据库的schema,可以使用SQL通配符匹配。如果设置了该值,生成SQL的表名会变成如schema.tableName的形式。
  • catalog:数据库的catalog,如果设置了该值,生成SQL的表名会变成如catalog.tableName的形式。
  • alias:如果指定,这个值会用在生成的select查询SQL的表的别名和列名上。 列名会被别名为 alias_actualColumnName(别名_实际列名) 这种模式。
  • domainObjectName:生成对象的基本名称。如果没有指定,MBG会自动根据表名来生成名称。
  • enableXXX:XXX代表多种SQL方法,该属性用来指定是否生成对应的XXX语句。
  • selectByPrimaryKeyQueryId:DBA跟踪工具会用到,具体请看详细文档。
  • selectByExampleQueryId:DBA跟踪工具会用到,具体请看详细文档。
  • modelType:和<context>defaultModelType含义一样,这里可以针对表进行配置,这里的配置会覆盖<context>defaultModelType配置。
  • escapeWildcards:这个属性表示当查询列,是否对schema和表名中的SQL通配符 ('_' and '%') 进行转义。 对于某些驱动当schema或表名中包含SQL通配符时(例如,一个表名是MY_TABLE,有一些驱动需要将下划线进行转义)是必须的。默认值是false
  • delimitIdentifiers:是否给标识符增加分隔符。默认false。当catalog,schematableName中包含空白时,默认为true
  • delimitAllColumns:是否对所有列添加分隔符。默认false

该元素包含多个可用的<property>子元素,可选属性为:

  • constructorBased:和<javaModelGenerator>中的属性含义一样。
  • ignoreQualifiersAtRuntime:生成的SQL中的表名将不会包含schemacatalog前缀。
  • immutable:和<javaModelGenerator>中的属性含义一样。
  • modelOnly:此属性用于配置是否为表只生成实体类。如果设置为true就不会有Mapper接口。如果配置了<sqlMapGenerator>,并且modelOnlytrue,那么XML映射文件中只有实体对象的映射元素(<resultMap>)。如果为true还会覆盖属性中的enableXXX方法,将不会生成任何CRUD方法。
  • rootClass:和<javaModelGenerator>中的属性含义一样。
  • rootInterface:和<javaClientGenerator>中的属性含义一样。
  • runtimeCatalog:运行时的catalog,当生成表和运行环境的表的catalog不一样的时候可以使用该属性进行配置。
  • runtimeSchema:运行时的schema,当生成表和运行环境的表的schema不一样的时候可以使用该属性进行配置。
  • runtimeTableName:运行时的tableName,当生成表和运行环境的表的tableName不一样的时候可以使用该属性进行配置。
  • selectAllOrderByClause:该属性值会追加到selectAll方法后的SQL中,会直接跟order by拼接后添加到SQL末尾。
  • useActualColumnNames:如果设置为true,那么MBG会使用从数据库元数据获取的列名作为生成的实体对象的属性。 如果为false(默认值),MGB将会尝试将返回的名称转换为驼峰形式。 在这两种情况下,可以通过 元素显示指定,在这种情况下将会忽略这个(useActualColumnNames)属性。
  • useColumnIndexes:如果是true,MBG生成resultMaps的时候会使用列的索引,而不是结果中列名的顺序。
  • useCompoundPropertyNames:如果是true,那么MBG生成属性名的时候会将列名和列备注接起来. 这对于那些通过第四代语言自动生成列(例如:FLD22237),但是备注包含有用信息(例如:"customer id")的数据库来说很有用. 在这种情况下,MBG会生成属性名FLD2237_CustomerId。

除了<property>子元素外,<table>还包含以下子元素:

  • <generatedKey>元素
    这个元素最多可以配置一个。
    这个元素用来指定自动生成主键的属性(identity字段或者sequences序列)。如果指定这个元素,MBG在生成insert的SQL映射文件中插入一个<selectKey>元素。 这个元素非常重要,这个元素包含下面两个必选属性:
  • column:生成列的列名。
  • sqlStatement:将返回新值的 SQL 语句。如果这是一个identity列,您可以使用其中一个预定义的的特殊值。预定义值如下:
  • Cloudscape
  • DB2
  • DB2_MF
  • Derby
  • HSQLDB
  • Informix
  • MySql
  • SqlServer
  • SYBASE
  • JDBC:这会配置MBG使用MyBatis3支持的JDBC标准的生成key来生成代码。 这是一个独立于数据库获取标识列中的值的方法。

重要: 只有当目标运行为MyBatis3时才会产生正确的代码。 如果与iBATIS2一起使用目标运行时会产生运行时错误的代码。

这个元素还包含两个可选属性:

  • identity:当设置为true时,该列会被标记为identity列, 并且<selectKey>元素会被插入在insert后面。 当设置为false时,
    <selectKey>会插入到insert之前(通常是序列)。重要: 即使您type属性指定为post,您仍然需要为identity列将该参数设置为true。 这将标志MBG从插入列表中删除该列。默认值是false
  • type:type=post and identity=true的时候生成的<selectKey>中的order=AFTER,当type=pre的时候,identity只能为false,生成的<selectKey>中的order=BEFORE。可以这么理解,自动增长的列只有插入到数据库后才能得到ID,所以是AFTER,使用序列时,只有先获取序列之后,才能插入数据库,所以是BEFORE

配置示例一:

<table tableName="user login info" domainObjectName="UserLoginInfo">
    <generatedKey column="id" sqlStatement="Mysql"/>
</table>

对应的生成的结果:

<insert id="insert" parameterType="test.model.UserLoginInfo">
    <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.Integer">
        SELECT LAST_INSERT_ID()
    </selectKey>
    insert into `user login info` (Id, username, logindate, loginip)
    values (#{id,jdbcType=INTEGER}, #{username,jdbcType=VARCHAR}, #{logindate,jdbcType=TIMESTAMP}, #{loginip,jdbcType=VARCHAR})
</insert>

配置示例二:

<table tableName="user login info" domainObjectName="UserLoginInfo">
    <generatedKey column="id" sqlStatement="select SEQ_ID.nextval from dual"/>
</table>

对应的生成结果:

<insert id="insert" parameterType="test.model.UserLoginInfo">
    <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.Integer">
        select SEQ_ID.nextval from dual
    </selectKey>
    insert into `user login info` (Id, username, logindate, loginip)
    values (#{id,jdbcType=INTEGER}, #{username,jdbcType=VARCHAR}, #{logindate,jdbcType=TIMESTAMP},#{loginip,jdbcType=VARCHAR})
</insert>

配置示例三:

<table tableName="user login info" domainObjectName="UserLoginInfo">
    <generatedKey column="id" sqlStatement="JDBC"/>
</table>

对应的生成结果:

  <insert id="insert" keyProperty="id" parameterType="test.model.UserLoginInfo" useGeneratedKeys="true">
        insert into user login info (username, logindate, loginip)
        values (#{username,jdbcType=VARCHAR}, #{logindate,jdbcType=TIMESTAMP}, #{loginip,jdbcType=VARCHAR})
  </insert>
columnRenamingRule元素

该元素最多可以配置一个,使用该元素可以在生成列之前,对列进行重命名。这对那些存在同一前缀的字段想在生成属性名时去除前缀的表非常有用。 例如假设一个表包含以下的列:

  • CUST_BUSINESS_NAME
  • CUST_STREET_ADDRESS
  • CUST_CITY
  • CUST_STATE

生成的所有属性名中如果都包含CUST的前缀可能会让人不爽。这些前缀可以通过如下方式定义重命名规则:

<columnRenamingRule searchString="^CUST_" replaceString="" />

注意,在内部,MBG使用java.util.regex.Matcher.replaceAll方法实现这个功能。 请参阅有关该方法的文档和在Java中使用正则表达式的例子。

<columnOverride>匹配一列时,这个元素(<columnRenamingRule>)会被忽略。<columnOverride>优先于重命名的规则。

该元素有一个必选属性:

  • searchString:定义将被替换的字符串的正则表达式。
    该元素有一个可选属性:
  • replaceString:这是一个用来替换搜索字符串列每一个匹配项的字符串。如果没有指定,就会使用空字符串。

关于<table><property>属性useActualColumnNames对此的影响可以查看完整文档。

columnOverride元素

该元素可选,可以配置多个。该元素从将某些属性默认计算的值更改为指定的值。

该元素有一个必选属性:

  • column:要重写的列名。
    该元素有多个可选属性:
  • property:要使用的Java属性的名称。如果没有指定,MBG会根据列名生成。 例如,如果一个表的一列名为STRT_DTE,MBG会根据<table>useActualColumnNames属性生成STRT_DTEstrtDte
  • javaType:该列属性值为完全限定的Java类型。如果需要,这可以覆盖由JavaTypeResolver计算出的类型。 对某些数据库来说,这是必要的用来处理“奇怪的”数据库类型(例如MySql的unsigned bigint类型需要映射为java.lang.Object)。
  • jdbcType:该列的JDBC类型(INTEGER, DECIMAL, NUMERIC, VARCHAR等等)。 如果需要,这可以覆盖由JavaTypeResolver计算出的类型。 对某些数据库来说,这是必要的用来处理怪异的JDBC驱动 (例如DB2的LONGVARCHAR类型需要为iBATIS 映射为VARCHAR)。
  • typeHandler:用户定义的需要用来处理这列的类型处理器。它必须是一个继承iBATIS的TypeHandler类或TypeHandlerCallback接口(该接口很容易继承)的全限定的类名。如果没有指定或者是空白,iBATIS会用默认的类型处理器来处理类型。重要:MBG不会校验这个类型处理器是否存在或者可用。 MGB只是简单的将这个值插入到生成的SQL映射的配置文件中。
  • delimitedColumnName:指定是否应在生成的SQL的列名称上增加分隔符。 如果列的名称中包含空格,MGB会自动添加分隔符, 所以这个重写只有当列名需要强制为一个合适的名字或者列名是数据库中的保留字时是必要的。

配置示例:

<table schema="DB2ADMIN" tableName="ALLTYPES" >
  <columnOverride column="LONG_VARCHAR_FIELD" javaType="java.lang.String" jdbcType="VARCHAR" />
</table>
ignoreColumn元素

该元素可选,可以配置多个。
该元素可以用来屏蔽不需要生成的列。

该元素有一个必选属性:

  • column:要忽略的列名。
    该元素还有一个可选属性:
  • delimitedColumnName:匹配列名的时候是否区分大小写。如果为true则区分。默认值为false,不区分大小写。

MyBatis Generator最佳实践

本节内容针对MyBatis3,使用iBATIS的不一定适用。
以下根据个人经验(对此有意见的可以留言)对一些配置看法列出如下几点:

    1. 关于Example方法,Example方法虽然很强大,但是SQL不易管理,因此不建议使用。
    1. 取消Example方法的配置,通过<table>上的enablexxExample方法可以屏蔽,但是最好的方法是在<context>上设置targetRuntime="MyBatis3Simple"。
    1. 关于实体类的modelType,建议使用defaultModelType="flat",只有一个对象的情况下管理毕竟方便,使用也简单。
    1. 关于注释<commentGenerator>,不管你是否要重写自己的注释生成器,有一点不能忘记,那就是注释中一定要保留@mbggenerated,MBG通过该字符串来判断代码是否为代码生成器生成的代码,有该标记的的代码在重新生成的时候会被删除,不会重复。不会在XML中出现重复元素。
    1. 使用MBG生成的代码时,建议尽可能不要去修改自动生成的代码,而且要生成带有@mbggenerated,这样才不会在每次重新生成代码的时候需要手动修改好多内容。
    1. 仍然是注释相关,在<commentGenerator>中,建议一定要保留suppressAllComments属性(使用默认值false),一定要取消(设为true)时间戳suppressDate,避免重复提交SVN。
    1. <jdbcConnection>建议将JDBC驱动放到项目的classpath下,而不是使用<classPathEntry>来引入jar包,主要考虑到所有开发人员的统一性。
    1. 当数据库字段使用CHAR时,建议在<javaModelGenerator>中设置<property name="trimStrings" value="true" />,可以自动去掉不必要的空格。
    1. 在<javaClientGenerator>中,建议设置type="XMLMAPPER",不建议使用注解或混合模式,比较代码和SQL完全分离易于维护。
    1. 建议尽可能在<table>中配置<generatedKey>,避免手工操作,以便于MBG重复执行代码生成。
      如果有其他有价值的经验,会继续补充。

综合以上信息,这里给出一个Mysql的简单配置:

<?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>
  <context id="MysqlContext" targetRuntime="MyBatis3Simple" defaultModelType="flat">
      <property name="beginningDelimiter" value="`"/>
      <property name="endingDelimiter" value="`"/>
      
      <commentGenerator>
          <property name="suppressDate" value="true"/>
      </commentGenerator>
      
      <jdbcConnection driverClass="com.mysql.jdbc.Driver"
                      connectionURL="jdbc:mysql://localhost:3306/test"
                      userId="root"
                      password="">
      </jdbcConnection>
      
      <javaModelGenerator targetPackage="test.model" targetProject="G:\MyProject\src\main\java">
          <property name="trimStrings" value="true" />
      </javaModelGenerator>
      
      <sqlMapGenerator targetPackage="test.xml"  targetProject="G:\MyProject\src\main\resources"/>
      
      <javaClientGenerator type="XMLMAPPER" targetPackage="test.dao"  targetProject="G:\MyProject\src\main\java"/>
      
      <table tableName="%">
          <generatedKey column="id" sqlStatement="Mysql"/>
      </table>
  </context>
</generatorConfiguration>
<table>

这里用的通配符匹配全部的表,另外所有表都有自动增长的id字段。如果不是所有表的配置都一样,可以做针对性的配置。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,117评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,328评论 1 293
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,839评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,007评论 0 206
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,384评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,629评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,880评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,593评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,313评论 1 243
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,575评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,066评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,392评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,052评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,082评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,844评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,662评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,575评论 2 270

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,100评论 18 139
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,360评论 6 343
  • 国家电网公司企业标准(Q/GDW)- 面向对象的用电信息数据交换协议 - 报批稿:20170802 前言: 排版 ...
    庭说阅读 10,507评论 6 13
  • 作为一个一直太乖,太听话的学生。在我的成长过程中,我习得人生信条是:anything is possible. 最...
    一书onebook阅读 316评论 0 0
  • 朝朝梦醒何处续,夜夜魂断无处说。 三生咏叹千行泪,七寸相思万点灰。
    十里缘起面青山阅读 153评论 0 3