【mybatis】Mybatis Generator最完整配置详解
2018-01-11 14:45
429 查看
<?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> <!-- 可以用于加载配置项或者配置文件,在整个配置文件中就可以使用${propertyKey}的方式来引用配置项 resource:配置资源加载地址,使用resource,MBG从classpath开始找,比如com/myproject/generatorConfig.properties url:配置资源加载地质,使用URL的方式,比如file:///C:/myfolder/generatorConfig.properties. 注意,两个属性只能选址一个; 另外,如果使用了mybatis-generator-maven-plugin,那么在pom.xml中定义的properties都可以直接在generatorConfig.xml中使用 <properties resource="" url="" /> --> <!-- 在MBG工作的时候,需要额外加载的依赖包 location属性指明加载jar/zip包的全路径 <classPathEntry location="/Program Files/IBM/SQLLIB/java/db2java.zip" /> --> <!-- context:生成一组对象的环境 id:必选,上下文id,用于在生成错误时提示 defaultModelType:指定生成对象的样式 1,conditional:类似hierarchical; 2,flat:所有内容(主键,blob)等全部生成在一个对象中; 3,hierarchical:主键生成一个XXKey对象(key class),Blob等单独生成一个对象,其他简单属性在一个对象中(record class) targetRuntime: 1,MyBatis3:默认的值,生成基于MyBatis3.x以上版本的内容,包括XXXBySample; 2,MyBatis3Simple:类似MyBatis3,只是不生成XXXBySample; introspectedColumnImpl:类全限定名,用于扩展MBG --> <context id="mysql" defaultModelType="hierarchical" targetRuntime="MyBatis3Simple" > <!-- 自动识别数据库关键字,默认false,如果设置为true,根据SqlReservedWords中定义的关键字列表; 一般保留默认值,遇到数据库关键字(Java关键字),使用columnOverride覆盖 --> <property name="autoDelimitKeywords" value="false"/> <!-- 生成的Java文件的编码 --> <property name="javaFileEncoding" value="UTF-8"/> <!-- 格式化java代码 --> <property name="javaFormatter" value="org.mybatis.generator.api.dom.DefaultJavaFormatter"/> <!-- 格式化XML代码 --> <property name="xmlFormatter" value="org.mybatis.generator.api.dom.DefaultXmlFormatter"/> <!-- beginningDelimiter和endingDelimiter:指明数据库的用于标记数据库对象名的符号,比如ORACLE就是双引号,MYSQL默认是`反引号; --> <property name="beginningDelimiter" value="`"/> <property name="endingDelimiter" value="`"/> <!-- 必须要有的,使用这个配置链接数据库 @TODO:是否可以扩展 --> <jdbcConnection driverClass="com.mysql.jdbc.Driver" connectionURL="jdbc:mysql:///pss" userId="root" password="admin"> <!-- 这里面可以设置property属性,每一个property属性都设置到配置的Driver上 --> </jdbcConnection> <!-- java类型处理器 用于处理DB中的类型到Java中的类型,默认使用JavaTypeResolverDefaultImpl; 注意一点,默认会先尝试使用Integer,Long,Short等来对应DECIMAL和 NUMERIC数据类型; --> <javaTypeResolver type="org.mybatis.generator.internal.types.JavaTypeResolverDefaultImpl"> <!-- true:使用BigDecimal对应DECIMAL和 NUMERIC数据类型 false:默认, scale>0;length>18:使用BigDecimal; scale=0;length[10,18]:使用Long; scale=0;length[5,9]:使用Integer; scale=0;length<5:使用Short; --> <property name="forceBigDecimals" value="false"/> </javaTypeResolver> <!-- java模型创建器,是必须要的元素 负责:1,key类(见context的defaultModelType);2,java类;3,查询类 targetPackage:生成的类要放的包,真实的包受enableSubPackages属性控制; targetProject:目标项目,指定一个存在的目录下,生成的内容会放到指定目录中,如果目录不存在,MBG不会自动建目录 --> <javaModelGenerator targetPackage="com._520it.mybatis.domain" targetProject="src/main/java"> <!-- for MyBatis3/MyBatis3Simple 自动为每一个生成的类创建一个构造方法,构造方法包含了所有的field;而不是使用setter; --> <property name="constructorBased" value="false"/> <!-- 在targetPackage的基础上,根据数据库的schema再生成一层package,最终生成的类放在这个package下,默认为false --> <property name="enableSubPackages" value="true"/> <!-- for MyBatis3 / MyBatis3Simple 是否创建一个不可变的类,如果为true, 那么MBG会创建一个没有setter方法的类,取而代之的是类似constructorBased的类 --> <property name="immutable" value="false"/> <!-- 设置一个根对象, 如果设置了这个根对象,那么生成的keyClass或者recordClass会继承这个类;在Table的rootClass属性中可以覆盖该选项 注意:如果在key class或者record class中有root class相同的属性,MBG就不会重新生成这些属性了,包括: 1,属性名相同,类型相同,有相同的getter/setter方法; --> <property name="rootClass" value="com._520it.mybatis.domain.BaseDomain"/> <!-- 设置是否在getter方法中,对String类型字段调用trim()方法 --> <property name="trimStrings" value="true"/> </javaModelGenerator> <!-- 生成SQL map的XML文件生成器, 注意,在Mybatis3之后,我们可以使用mapper.xml文件+Mapper接口(或者不用mapper接口), 或者只使用Mapper接口+Annotation,所以,如果 javaClientGenerator配置中配置了需要生成XML的话,这个元素就必须配置 targetPackage/targetProject:同javaModelGenerator --> <sqlMapGenerator targetPackage="com._520it.mybatis.mapper" targetProject="src/main/resources"> <!-- 在targetPackage的基础上,根据数据库的schema再生成一层package,最终生成的类放在这个package下,默认为false --> <property name="enableSubPackages" value="true"/> </sqlMapGenerator> <!-- 对于mybatis来说,即生成Mapper接口,注意,如果没有配置该元素,那么默认不会生成Mapper接口 targetPackage/targetProject:同javaModelGenerator type:选择怎么生成mapper接口(在MyBatis3/MyBatis3Simple下): 1,ANNOTATEDMAPPER:会生成使用Mapper接口+Annotation的方式创建(SQL生成在annotation中),不会生成对应的XML; 2,MIXEDMAPPER:使用混合配置,会生成Mapper接口,并适当添加合适的Annotation,但是XML会生成在XML中; 3,XMLMAPPER:会生成Mapper接口,接口完全依赖XML; 注意,如果context是MyBatis3Simple:只支持ANNOTATEDMAPPER和XMLMAPPER --> <javaClientGenerator targetPackage="com._520it.mybatis.mapper" type="ANNOTATEDMAPPER" targetProject="src/main/java"> <!-- 在targetPackage的基础上,根据数据库的schema再生成一层package,最终生成的类放在这个package下,默认为false --> <property name="enableSubPackages" value="true"/> <!-- 可以为所有生成的接口添加一个父接口,但是MBG只负责生成,不负责检查 <property name="rootInterface" value=""/> --> </javaClientGenerator> <!-- 选择一个table来生成相关文件,可以有一个或多个table,必须要有table元素 选择的table会生成一下文件: 1,SQL map文件 2,生成一个主键类; 3,除了BLOB和主键的其他字段的类; 4,包含BLOB的类; 5,一个用户生成动态查询的条件类(selectByExample, deleteByExample),可选; 6,Mapper接口(可选) tableName(必要):要生成对象的表名; 注意:大小写敏感问题。正常情况下,MBG会自动的去识别数据库标识符的大小写敏感度,在一般情况下,MBG会 根据设置的schema,catalog或tablename去查询数据表,按照下面的流程: 1,如果schema,catalog或tablename中有空格,那么设置的是什么格式,就精确的使用指定的大小写格式去查询; 2,否则,如果数据库的标识符使用大写的,那么MBG自动把表名变成大写再查找; 3,否则,如果数据库的标识符使用小写的,那么MBG自动把表名变成小写再查找; 4,否则,使用指定的大小写格式查询; 另外的,如果在创建表的时候,使用的""把数据库对象规定大小写,就算数据库标识符是使用的大写,在这种情况下也会使用给定的大小写来创建表名; 这个时候,请设置delimitIdentifiers="true"即可保留大小写格式; 可选: 1,schema:数据库的schema; 2,catalog:数据库的catalog; 3,alias:为数据表设置的别名,如果设置了alias,那么生成的所有的SELECT SQL语句中,列名会变成:alias_actualColumnName 4,domainObjectName:生成的domain类的名字,如果不设置,直接使用表名作为domain类的名字;可以设置为somepck.domainName,那么会自动把domainName类再放到somepck包里面; 5,enableInsert(默认true):指定是否生成insert语句; 6,enableSelectByPrimaryKey(默认true):指定是否生成按照主键查询对象的语句(就是getById或get); 7,enableSelectByExample(默认true):MyBatis3Simple为false,指定是否生成动态查询语句; 8,enableUpdateByPrimaryKey(默认true):指定是否生成按照主键修改对象的语句(即update); 9,enableDeleteByPrimaryKey(默认true):指定是否生成按照主键删除对象的语句(即delete); 10,enableDeleteByExample(默认true):MyBatis3Simple为false,指定是否生成动态删除语句; 11,enableCountByExample(默认true):MyBatis3Simple为false,指定是否生成动态查询总条数语句(用于分页的总条数查询); 12,enableUpdateByExample(默认true):MyBatis3Simple为false,指定是否生成动态修改语句(只修改对象中不为空的属性); 13,modelType:参考context元素的defaultModelType,相当于覆盖; 14,delimitIdentifiers:参考tableName的解释,注意,默认的delimitIdentifiers是双引号,如果类似MYSQL这样的数据库,使用的是`(反引号,那么还需要设置context的beginningDelimiter和endingDelimiter属性) 15,delimitAllColumns:设置是否所有生成的SQL中的列名都使用标识符引起来。默认为false,delimitIdentifiers参考context的属性 注意,table里面很多参数都是对javaModelGenerator,context等元素的默认属性的一个复写; --> <table tableName="userinfo" > <!-- 参考 javaModelGenerator 的 constructorBased属性--> <property name="constructorBased" value="false"/> <!-- 默认为false,如果设置为true,在生成的SQL中,table名字不会加上catalog或schema; --> <property name="ignoreQualifiersAtRuntime" value="false"/> <!-- 参考 javaModelGenerator 的 immutable 属性 --> <property name="immutable" value="false"/> <!-- 指定是否只生成domain类,如果设置为true,只生成domain类,如果还配置了sqlMapGenerator,那么在mapper XML文件中,只生成resultMap元素 --> <property name="modelOnly" value="false"/> <!-- 参考 javaModelGenerator 的 rootClass 属性 <property name="rootClass" value=""/> --> <!-- 参考javaClientGenerator 的 rootInterface 属性 <property name="rootInterface" value=""/> --> <!-- 如果设置了runtimeCatalog,那么在生成的SQL中,使用该指定的catalog,而不是table元素上的catalog <property name="runtimeCatalog" value=""/> --> <!-- 如果设置了runtimeSchema,那么在生成的SQL中,使用该指定的schema,而不是table元素上的schema <property name="runtimeSchema" value=""/> --> <!-- 如果设置了runtimeTableName,那么在生成的SQL中,使用该指定的tablename,而不是table元素上的tablename <property name="runtimeTableName" value=""/> --> <!-- 注意,该属性只针对MyBatis3Simple有用; 如果选择的runtime是MyBatis3Simple,那么会生成一个SelectAll方法,如果指定了selectAllOrderByClause,那么会在该SQL中添加指定的这个order条件; --> <property name="selectAllOrderByClause" value="age desc,username asc"/> <!-- 如果设置为true,生成的model类会直接使用column本身的名字,而不会再使用驼峰命名方法,比如BORN_DATE,生成的属性名字就是BORN_DATE,而不会是bornDate --> <property name="useActualColumnNames" value="false"/> <!-- generatedKey用于生成生成主键的方法, 如果设置了该元素,MBG会在生成的<insert>元素中生成一条正确的<selectKey>元素,该元素可选 column:主键的列名; sqlStatement:要生成的selectKey语句,有以下可选项: Cloudscape:相当于selectKey的SQL为: VALUES IDENTITY_VAL_LOCAL() DB2 :相当于selectKey的SQL为: VALUES IDENTITY_VAL_LOCAL() DB2_MF :相当于selectKey的SQL为:SELECT IDENTITY_VAL_LOCAL() FROM SYSIBM.SYSDUMMY1 Derby :相当于selectKey的SQL为:VALUES IDENTITY_VAL_LOCAL() HSQLDB :相当于selectKey的SQL为:CALL IDENTITY() Informix :相当于selectKey的SQL为:select dbinfo('sqlca.sqlerrd1') from systables where tabid=1 MySql :相当于selectKey的SQL为:SELECT LAST_INSERT_ID() SqlServer :相当于selectKey的SQL为:SELECT SCOPE_IDENTITY() SYBASE :相当于selectKey的SQL为:SELECT @@IDENTITY JDBC :相当于在生成的insert元素上添加useGeneratedKeys="true"和keyProperty属性 <generatedKey column="" sqlStatement=""/> --> <!-- 该元素会在根据表中列名计算对象属性名之前先重命名列名,非常适合用于表中的列都有公用的前缀字符串的时候, 比如列名为:CUST_ID,CUST_NAME,CUST_EMAIL,CUST_ADDRESS等; 那么就可以设置searchString为"^CUST_",并使用空白替换,那么生成的Customer对象中的属性名称就不是 custId,custName等,而是先被替换为ID,NAME,EMAIL,然后变成属性:id,name,email; 注意,MBG是使用java.util.regex.Matcher.replaceAll来替换searchString和replaceString的, 如果使用了columnOverride元素,该属性无效; <columnRenamingRule searchString="" replaceString=""/> --> <!-- 用来修改表中某个列的属性,MBG会使用修改后的列来生成domain的属性; column:要重新设置的列名; 注意,一个table元素中可以有多个columnOverride元素哈~ --> <columnOverride column="username"> <!-- 使用property属性来指定列要生成的属性名称 --> <property name="property" value="userName"/> <!-- javaType用于指定生成的domain的属性类型,使用类型的全限定名 <property name="javaType" value=""/> --> <!-- jdbcType用于指定该列的JDBC类型 <property name="jdbcType" value=""/> --> <!-- typeHandler 用于指定该列使用到的TypeHandler,如果要指定,配置类型处理器的全限定名 注意,mybatis中,不会生成到mybatis-config.xml中的typeHandler 只会生成类似:where id = #{id,jdbcType=BIGINT,typeHandler=com._520it.mybatis.MyTypeHandler}的参数描述 <property name="jdbcType" value=""/> --> <!-- 参考table元素的delimitAllColumns配置,默认为false <property name="delimitedColumnName" value=""/> --> </columnOverride> <!-- ignoreColumn设置一个MGB忽略的列,如果设置了改列,那么在生成的domain中,生成的SQL中,都不会有该列出现 column:指定要忽略的列的名字; delimitedColumnName:参考table元素的delimitAllColumns配置,默认为false 注意,一个table元素中可以有多个ignoreColumn元素 <ignoreColumn column="deptId" delimitedColumnName=""/> --> </table> </context> </generatorConfiguration> 作者:小码哥Java学院 链接:https://www.jianshu.com/p/e09d2370b796 來源:简书 著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。
#MyBatis Geneator详解
作者:abel533(isea533)
博客地址:http://blog.csdn.net/isea533
github:https://github.com/abel533
gitosc:http://git.oschina.net/free
##MyBatis Geneator中文文档
MyBatis Geneator中文文档地址:
http://generator.sturgeon.mopaas.com/
该中文文档由于尽可能和原文内容一致,所以有些地方如果不熟悉,看中文版的文档的也会有一定的障碍,所以本章根据该中文文档以及实际应用,使用通俗的语言来讲解详细的配置。
注:本文后面提到的MBG全部指代MyBatis Generator。
##运行MyBatis Generator
有4种运行MBG的方法,具体请看文档 运行 MyBatis Generator
MBG下载地址:http://repo1.maven.org/maven2/org/mybatis/generator/mybatis-generator-core/
后续会专门为gitbook完善此部分
##XML配置详解
在MBG中,最主要也最重要的就是XML配置文件,因此本篇文章主要的内容就是XML配置。
这里按照配置的顺序对配置逐个讲解,更细的内容可以配合中文文档参照。
###1. 配置文件头
<?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">
使用最新版的MBG需要使用上面的xml头,配置文件必须包含上面的
DOCTYPE。
###2. 根节点
<generatorConfiguration>
generatorConfiguration节点没有任何属性,直接写节点即可,如下:
<generatorConfiguration> <!-- 具体配置内容 --> </generatorConfiguration>
###3.
<generatorConfiguration>子元素
从这段开始,就是配置的主要内容,这些配置都是
generatorConfiguration元素的子元素。
包含以下子元素(有严格的顺序):
<properties>(0个或1个)
<classPathEntry>(0个或多个)
<context>(1个或多个)
####3.1
<properties>元素
这个元素用来指定外部的属性元素,不是必须的元素。
元素用于指定一个需要在配置中解析使用的外部属性文件,引入属性文件后,可以在配置中使用
${property}这种形式的引用,通过这种方式引用属性文件中的属性值。
对于后面需要配置的jdbc信息和
targetProject属性会很有用。
这个属性可以通过
resource或者
url来指定属性文件的位置,这两个属性只能使用其中一个来指定,同时出现会报错。
resource:指定classpath下的属性文件,使用类似
com/myproject/generatorConfig.properties这样的属性值。
url:可以指定文件系统上的特定位置,例如
file:///C:/myfolder/generatorConfig.properties
####3.2
<classPathEntry>元素
这个元素可以0或多个,不受限制。
这个元素的作用是将MBG运行时需要用到的jar包(或zip格式)添加到classpath下。
最常见的用法是,当classpath下面没有JDBC驱动的时候,我们通常通过这个属性指定驱动的路径,例如:
<classPathEntry location="E:\mysql\mysql-connector-java-5.1.29.jar"/>
如果需要用到其他的jar包,也可以这么配置,例如如果你开发了一个MBG的插件,你就可以通过这种方式加入到classpath
这里注意上面重点强调的 没有,一般在项目中使用的时候,classpath下面都有JDBC驱动,因此从项目中启动的时候不需要配置该项。
建议:由于该参数使用了绝对路径,因此不利用在不同电脑上通用,因此建议最好把需要的jar包放到项目的classpath下,避免每个人都得单独配置路径。
####3.3
<context>元素
在MBG的配置中,至少需要有一个
<context>元素。
<context>元素用于指定生成一组对象的环境。例如指定要连接的数据库,要生成对象的类型和要处理的数据库中的表。运行MBG的时候还可以指定要运行的
<context>。
该元素只有一个必选属性
id,用来唯一确定一个
<context>元素,该
id属性可以在运行MBG的使用。
此外还有几个可选属性:
defaultModelType:这个属性很重要,这个属性定义了MBG如何生成实体类。
这个属性有以下可选值:
conditional:这是默认值,这个模型和下面的
hierarchical类似,除了如果那个单独的类将只包含一个字段,将不会生成一个单独的类。
因此,如果一个表的主键只有一个字段,那么不会为该字段生成单独的实体类,会将该字段合并到基本实体类中。
flat:该模型为每一张表只生成一个实体类。这个实体类包含表中的所有字段。这种模型最简单,推荐使用。
hierarchical:如果表有主键,那么该模型会产生一个单独的主键实体类,如果表还有BLOB字段,
则会为表生成一个包含所有BLOB字段的单独的实体类,然后为所有其他的字段生成一个单独的实体类。 MBG会在所有生成的实体类之间维护一个继承关系。
targetRuntime:此属性用于指定生成的代码的运行时环境。该属性支持以下可选值:
MyBatis3:这是默认值
MyBatis3Simple
Ibatis2Java2
Ibatis2Java5一般情况下使用默认值即可,有关这些值的具体作用以及区别请查看中文文档的详细内容。
introspectedColumnImpl:该参数可以指定扩展
org.mybatis.generator.api.IntrospectedColumn该类的实现类。该属性的作用可以查看扩展MyBatis
Generator。
一般情况下,我们使用如下的配置即可:
<context id="Mysql" defaultModelType="flat">
如果你希望不生成和
Example查询有关的内容,那么可以按照如下进行配置:
<context id="Mysql" targetRuntime="MyBatis3Simple" defaultModelType="flat">
使用
MyBatis3Simple可以避免在后面的
<table>中逐个进行配置(后面会提到)。
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>属性前,我们先看看什么是分隔符?。
这里通过一个例子说明。假设在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文件的样式,你可以通过指定这两个属性的值来实现。
接下来分节对其他的子元素逐个进行介绍。
#####3.3.1
<plugin>元素
该元素可以配置0个或者多个,不受限制。
<plugin>元素用来定义一个插件。插件用于扩展或修改通过MyBatis
Generator (MBG)代码生成器生成的代码。
插件将按在配置中配置的顺序执行。
有关插件的详细信息可以参考开发插件和提供的插件了解更多。
#####3.3.2
<commentGenerator>元素
该元素最多可以配置1个。
这个元素非常有用,相信很多人都有过这样的需求,就是希望MBG生成的代码中可以包含注释信息,具体就是生成表或字段的备注信息。
使用这个元素就能很简单的实现我们想要的功能。这里先介绍该元素,介绍完后会举例如何扩展实现该功能。
该元素有一个可选属性
type,可以指定用户的实现类,该类需要实现
org.mybatis.generator.api.CommentGenerator接口。而且必有一个默认的构造方法。这个属性接收默认的特殊值
DEFAULT,会使用默认的实现类
org.mybatis.generator.internal.DefaultCommentGenerator。
默认的实现类中提供了两个可选属性,需要通过
<property>属性进行配置。
suppressAllComments:阻止生成注释,默认为
false
suppressDate:阻止生成的注释包含时间戳,默认为
false
一般情况下由于MBG生成的注释信息没有任何价值,而且有时间戳的情况下每次生成的注释都不一样,使用版本控制的时候每次都会提交,因而一般情况下我们都会屏蔽注释信息,可以如下配置:
<commentGenerator> <property name="suppressAllComments" value="true"/> <property name="suppressDate" value="true"/> </commentGenerator>
接下来我们简单举例实现生成包含表字段注释信息的注释
因为系统提供了一个默认的实现类,所以对我们来说,自己实现一个会很容易,最简单的方法就是复制默认实现类代码到一个新的文件中,修改类名如
MyCommentGenerator,在你自己的实现类中,你可以选择是否继续支持上面的两个属性,你还可以增加对其他属性的支持。
我们通过下面一个方法的修改来了解,其他几个方法请自行修改(写本章的时候我也没有完全实现该类,所以不提供完整源码了):
@Override public void addFieldComment(Field field, IntrospectedTable introspectedTable, IntrospectedColumn introspectedColumn) { if (introspectedColumn.getRemarks() != null && !introspectedColumn.getRemarks().equals("")) { field.addJavaDocLine("/**"); field.addJavaDocLine(" * " + introspectedColumn.getRemarks()); addJavadocTag(field, false); field.addJavaDocLine(" */"); } }
这个方法是给字段添加注释信息的,其中
IntrospectedColumn包含了字段的完整信息,通过
getRemarks方法可以获取字段的注释信息。上面这个方法修改起来还是很容易的。除了字段的注释外还有
Getter和
Setter,以及类的注释。此外还有生成XML的注释,大家可以根据默认的实现进行修改。
完成我们自己的实现类后,我们还需要做如下配置:
<commentGenerator type="com.github.abel533.mybatis.generator.MyCommentGenerator"/>
#####3.3.3
<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>
#####3.3.4
<javaTypeResolver>元素
该元素最多可以配置一个。
这个元素的配置用来指定JDBC类型和Java类型如何转换。
该元素提供了一个可选的属性
type,和
<commentGenerator>比较类型,提供了默认的实现
DEFAULT,一般情况下使用默认即可,需要特殊处理的情况可以通过其他元素配置来解决,不建议修改该属性。
该属性还有一个可以配置的
<property>元素。
可以配置的属性为
forceBigDecimals,该属性可以控制是否强制
DECIMAL和
NUMERIC类型的字段转换为Java类型的
java.math.BigDecimal,默认值为
false,一般不需要配置。
默认情况下的转换规则为:
如果
精度>0或者
长度>18,就会使用
java.math.BigDecimal
如果
精度=0并且
10<=长度<=18,就会使用
java.lang.Long
如果
精度=0并且
5<=长度<=9,就会使用
java.lang.Integer
如果
精度=0并且
长度<5,就会使用
java.lang.Short
如果设置为
true,那么一定会使用
java.math.BigDecimal,配置示例如下:
<javaTypeResolver > <property name="forceBigDecimals" value="true" /> </javaTypeResolver>
#####3.3.5
<javaModelGenerator>元素
该元素必须配置一个,并且最多一个。
该元素用来控制生成的实体类,根据
<context>中配置的
defaultModelType,一个表可能会对应生成多个不同的实体类。一个表对应多个类实际上并不方便,所以前面也推荐使用
flat,这种情况下一个表对应一个实体类。
该元素只有两个属性,都是必选的。
targetPackage:生成实体类存放的包名,一般就是放在该包下。实际还会受到其他配置的影响(
<table>中会提到)。
targetProject:指定目标项目路径,使用的是文件系统的绝对路径。
该元素支持以下几个
<property>子元素属性:
constructorBased:该属性只对
MyBatis3有效,如果
true就会使用构造方法入参,如果
false就会使用
setter方式。默认为
false。
enableSubPackages:如果
true,MBG会根据
catalog和
schema来生成子包。如果
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>
#####3.3.6
<sqlMapGenerator>元素
该元素可选,最多配置一个。但是有如下两种必选的特殊情况:
如果
targetRuntime目标是iBATIS2,该元素必须配置一个。
如果
targetRuntime目标是MyBatis3,只有当
<javaClientGenerator>需要XML时,该元素必须配置一个。
如果没有配置
<javaClientGenerator>,则使用以下的规则:
如果指定了一个
<sqlMapGenerator>,那么MBG将只生成XML的SQL映射文件和实体类。
如果没有指定
<sqlMapGenerator>,那么MBG将只生成实体类。
该元素只有两个属性(和前面提过的
<javaModelGenerator>的属性含义一样),都是必选的。
targetPackage:生成实体类存放的包名,一般就是放在该包下。实际还会受到其他配置的影响(
<table>中会提到)。
targetProject:指定目标项目路径,使用的是文件系统的绝对路径。
该元素支持
<property>子元素,只有一个可以配置的属性:
enableSubPackages:如果
true,MBG会根据
catalog和
schema来生成子包。如果
false就会直接用
targetPackage属性。默认为
false。
配置示例:
<sqlMapGenerator targetPackage="test.xml" targetProject="E:\MyProject\src\main\resources"> <property name="enableSubPackages" value="true" /> </sqlMapGenerator>
#####3.3.7
<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文件。
Ibatis2Java2或Ibatis2Java5:
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"/>
#####3.3.8
<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,
schema或
tableName中包含空白时,默认为
true。
delimitAllColumns:是否对所有列添加分隔符。默认
false。
该元素包含多个可用的
<property>子元素,可选属性为:
constructorBased:和
<javaModelGenerator>中的属性含义一样。
ignoreQualifiersAtRuntime:生成的SQL中的表名将不会包含
schema和
catalog前缀。
immutable:和
<javaModelGenerator>中的属性含义一样。
modelOnly:此属性用于配置是否为表只生成实体类。如果设置为
true就不会有Mapper接口。如果配置了
<sqlMapGenerator>,并且
modelOnly为
true,那么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>(0个或1个)
<columnRenamingRule>(0个或1个)
<columnOverride>(0个或多个)
<ignoreColumn>(0个或多个)
下面对这4个元素进行详细讲解。
1.
<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>
2.
<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对此的影响可以查看完整文档。
3.
<columnOverride>元素
该元素可选,可以配置多个。
该元素从将某些属性默认计算的值更改为指定的值。
该元素有一个必选属性:
column:要重写的列名。
该元素有多个可选属性:
property:要使用的Java属性的名称。如果没有指定,MBG会根据列名生成。
例如,如果一个表的一列名为
STRT_DTE,MBG会根据
<table>的
useActualColumnNames属性生成
STRT_DTE或
strtDte。
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>
4.
<ignoreColumn>元素
该元素可选,可以配置多个。
该元素可以用来屏蔽不需要生成的列。
该元素有一个必选属性:
column:要忽略的列名。
该元素还有一个可选属性:
delimitedColumnName:匹配列名的时候是否区分大小写。如果为
true则区分。默认值为
false,不区分大小写。
##MyBatis Generator最佳实践
本节内容针对MyBatis3,使用iBATIS的不一定适用。
以下根据个人经验(对此有意见的可以留言)对一些配置看法列出如下几点:
关于
Example方法,
Example方法虽然很强大,但是SQL不易管理,因此不建议使用。
取消
Example方法的配置,通过
<table>上的
enablexxExample方法可以屏蔽,但是最好的方法是在
<context>上设置
targetRuntime="MyBatis3Simple"。
关于实体类的
modelType,建议使用
defaultModelType="flat",只有一个对象的情况下管理毕竟方便,使用也简单。
关于注释
<commentGenerator>,不管你是否要重写自己的注释生成器,有一点不能忘记,那就是注释中一定要保留
@mbggenerated,MBG通过该字符串来判断代码是否为代码生成器生成的代码,有该标记的的代码在重新生成的时候会被删除,不会重复。不会在XML中出现重复元素。
使用MBG生成的代码时,建议尽可能不要去修改自动生成的代码,而且要生成带有
@mbggenerated,这样才不会在每次重新生成代码的时候需要手动修改好多内容。
仍然是注释相关,在
<commentGenerator>中,建议一定要保留
suppressAllComments属性(使用默认值
false),一定要取消(设为
true)时间戳
suppressDate,避免重复提交SVN。
<jdbcConnection>建议将JDBC驱动放到项目的classpath下,而不是使用
<classPathEntry>来引入jar包,主要考虑到所有开发人员的统一性。
当数据库字段使用
CHAR时,建议在
<javaModelGenerator>中设置
<property name="trimStrings" value="true" />,可以自动去掉不必要的空格。
在
<javaClientGenerator>中,建议设置
type="XMLMAPPER",不建议使用注解或混合模式,比较代码和SQL完全分离易于维护。
建议尽可能在
<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字段。如果不是所有表的配置都一样,可以做针对性的配置。
Mbg配置说明:
https://gitee.com/free/Mybatis_Utils/blob/master/MybatisGeneator/MybatisGeneator.md
相关文章推荐
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解
- myeclipse10的Mybatis插件 Generator最完整配置详解
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解【转】
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解
- Mybatis Generator最完整配置详解