首页 > 代码库 > MyBatis Generator作为maven插件自动生成增删改查代码及配置文件例子
MyBatis Generator作为maven插件自动生成增删改查代码及配置文件例子
什么是MyBatis Generator
MyBatis Generator (MBG) 是一个Mybatis的代码生成器,可以自动生成一些简单的CRUD(插入,查询,更新,删除)操作代码,model代码,及mapper配置文件;
如何配置MyBatis Generator
代码生成器(MBG)是由一个XML配置文件驱动,主要告诉MBG以下三件事
- 如何连接到数据库
- 生成什么对象,以及如何生成它们
- 那些表生成对象
具体如何配置,可以参考如下链接,已经有很详细的说明了:
http://generator.sturgeon.mopaas.com/configreference/xmlconfig.html
这里给出本Demo的配置,以及相应的注释,如下:
<?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><!-- MyBatis3Simple 这是默认值 不会有"by example"一类的方法,只有少量的动态SQL。flat 该模型为每一张表只生成一个实体类。这个实体类包含表中的所有字段 --> <context id="default" targetRuntime="MyBatis3Simple" defaultModelType="flat"> <!-- 该插件给实体类添加toString()方法 --> <plugin type="org.mybatis.generator.plugins.ToStringPlugin"/> <!-- 这个插件给由MBG生成的Java模型对象增加了equals和hashCode方法 --> <plugin type="org.mybatis.generator.plugins.EqualsHashCodePlugin"/> <!-- 不希望生成的注释中包含时间戳 --> <commentGenerator> <property name="suppressDate" value="true" /> </commentGenerator> <jdbcConnection driverClass="com.mysql.jdbc.Driver" connectionURL="jdbc:mysql://localhost:3306/demo?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull" userId="root" password="root"> </jdbcConnection> <!-- 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; --> <javaTypeResolver> <property name="forceBigDecimals" value="false"/> </javaTypeResolver> <javaModelGenerator targetPackage="cn.edu.hdu.mbgdemo.model.generator" targetProject="src/main/java"> <!-- 是否 自动为每一个生成的类创建一个构造方法--> <property name="constructorBased" value="false"/> <property name="useActualColumnNames" value="true" /> <!-- 在targetPackage的基础上,根据数据库的schema再生成一层package--> <property name="enableSubPackages" value="false"/> <!-- 是否创建一个不可变的类 --> <property name="immutable" value="false"/> <!-- 设置是否在getter方法中,对String类型字段调用trim()方法 --> <property name="trimStrings" value="true"/> <property name="rootClass" value="cn.edu.hdu.mbgdemo.base.BaseModel"/> </javaModelGenerator> <!-- 生成SQL map的XML文件生成器--> <sqlMapGenerator targetPackage="mappers.generator" targetProject="src/main/resources"> <property name="enableSubPackages" value="false"/> </sqlMapGenerator> <javaClientGenerator targetPackage="cn.edu.hdu.mbgdemo.dao.generator" targetProject="src/main/java" type="XMLMAPPER"> <property name="enableSubPackages" value="false"/> <property name="rootInterface" value="cn.edu.hdu.mbgdemo.base.BaseDao"/> </javaClientGenerator> <!--这里包含SQL通配符,表示匹配所有demo开头的表--> <table tableName="demo_%"> </table> </context></generatorConfiguration>
其实官网有很全的注释,想要了解更多配置,最好参考官网。
如何运行MyBatis Generator
有以下四种运行方式:
- 从 命令提示符 使用 XML 配置文件
- 作为 Ant 任务 使用 XML 配置文件
- 作为 Maven Plugin
- 从另一个 Java 程序 使用 XML 配置文件
个人比较推荐作为maven插件运行,方便集成,部署。
MyBatis Generator例子
新建一个maven工程,编写pom.xml文件,如下,主要是添加mybatis-generator-maven-plugin插件:
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>cn.edu.hdu.mbgdemo</groupId> <artifactId>mbgdemo</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>jar</packaging> <name>mbgdemo</name> <url>http://maven.apache.org</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </dependency> <dependency> <groupId>org.mybatis.generator</groupId> <artifactId>mybatis-generator-core</artifactId> <version>1.3.2</version> </dependency> </dependencies> <build> <finalName>${project.name}</finalName> <resources> <resource> <directory>src/main/java</directory> </resource> </resources> <pluginManagement> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.3</version> <configuration> <source>1.7</source> <target>1.7</target> <encoding>UTF-8</encoding> </configuration> </plugin> <!--帮助开发者让他们的代码兼容下一版本的Java,,Java 9开始,内部API将变为不可访问--> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-jdeps-plugin</artifactId> <version>3.0.0</version> <executions> <execution> <goals> <goal>jdkinternals</goal><!--检查主代码中是否包含对内部API的引用--> <goal>test-jdkinternals</goal><!--检查测试代码中是否包含对内部API的引用--> </goals> </execution> </executions> </plugin> <plugin> <groupId>org.mybatis.generator</groupId> <artifactId>mybatis-generator-maven-plugin</artifactId> <version>1.3.2</version> <configuration> <verbose>true</verbose> <overwrite>true</overwrite> <configurationFile>src/main/resources/generatorConfig-demo.xml</configurationFile> </configuration> <dependencies> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.30</version> </dependency> </dependencies> <executions> <execution> <id>Generate MyBatis Artifacts</id> <goals> <goal>generate</goal> </goals> </execution> </executions> </plugin> </plugins> </pluginManagement> </build></project>
然后编写BaseDao和BaseModel,添加一些共性部分的代码用于被子类继承,如下:
public interface BaseDao<T extends BaseModel> { List<T> selectAll(); int delete(String id); T select(String id); int insert(T record); int update(T record);}
public class BaseModel implements Serializable { /** * ID */ private String id; /** * 是否有效 */ private Boolean valid; /** * 由谁创建 */ private String createBy; /** * 创建时间 */ private Date createTime; /** * 最后修改者 */ private String updateBy; /** * 最后修改时间 */ private Date updateTime; public String getId() { return id; } public void setId(String id) { this.id = id; } public Boolean getValid() { return valid; } public void setValid(Boolean valid) { this.valid = valid; } public String getCreateBy() { return createBy; } public void setCreateBy(String createBy) { this.createBy = createBy; } public Date getCreateTime() { return createTime; } public void setCreateTime(Date createTime) { this.createTime = createTime; } public String getUpdateBy() { return updateBy; } public void setUpdateBy(String updateBy) { this.updateBy = updateBy; } public Date getUpdateTime() { return updateTime; } public void setUpdateTime(Date updateTime) { this.updateTime = updateTime; }}
编写配置文件generatorConfig-demo.xml,前面部分已经给出了,这里就不贴了,按官网来配置即可。
最后执行mybatis-generator:generate命令即可;
执行前与执行后,可以发现自动生成了Dao代码,model代码,mapper配置文件:
这里可以看下自动生成的mapper配置文件,如下,可见mbg可以帮助我们大大提高开发效率,而且还可以尽量减少人为错误:
<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" ><mapper namespace="cn.edu.hdu.mbgdemo.dao.generator.DemoUserMapper" > <resultMap id="BaseResultMap" type="cn.edu.hdu.mbgdemo.model.generator.DemoUser" > <!-- WARNING - @mbggenerated This element is automatically generated by MyBatis Generator, do not modify. --> <id column="id" property="id" jdbcType="VARCHAR" /> <result column="name" property="name" jdbcType="VARCHAR" /> <result column="address" property="address" jdbcType="VARCHAR" /> </resultMap> <delete id="deleteByPrimaryKey" parameterType="java.lang.String" > <!-- WARNING - @mbggenerated This element is automatically generated by MyBatis Generator, do not modify. --> delete from demo_user where id = #{id,jdbcType=VARCHAR} </delete> <insert id="insert" parameterType="cn.edu.hdu.mbgdemo.model.generator.DemoUser" > <!-- WARNING - @mbggenerated This element is automatically generated by MyBatis Generator, do not modify. --> insert into demo_user (id, name, address ) values (#{id,jdbcType=VARCHAR}, #{name,jdbcType=VARCHAR}, #{address,jdbcType=VARCHAR} ) </insert> <update id="updateByPrimaryKey" parameterType="cn.edu.hdu.mbgdemo.model.generator.DemoUser" > <!-- WARNING - @mbggenerated This element is automatically generated by MyBatis Generator, do not modify. --> update demo_user set name = #{name,jdbcType=VARCHAR}, address = #{address,jdbcType=VARCHAR} where id = #{id,jdbcType=VARCHAR} </update> <select id="selectByPrimaryKey" resultMap="BaseResultMap" parameterType="java.lang.String" > <!-- WARNING - @mbggenerated This element is automatically generated by MyBatis Generator, do not modify. --> select id, name, address from demo_user where id = #{id,jdbcType=VARCHAR} </select> <select id="selectAll" resultMap="BaseResultMap" > <!-- WARNING - @mbggenerated This element is automatically generated by MyBatis Generator, do not modify. --> select id, name, address from demo_user </select></mapper>
当然,我们也可以自己往dao添加一些方法,然后在mapper配置文件里添加对应的配置信息。
Demo源码
https://github.com/peterchenhdu/Demos/tree/master/mbgdemo
MyBatis Generator作为maven插件自动生成增删改查代码及配置文件例子