理解MyBatis Generator Plugin

【原创文章,转载请注明原文章地址,谢谢!】

Paste_Image.png

Plugin能够用来在MyBatis Generator生成Java和XML文件过程中修改或者添加内容;Plugin必须实现org.mybatis.generator.api.Plugin接口,在这个接口中提供了非常多的方法,所以,很自然,MBG提供了一个适配器org.mybatis.generator.api.PluginAdapter,一般情况下只需要继承这个适配器即可;
MBG已经提供了一些内置的Plugin(这些Plugin是我们学习插件的非常好的示例),这些插件都在org.mybatis.generator.plugins包中;要能够写自己的插件,最重要的是了解插件的执行过程(生命周期)。

插件的生命周期##

插件拥有一个生命周期,在MBG初始化和生成的过程中,会有序的调用Plugin上不同的方法。插件的生命周期如下:

  • 使用默认构造器创建;
  • setContext方法调用,注入生成器上下文;
  • setProperties方法调用,传入在配置文件中插件的参数;
  • validate方法调用,该方法一般用于验证传给参数的正确性,如果该方法返回false,则该插件结束执行;
  • 针对context中配置的每一个table:
  • initialized方法被调用,用于初始化操作,传入IntrospectedTable;
  • Java Client Methods被调用(这个地方需要注意一下,这里的Java Client Method调用和下面的Model Method,SQL Map Method的调用的前提是针对该table配置是分别需要生成client,model和SQL的,如果一个table不需要生成java client,那么这个阶段就忽略,下面两个阶段同理):
  • clientXXXMethodGenerated(Method, TopLevelClass, IntrospectedTable)方法调用(比如clientCountByExampleMethodGenerated方法),这些方法其实就是对应Java DAO中生成对应方法时调用(那个TopLevelClass其实就是对Java类的DOM封装)【注意】,这些方法主要针对ibatis;
  • clientXXXMethodGenerated(Method, Interface, IntrospectedTable)方法调用(比如clientCountByExampleMethodGenerated方法),这些方法其实就是对应Java中Mapper生成对应方法时调用;通过返回true和false来代表该方法是否需要生成;
    -clientGenerated(Interface, TopLevelClass, IntrospectedTable)方法调用;
  • Model Methods被调用:
    • 对每一个字段依次调用modelFieldGenerated
      , modelGetterMethodGenerated
      , modelSetterMethodGenerated方法(就不一个一个详细解释了,看名字就看得出来在干嘛)
    • modelExampleClassGenerated(TopLevelClass, IntrospectedTable):用于创建XXXExample类;TopLevelClass参数同理,也是就是生成XXXExample类的DOM;
    • modelPrimaryKeyClassGenerated(TopLevelClass, IntrospectedTable):用于创建那个主键(KeyClass)类;
    • modelBaseRecordClassGenerated(TopLevelClass, IntrospectedTable):用于创建那个Record class(主Class)类;
    • modelRecordWithBLOBsClassGenerated(TopLevelClass, IntrospectedTable):用于创建包含所有BLOB列的类;
      -如果要修改这些类的生成结果,就是去修改TopLevelClass这个DOM的结构而已;
  • SQL Map Methods:这些方法主要是在生成SQL 那个mapper.xml文件时调用;
    • sqlMapXXXElementGenerated(XmlElement, IntrospectedTable),比如sqlMapDeleteByExampleElementGenerated,其实就是在XML文件中生成对应SQL元素的时候调用该方法,我们要修改生成的SQL或者元素内容,其实就是修改那个XmlElement,XmlElement是MBG对XML文件的DOM封装;
    • sqlMapDocumentGenerated(Document, IntrospectedTable)
    • sqlMapDocument(GeneratedXmlFile, IntrospectedTable),这两个方法都是最后生成XML的时候调用;
  • contextGenerateAdditionalJavaFiles(IntrospectedTable)方法调用(生成额外的Java文件,MBG自己是没有实现这个方法的,提供给插件一个扩展机会);
  • contextGenerateAdditionalXmlFiles(IntrospectedTable)方法调用(同理,生成额外的XML文件,MBG自己是没有实现这个方法的,提供给插件一个扩展机会)
  • contextGenerateAdditionalJavaFiles()方法调用,同contextGenerateAdditionalJavaFiles(IntrospectedTable)方法,只是没有参数而已;
    -contextGenerateAdditionalXmlFiles()方法调用,同contextGenerateAdditionalXmlFiles(IntrospectedTable)方法,只是没有提供参数;

开发插件##

开发插件最好的方法就是继承org.mybatis.generator.api.PluginAdapter,然后只扩展自己需要扩展的方法;
实现自己的方法,可以用来修改默认的MBG生成好的代码,或者添加自己额外需要生成的代码,一般可以在插件中完成:

  • 可以使用自己的注解来辅助生成代码;
  • 可以在类上面添加一些方法来辅助生成代码;
  • 可以添加一些XML中的元素的属性配置;
  • 可以添加一些额外的XML文件或者Java文件(比如一个例子就是生成MyBatisConfig.xml文件);

再次提醒,contextXXX方法总是会被调用,而Java Client Method,Model Method和SQL Map Method是根据配置的MBG参数来选择性的执行;比如如果配置的是flat生成样式,那么modelPrimaryKeyClassGenerated(TopLevelClass, IntrospectedTable)方法就不会被调用;
特别注意,如果一个方法返回的是boolean类型的,那么,如果该方法返回false,这个方法对应生成的代码片段(JAVA或者XML)就不会被生成了,并且,如果一个plugin返回了false,就会阻止其他的plugin的相同方法的继续执行,换句话说,配置在generatorConfig.xml中的plugin元素是有序的,这点需要特别注意。

MBG提供的内置的插件##

在MBG中,提供了一些插件,是我们很好的学习的素材,简单介绍下这些内置的插件:

org.mybatis.generator.plugins.CachePlugin###

这个插件是一个挺有用的插件,用来生成在XML中的元素(这个插件只针对MyBatis3/MyBatis3Simple有效哈);
很显然,这个插件需要一些配置,支持的配置属性有:cache_eviction,cache_flushInterval,cache_readOnly,cache_size,cache_type,具体就不解释了,和cache元素的属性一一对应;
很好的一点,在

元素中,可以通过定义property元素,来覆盖元素中提供的默认值;

org.mybatis.generator.plugins.CaseInsensitiveLikePlugin###

这个插件用来在XXXExample类中生成大小写敏感的LIKE方法(插件本身用处不大,但是我们可以通过这个插件学习给XXXExample类添加额外的方法)

org.mybatis.generator.plugins.EqualsHashCodePlugin###

很明显,这个插件用来给Java模型生成equals和hashcode方法;注意下,如果Domain类有rootClass,需要重新处理下生成的代码(因为MBG是不会考虑rootClass相关内容的,甚至都不会加载rootClass,可以参考配置文件中rootClass相关说明);

org.mybatis.generator.plugins.MapperConfigPlugin###

比较有用的一个插件,可以用来帮助生成一个默认的MapperConfig.xml文件骨架,在这个骨架文件中完成了本次生成的mapper.xml文件的配置;
该插件支持的配置属性有:

  • fileName:配置文件名称,默认为MapperConfig.xml;
  • targetPackage:配置文件所在的包,同MBG配置文件中的所有targetPackage配置;
  • targetProject:配置文件所在目录,同MBG配置文件中的所有targetProject配置;

org.mybatis.generator.plugins.RenameExampleClassPlugin###

这个插件可以使用正则表达式的方式来重命名生成的XXXExample类,通过配置 searchString和replaceString属性来完成(这个实现原理请参考MBG配置文件中的columnRenamingRule元素),
一个例子,比如要xxxExample改成xxxCriteria,只需要配置:



org.mybatis.generator.plugins.RowBoundsPlugin###

这个插件可以生成一个新的selectByExample方法,这个方法可以接受一个RowBounds参数,主要用来实现分页(当然,我们后面会生成我们自己的分页查询函数),这个插件只针对MyBatis3/MyBatis3Simple有效哈;

org.mybatis.generator.plugins.SerializablePlugin###

这个插件主要用来为生成的Java模型类添加序列化接口,并生成serialVersionUID字段;
有两个配置项:

  • addGWTInterface:这个是针对GWT的,我们忽略;
  • suppressJavaInterface:这个参数是必须要填的,我们设置为false就可以了;

org.mybatis.generator.plugins.ToStringPlugin###

这个插件顾名思义,为生成的Java模型创建一个toString方法,(PS:一个挺有用的插件,而且这个插件生成的toString方法性能还挺高哦~~)

好了,这篇文章先到这里吧,下面再来说说怎么自己写一个插件吧;

理解MyBatis Generator Plugin_第1张图片
image

你可能感兴趣的:(理解MyBatis Generator Plugin)