MyBatis Generator使用记录

spring boot 2.5.3

Eclipse Version: 2021-03 (4.19.0)

org.mybatis.generator:mybatis-generator-maven-plugin:1.4.0

org.postgresql:postgresql

--

MyBatis强大的SQL数据库操作中间件；

MyBatis Generator用来【根据数据库中已经存在的表】建立实体类、Mapper类和XML文件等。

本文演示使用MyBatis Generator（使用PostgreSQL）。

注意，使用MyBatis Generator的前提是——数据表已经建立好（半自动，这和 Spring Data JPA 不同，当然，更多的代码可以搞定这事儿）。

建立S.B.项目，引入 mybatis、PostgreSQL 依赖：

  org.mybatis.spring.boot
  mybatis-spring-boot-starter
  2.2.0



  org.postgresql
  postgresql
  runtime

追加依赖包：

	org.projectlombok
	lombok

启动，失败——因为依赖了 mybatis-spring-boot-starter。

添加DataSource配置：

# 本机PostgreSQL
spring.datasource.url=jdbc:postgresql://localhost:5432/lib1
spring.datasource.username=postgres
spring.datasource.password=123456
spring.datasource.driver-class-name=org.postgresql.Driver

说明，如果只是使用MyBatis Generator建立一些Mapper文件，是不需要引入的。

启动，成功。

pom.xml添加 mybatis-generator-maven-plugin；合适的位置建立 generatorConfig.xml——本文是 src/main/resources/mbg 目录下。

// pom.xml


	org.mybatis.generator
	mybatis-generator-maven-plugin
	1.4.0
	
		${basedir}/src/main/resources/mbg/generatorConfig.xml
		true
		true
	
	
	
		
			org.postgresql
			postgresql
		
		
			org.mybatis.generator
			mybatis-generator-core
			1.4.0
		
	

注意，Eclipse自动安装了mybatis-generator-maven-plugin插件：

简单版generatorConfig.xml：

<?xml version="1.0" encoding="UTF-8"?>



	
	
	
    
        
        
        

        
        
        

        
        
        

        
        
        

        
        
    

注意，这里的 targetProject 都是项目名，而不是很多示例中的 路径，否则会出现错误——Project src does not exist问题。

注意，上面的标签中的内容还不完整，后续有机会再补充。

注意，上面的标签中子元素的顺序不能错，否则，运行不了的。

使用 MBG前目录结构：实体类、Mapper接口、Mapper.xml 都不存在。

提前建立数据表（下面的脚本来自 pgAdmin工具建立的表）：mbg_company

-- Table: public.mbg_company

-- DROP TABLE public.mbg_company;

CREATE TABLE IF NOT EXISTS public.mbg_company
(
    id integer NOT NULL DEFAULT nextval('mbg_company_id_seq'::regclass),
    name_cn character varying(100)[] COLLATE pg_catalog."default" NOT NULL,
    name_en character varying(200)[] COLLATE pg_catalog."default",
    founding_time timestamp without time zone,
    founder character varying(100)[] COLLATE pg_catalog."default",
    create_date date,
    create_time timestamp without time zone,
    update_time timestamp without time zone,
    CONSTRAINT mbg_company_pkey PRIMARY KEY (id)
)
WITH (
    OIDS = FALSE
)
TABLESPACE pg_default;

ALTER TABLE public.mbg_company
    OWNER to postgres;

COMMENT ON TABLE public.mbg_company
    IS '测试MyBatis Generator的表。公司。';

执行Mybatis Generator（generatorConfig.xml上 点击右键）：

执行后：什么都有了。

奇怪的是，Mapper.xml 怎么跑到 src/main/java 去了？不应该放到 src/main/resources 吗？

修改 sqlMapGenerator 的 targetProject 为 mybatis.use\src\main\resources，即可。

删除后，再重新建立，文件位置符合预期了。

其它问题：

实体类中，预期为 字符串的nameCn、nameEn、founder 的类型变成了 Object？什么情况？

原来，建表的时候，设置了长度为100，导致数据类型变为：character varying(200)[] —— 末尾还有一对 []！

更改后，再次使用 MBG，问题得到解决。

使用Mapper：

1、使用 @MapperScans+@MapperScan

2、建立 Mapper接口 和 Mapper.xml 文件的关联

# application.properties
mybatis.mapper-locations=classpath:/mapper/*.xml

3、添加失败

Caused by: org.postgresql.util.PSQLException: 错误: 在字段 "id" 中空值违反了非空约束
  详细：失败, 行包含(null, 阿里巴巴, null, null, 马云, null, null, null).

Mapper.xml 中，insert 没有自动生成主键！需更改
  
    
    insert into mbg_company (id, name_cn, name_en, 
      founding_time, founder, create_date, 
      create_time, update_time)
    values (#{id,jdbcType=INTEGER}, #{nameCn,jdbcType=VARCHAR}, #{nameEn,jdbcType=VARCHAR}, 
      #{foundingTime,jdbcType=TIMESTAMP}, #{founder,jdbcType=VARCHAR}, #{createDate,jdbcType=DATE}, 
      #{createTime,jdbcType=TIMESTAMP}, #{updateTime,jdbcType=TIMESTAMP})
  

这个 实现不符合预期。

@Component
public class TestRunner implements CommandLineRunner {

	@Autowired
	private CompanyMapper cm;
	
	@Override
	public void run(String... args) throws Exception {
		System.out.println("cm=" + cm);
		
		Company c = new Company();
		c.setNameCn("公司001");
		c.setFounder("老板001");

		// 失败
//		int ret = cm.insert(c);
		int ret = cm.insertSelective(c);
		System.out.println("ret=" + ret + ", c=" + c);
	}

}

把insert方法改为 insertSelective 时，数据添加成功了。

但是，返回结果没有主键id的值：

ret=1, c=Company(id=null, nameCn=公司001, nameEn=null, foundingTime=null, 
founder=老板001, createDate=null, createTime=null, updateTime=null)

更改标签后可以得到：

测试结果：id=3

ret=1, c=Company(id=3, nameCn=公司001, nameEn=null, foundingTime=null, founder=老板001, 
createDate=null, createTime=null, updateTime=null)

数据添加完毕，第一步搞定。

更多精彩，后续再补充。

》》》未完待续《《《

Mybatis自动生成实体代码的 generator 插件