mybatis ****MBG

Mybatis Generator:mybatis 提供的一个很强大的代码生成器,可生成数据库表对应的实体类,Mapper 接口类,Mapper xml文件和Example 等,这些代码文件几乎包括了全部的表单操作方法。

其核心配置文件 :generatorConfig.xml

  • generatorConfiguration   ——根节点
    • properties  ——可引入外部属性文件
      • classPathEntry   —— MBG运行时,需要依赖的外部包
      • context   ——指定生成一组对象的环境
        • property(0 个或多个)——设置一些固定的属性(文件编码)
        • plugin(0 个或多个)——定义一个插件拓展或者修改MBG生成的代码
        • commenGenerator(0 个或 1 个)  ——配置如何生成注释信息
        • jdbcConnection( 1 个)——配置连接数据库
        • javaTypeResolver( 0 个或 1 个) ——指定jdbc类型和java 类型怎么转换
        • javaModelGenerator ( 1 个) ——Java 模型创造器(指定实体类的包或者设置实体类继承的父类...)
        • sqlMapGenerator  (0 个或 1 个)——  map的XML文件生成器(指定Mapper xml 文件的包...)
        • javaClientGenerator (0 个或 1 个)——生成Mapper接口 (指定Mapper 接口的包...)
        • table  ( 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" >
<generatorConfiguration>

	<!-- 加载数据库驱动 -->
	<classPathEntry location="mysql-connector-java-5.1.18.jar" />
	
	<!-- 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; 
     -->
	<context id="context1" targetRuntime="MyBatis3"	defaultModelType="flat">
	
	    <!-- 生成的Java文件的编码 -->
    	<property name="javaFileEncoding" value="UTF-8"/>
	
	
		<commentGenerator>
			<!-- 是否去除自动生成的注释 true:是 : false:否 -->
			<property name="suppressAllComments" value="false" />
			<!-- 阻止注释中包含时间戳 true:是 : false:否 -->
			<property name="suppressDate" value="true" />
			<!--  注释是否包含数据库表的注释信息  true:是 : false:否 -->
			<property name="addRemarkComments" value="true" />
		</commentGenerator>
		<!--数据库连接的信息:驱动类、连接地址、用户名、密码 -->
		<jdbcConnection driverClass="com.mysql.jdbc.Driver"
			connectionURL="jdbc:mysql://localhost:3306/mybatis" userId="root" password="root" />


        <!-- java模型创建器,是必须要的元素   负责:1,key类(见context的defaultModelType);2,java类;3,查询类
        	targetPackage:生成的类要放的包,真实的包受enableSubPackages属性控制;
        	targetProject:目标项目,指定一个存在的目录下,生成的内容会放到指定目录中,如果目录不存在,MBG不会自动建目录
     	-->
		<javaModelGenerator targetPackage="com.mybatis.entity" targetProject="src/main/java">
			<!-- 设置一个根对象,
	                      如果设置了这个根对象,那么生成的keyClass或者recordClass会继承这个类;在Table的rootClass属性中可以覆盖该选项
	                      注意:如果在key class或者record class中有root class相同的属性,MBG就不会重新生成这些属性了,包括:
	                1,属性名相同,类型相同,有相同的getter/setter方法;
	         -->
			<property name="rootClass" value="com.mybatis.entity.BaseEntity" />
		</javaModelGenerator>


		<!-- 生成SQL map的XML文件生成器,
            targetPackage:生成的类要放的包,真实的包受enableSubPackages属性控制;
        	targetProject:目标项目,指定一个存在的目录下,生成的内容会放到指定目录中,如果目录不存在,MBG不会自动建目录
         -->
		<sqlMapGenerator targetPackage="." targetProject="src/main/resources/sqlmapper">
		</sqlMapGenerator>
		
		
		 <!-- 对于mybatis来说,即生成Mapper接口,注意,如果没有配置该元素,那么默认不会生成Mapper接口 
		        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.mybatis.mapper"	targetProject="src/main/java" type="XMLMAPPER" />




		<!-- shema 数据库 tableName表明 -->
		<table schema="${jdbc_username}" tableName="%"   enableCountByExample="false"
			enableUpdateByExample="false" enableDeleteByExample="false"
			enableSelectByExample="false" selectByExampleQueryId="false">
			<generatedKey column="id" sqlStatement="MySql"/>
		</table>


	</context>
</generatorConfiguration>

三种启动方式:

一、使用命令提示符,cmd中启动MBG:

1、建立相关的包名:需要根据核心配置文件generatorConfig.xml 中的配置指定的包名来建立包结构

  • src
    • main
      • java   —— 这个目录下指定的包会自动生成,不需要自己新建
      • resource ——如果指定的时resource下面的包,则需要自己建立
        • sqlmapper

2、把运行时需要的jar包以及核心配置文件 copy 过来

3、打开cmd,通过cd 命令切换到这个目录之下  运行命令:

java -jar mybatis-generator-core-x.x.x.jar -configfile generatorConfig.xml 

 

二、使用Maven Plugin

1、在pom.xml 文件中引入generator 插件

<build>
		<plugins>
			<plugin>
				<groupId>org.mybatis.generator</groupId>
				<artifactId>mybatis-generator-maven-plugin</artifactId>
				<version>1.3.2</version>
				<configuration>
					<verbose>true</verbose>
					<overwrite>true</overwrite>
				</configuration>
			</plugin>
		</plugins>
	</build>

2、 把核心配置文件generatorConfig.xml 放在src\main\resources 目录下,建立好在generatorConfig.xml 指定的src/source下面的存放路径。

3、运行命令: mybatis-generator:generate 。

eclipse:右键项目——>Run As——>Maven build——>然后在Goals 中输入:mybatis-generator:generate ——>点击Run 即可

idea:

 三、使用java 程序启动

和第二种方式类似:配置好generatorConfig.xml、新建相关的目录结构、pom.xml 引入相关的插件。

只是多写了一个main 方法,执行这个main 方法去启动MBG。

//使用junit 启动
    @Test
	public void mybatisGeneratorTest() throws FileNotFoundException{
		List<String> warnings = new ArrayList<String>();  
        boolean overwrite = true;
        String genCfg = "generatorConfig.xml";  
        File configFile = new File(getClass().getClassLoader().getResource(genCfg).getFile());
        ConfigurationParser cp = new ConfigurationParser(warnings);  
        Configuration config = null;  
        try {  
            config = cp.parseConfiguration(configFile);  
        } catch (IOException e) {  
            e.printStackTrace();  
        } catch (XMLParserException e) {  
            e.printStackTrace();  
        }  
        DefaultShellCallback callback = new DefaultShellCallback(overwrite);  
        MyBatisGenerator myBatisGenerator = null;  
        try {  
            myBatisGenerator = new MyBatisGenerator(config, callback, warnings);  
        } catch (InvalidConfigurationException e) {  
            e.printStackTrace();  
        }  
        try {  
            myBatisGenerator.generate(null);  
        } catch (SQLException e) {  
            e.printStackTrace();  
        } catch (IOException e) {  
            e.printStackTrace();  
        } catch (InterruptedException e) {  
            e.printStackTrace();  
        }  
    }