MyBatis(1)之MyBatis-Generator起步

独立的jar工程
xml标签解析
main函数配置
xml示列

一.创建Jar项目

建议创建独立的jar项目，只需要使用maven创建空骨架项目，原因：

1. 该部分不参与任何的主业务，也引用不到主业务想关的内容;
2. 该部分的依赖相对独立，与主项目基本没有交集;

添加依赖:

     org.mybatis.generator
     mybatis-generator-core
    1.3.0


     mysql
     mysql-connector-java
     5.1.46

二.xml配置

在resources目录下创建(xxx).xml文件，如：mybatis-generator.xml。如何生成Interface、xml、model全部在该xml文件中配置。
1.最新的DTD：

2.标签配置以及意义

• 2.1 : 根标签，所有的配置都必须在该标签内配置；没有属性

• 2.2. : 主要引用外部的properties配置文件。不是必要的元素

  • resource 属性引用classpath中指定位置的properties文件,默认在当前目录下查找，也可指定相对目录（示例中是相对位置）

  • url属性引用文件系统的配置；比如:file:///C:/myfolder/generatorConfig.properties
    注意：resource与url只能指定一个

• 2.3.: 引用指定的jar/zip;一般将驱动加载包加载进来。不经常使用，可以不用配

  • location属性 jar/zip的全路径

• 2.4.: 标签才是重中之重，至少有一个(比如多个数据库连接,可有多个)。

  • **id**当前context的唯一标识属性；存在多个context，如果有异常信息时，会根据该id区分
  • **defaultModelType**属性配置生成domain类的形式；有三种选择:
    1.flat:一个table只生成一个domain类，所有类型的字段都包含在该类中
    2.hierarchical: 该类型会将text/blob类型的字段单独生成一个类，主键单独一个类，其余字段一个类，这些类之间保持继承关系；
    3.conditional: 默认的类型，跟**hierarchical**差不多。text/blob大字段会生成一个domain类，但是其他分离出来的字段，如果只包含一个字段，比如只有主键字段，这种模式会合并这两个类。即不会生成只有一个键的domain类。
  • **targetRuntime**属性用于配置使用MyBatis3.0或者3.4，再或者iBatis2.0版本，以及是否使用Java8Interface新特性，及是否生成xml文件，有五中选择：
    1.MyBatis3:默认值,使用MyBatis3.0+,尽可能的生成动态sql以及"by exanple" 方法
    2.MyBatis3Simple:兼容Mybatis3.0+,只是生成基本的CURD方法，by example相关方法及动态sql不会生成；
    3.MyBatis3DynamicSql:向上兼容MyBatis3.4+,会使用Java8接口的新特性；但xml文件不再生成及忽略标签，并且model的类型是FLAT(defaultModelType)，特殊的Text/Blob字段不再单独生成包括方法；
    4.Ibatis2Java2:
    5.Ibatis2Java5:这两种使用iBATIS2.0+,但不包括3.0，使用的较少，了解不多；
  • **introspectedColumnImpl**: 该属性指定自定义继承org.mybatis.generator.api.IntrospectedColumn实现类的全路径；（该类记录了数据库表的原始数据，后期会有专门文章介绍）

的子标签

• 1.:与logback日志配置文件中功能类似，将配置的参数抽离集中配置，下文再通过placeholder的方式引用;无子标签

  • name和value属性；注意大小写 (别自己挖坑)

• 2. :配置自定义实现org.mybatis.generator.api.Plugin或者继承org.mybatis.generator.api.PluginAdapter插件类的全路径；可配置多个

  • type属性配置全路径；(比如：myBaits默认提供的插件：org.mybatis.generator.plugins.EqualsHashCodePlugin)
  • *plugin 标签中还可以配置******标签，该标签配置的参数可以在类中获取到。在自定义plugin时，有时会根据不同开发者配置动态的内容，可使用此特性*

• 3.:定义xml、interface、model中是否生成原生注释(用处不大，而且看起来特乱)，再结合org.mybatis.generator.internal.DefaultCommentGenerator可实现自定义注释(后期会有详细文章介绍)

  • 可包含标签，配置：suppressDate:按照原生注释是否生成日期；

• 4.:用户配置数据库相关信息(connectionURL,driverClass,userId,password缺一不可),这些值就可以提取到标签中统一管理

• 5.:用于生成Model及Query By Example类;(会受defaultModelType策略的影响)

  • targetPackage:存放model类的包路径，比如：com.test.mybatis.generator.model,间隔符号可以用都点；如果该路径错误或者不存在，MyBatis会创建或者将错就错，任然会在当前工程生成；
  • targetProject:当前工程所在的具体目录,比如：D:/java/project/mybatis/src/main/java,MyBatis会拼接targetPackage,形成完成的存放当前model的路径；如果配置的具体路径不存在，MyBaits不会自动创建，只会什么也不做，结果是什么也生成不出来；
  • ***Property***支持的标签参数有：
    • constructorBased:是否生成构造函数,默认值false
    • enableSubPackages:是否已当前tabale为基础生成文件存放该model；默认值false；
    • trimStrings:是否自动生成trimString相应的代码；
    • rootClass:这个最有用，将表中共有的字段抽取到父类中，在生成后Model自动继承该类，并在子类中不生成响应的字段；前提是：父子类中字段类型、名称必须相同，否则会在子类重新生成；(table中可以不用配置重复的字段)

• 6.:用于生成xml文件；个人觉得xml文件中配置sql比接口中用注解好；所以会配置该标签；

  • targetPackage和targetProject 与model配置方法一致；支持的标签只有:enableSubPackages;

• 7.:用于生成Interface接口；

  • type 相比之前两个多了类型；根据的targetRuntime配置的不同都有对应不同的侧类；主要有：基于完全基于注解型(ANNOTATEDMAPPER)、完全基于xml型(XMLMAPPER)、混合型(MIXEDMAPPER);其他两个属性targetProject 和 targetPackage与Model一致；

• 8.

  : 过五关斩六将终于要看到胜利的曙光了，最重要也是最不能马虎的地方；table信息的转换配置；相关属性和标签如下:
  • tableName:数据库中对应的表名称
  • domainObjectName:对应model的类名，同时也是 xxxExample、interface、xml的名称；一般是表名的驼峰命名(个人最讨厌表一个名，转换过来又一个名称)
  • mapperName:指定Interface、xml文件的前缀名称，如果不配置取model作为前缀(可有可无)
  • alias:为表取别名，如果设置，会在查询语句的字段设置成alias_actualColumnName;
  • modelType:覆盖标签的属性defaultModelType；
  • enablexxx:是否启用某些方法；默认为全部开启

  子标签如下：

  • ****:0个或者最多1个；如果配置，会在标签下加入标签(新增时返回刚新增的主键)；column指定表中的主键；sqlStatement:使用的那种数据库，对应mybatis如何配置获取最新的主键；type:pre或者post，指定放置的位置；
  • ****:字段对应model的属性的名称；column:表字段;property:对应属性字段；javaType:指定生成时属性的类型；jdbcType:指定数据库字段的类型;该标签还可以增加子标签trimString:是否在生成的sql语句增加空格的去除；
  • ****：需要忽略的字段；(这个没有用过)；
  • ****：对应某些表的所有字段有统一开头，可以使用此字段统一切换成对应的类型；searchString：就是定义开头(比如:searchString="^test_"，以test开头的);replaceString:被代替的字段，或者空字符串，或者指定的样式；

  ****以上标签是有顺序的,按照上面的顺序即可；否则启动会报错****
  以上就是经常用到并且很重要的标签，以及属性；熟能生巧，可以多尝试配置一下，找到适合自己项目的配置；

  main函数

  main函数主要是从classPath中加载上面配置的XML文件；并打印一些日志；具体的代码如下:

  public static void main(String[] args) {
          List warnings = new ArrayList();
          try {
              //重新生成时 代码是否被覆盖
              boolean overwrite = true;
              //加载MyBatis的xml配置文件
              File file = new File(StartExecute.class.getClassLoader().getResource("common/generator.xml").getFile());
  
              ConfigurationParser parser = new ConfigurationParser(warnings);
              Configuration configuration = parser.parseConfiguration(file);
  
              DefaultShellCallback defaultShellCallback = new DefaultShellCallback(overwrite);
              MyBatisGenerator myBatisGenerator = new MyBatisGenerator(configuration, defaultShellCallback, warnings);
              myBatisGenerator.generate(null);
  
          } catch (IOException | SQLException | InterruptedException | InvalidConfigurationException | XMLParserException e) {
              LOGGER.info("出现的异常信息是{"+e.getMessage()+"}");
          }
  
          warnings.forEach(item ->System.out.println());
          System.out.println("生成完毕");
      }
  

  最后附上我自己的xml配置文件: