Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/goudai/gd-generator

A code generator that elegantly generates mybatis ORM (mapper and xml config) and intelligently retains user-defined mapper and xml, automatically creates/synchronizes database tables, and records and prints exactly after each domain model change Database repair sql, support for the production of a variety of complex VO (View Object) objects, all this can be carried out at any time during project development. Does not overwrite any of the personalized mappers and xml.
https://github.com/goudai/gd-generator

mybatis mybatis-generator mybatis-xml mysql

Last synced: about 1 month ago
JSON representation

A code generator that elegantly generates mybatis ORM (mapper and xml config) and intelligently retains user-defined mapper and xml, automatically creates/synchronizes database tables, and records and prints exactly after each domain model change Database repair sql, support for the production of a variety of complex VO (View Object) objects, all this can be carried out at any time during project development. Does not overwrite any of the personalized mappers and xml.

Awesome Lists containing this project

README 

        



### 简介



* 基于实体类为主导的代码生成器，可基于实体类快速的生成mybatis的相关配置。

如生成接口mapper,生成xml配置文件。

* 可通过实体类在生成自动建表，自动加索引,自动更新数据列。

* 可检测出数据库与实体类之间的差异并在日志中打印出对应警告或者修复用的sql语句。  

如 warn : 数据库中的列  [mysql_name --> mysqlName] 在实体类 Admin 不存在;

* 支持大部分JPA注解解析，可通过此代码生成器快速从hibernate转换到mybatis。

* 抽取查询对象 ,简化查询 ,自动生成QueryModel

* 自动驼峰装换

* 生成VO对象，提供四种注解，@View  @AssociationView @CollectionView @MapView

* 可在开发中运行（增量运行 可随时修改，增加，删除类属性后继续运行，此时将同步数据库表结构并给出响应修复sql，自动增量的保存开发书写的个性的mybatis中的xml语句）



### ChangeLog

v2.0.14 

* 移除guave依赖

* 升级相关依赖支持jdk11



v2.0.15  

* 修复在spring boot下使用stringProlie标签配置logback后，导致生成日志不能正确输出到console的问题



v2.0.16

* 添加对jpa，生成QueryModel, Repository 支持联合主键支持



       

### maven 依赖

```xml



    io.github.goudai

    gd-generator-api

    2.0.16



    io.github.goudai

    gd-generator-default

    2.0.16



```



### 注解对照表

#### @ViewObject

* 在实体类上使用,用于标示是否解析该类的VO



属性 | 类型 | 描述

-----|------|----

groups    | String[]    | 需要生成的VO的名称

views    | @Views[]    | 需要生成的基本属性

associationViews    | @AssociationView[]    | 需要生成的对象属性一般填VO的名称

collectionViews    | @CollectionView[]    | 需要生成的集合属性

mapViews    | @MapView[]    | 需要生成的Map属性



#### @View

* 在实体中的属性上使用,标示该属性将被解析为一个VO的属性

一个属性上可以使用多个View注,如果使用View全部默认属性,那么将取得原始字段的name和type



属性 | 类型 | 描述

-----|------|----

name    | String    | 需要生成的字段名成,如果不写将默认取属性名称,注意如果是在ViewObject上使用必须填写

groups    | String[]    | 填写VO的名称,如果不写默认取ViewObject中的属性

type    | Class    | 生成属性的type,一般为String

collectionViews    | @CollectionView[]    | 需要生成的集合属性



#### @AssociationView

* 在实体中的属性上使用,标示该属性将被解析为一个VO的属性

一个属性上可以使用多个AssociationView注



属性 | 类型 | 描述

-----|------|----

name    | String    | 需要生成的字段名成,如果不写将默认取属性名称,注意如果是在ViewObject上使用必须填写

groups    | String[]    | 填写VO的名称,如果不写默认取ViewObject中的属性

type    | Class    | 生成属性的类型,一般为复杂类型 如BigDecimal.class

associationGroup    | String    | 生成属性的类型,一般为VO的名称 注意 与type属性冲突



#### @CollectionView

* 在实体中的属性上使用,标示该属性将被解析为一个VO的属性

一个属性上可以使用多个CollectionView



属性 | 类型 | 描述

-----|------|----

name    | String    | 需要生成的字段名成,如果不写将默认取属性名称,注意如果是在ViewObject上使用必须填写

groups    | String[]    | 填写VO的名称,如果不写默认取ViewObject中的属性

type    | Class    | 需要生成的集合实现类,默认为ArrayList.class

elementType    | Class    | 生成的集合的泛型

elementGroup    | String   | 生成的集合的泛型 与elementType冲突



#### @MapView

* 在实体中的属性上使用,标示该属性将被解析为一个VO的属性

一个属性上可以使用多个MapView



属性 | 类型 | 描述

-----|------|----

name    | String    | 需要生成的字段名成,如果不写将默认取属性名称,注意如果是在ViewObject上使用必须填写

groups    | String[]    | 填写VO的名称,如果不写默认取ViewObject中的属性

type    | Class    | 需要生成的Map实现类,默认为HashMap.class

keyType    | Class    | 生成的Map的Key泛型

keyGroup    | String   | 生成的Map的Key泛型 与keyType冲突

valueType    | Class   | 生成的Map的Value泛型 

valueGroup    | String   | 生成的Map的Key泛型 与valueType冲突



### 快速使用



```java

	public static void main(String[] args) throws Exception {

		Config config = new Config();

		config.setGenLogFile(Paths.get(System.getProperty("user.home") , "yourProject.log").toString());

		config.setUrl("jdbc:mysql://mysqlIP/yourdb");

		config.setEntityPackage("com.xx.entity");

		config.setMybatisMapperPackage("com.xx.mapper");

		

		//D:\\Work\\Workspace\\xx-parent

		//Users/freeman/IdeaProjects/xxx-parent

		String projectPath = "your project base path";



        //xxx-service-impl\\src\\main\\java\\com\\xx\\mapper & windows

        //xxx-service-impl/src/main/java/com/xx/mapper & mac or linux

		config.setMybatisMapperPath(projectPath + "your mybatis mapper path");

		

		//\\xx-service-impl\\src\\main\\resources\\com\\xx\\mapping & windows

		//\\xx-service-impl/src/main/resources/com/xx/mapping & mac or linux

		config.setMybatisXmlPath(projectPath + "your mybatis mapping xml path");

		config.setUsername("your db user");

		config.setPassword("your db password");

        

        // is use lombok default : true

		config.setUseLombok(true);

         //com.xx.model.query

		config.setQueryModelPackage("your query model package name");

		//\\xx-service\\src\\main\\java\\com\\xx\\model\\query & windows

		//\\xx-service/src/main/java/com/xx/model/query & mac or linux

		config.setQueryModelPath(projectPath + "your query model package name");



		Generator.generate(config,

				new VoHandler("com.xx.vo", projectPath + "\\xx-component\\src\\main\\java\\com\\xx\\vo", true),

				new QueryModelHandler(),

				new MybatisMapperHandler(),

				new MybatisXmlHandler(),

				new MysqlHandler()

		);

	}

```



```java

/* JPA注解 需要解析的实体类必须加此注解*/

@Entity

@Table(name = "usr_user")

/*lombok提供注解*/

@Getter

@Setter

/*此注解表示是否生成查询对象*/

@QueryModel

/*此注解为预留注解 为以后生成页面以及生成excel*/

@Type(label = "用户")

@ViewObject(groups = {VO_LIST, VO_SIMPLE, VO_ADMIN, VO_ADMIN_SIMPLE, VO_ADMIN_FULL},

	collectionViews = {

		@CollectionView(name = "userUpgrades", elementGroup = UserUpgrade.VO_ADMIN, groups = VO_ADMIN_FULL),

		@CollectionView(name = "teammates", elementGroup = VO_ADMIN_SIMPLE, groups = VO_ADMIN_FULL)

	},

	associationViews = {

		@AssociationView(name = "portrait", associationGroup = Portrait.VO_ADMIN, groups = VO_ADMIN_FULL),

		@AssociationView(name = "appearance", associationGroup = Appearance.VO_ADMIN, groups = VO_ADMIN_FULL)

	}



)

public class User implements Serializable {

      /*此处定义的为需要生成的VO的类名称*/

	public static final String VO_LIST = "UserListVo";

	public static final String VO_SIMPLE = "UserSimpleVo";

	public static final String VO_ADMIN = "UserAdminVo";

	public static final String VO_ADMIN_SIMPLE = "UserAdminSimpleVo";

	public static final String VO_ADMIN_FULL = "UserAdminFullVo";



	@Id

	@Query(Predicate.IN)

	@Field(label = "id")

	@View

	private Long id;



	@Column(length = 11, unique = true)

	@NotBlank

	@Pattern(regexp = "^1[\\d]{10}$")

	@Query(Predicate.EQ)

	@Field(label = "手机号")

	@View(groups = {VO_LIST, VO_ADMIN, VO_ADMIN_SIMPLE, VO_ADMIN_FULL})

	private String phone;



	@Column(length = 60)

	@Field(label = "密码")

	private String password;



	@Column(length = 60)

	@NotBlank

	@Query(Predicate.LK)

	@Length(max = 60)

	@Field(label = "昵称")

	@View

	private String nickname;



	@NotNull

	@Query(Predicate.EQ)

	@Field(label = "用户类型")

	@View(groups = {VO_ADMIN, VO_ADMIN_SIMPLE, VO_ADMIN_FULL})

	private UserType userType;



	@NotNull

	@Query(Predicate.EQ)

	@Field(label = "用户等级")

	@View(groups = {VO_LIST, VO_ADMIN, VO_ADMIN_SIMPLE, VO_ADMIN_FULL})

	@View(name = "userRankLabel", type = String.class, groups = {VO_ADMIN, VO_ADMIN_SIMPLE, VO_ADMIN_FULL})

	private UserRank userRank;



	@Column(length = 11)

	@Pattern(regexp = "^[\\d]{5,11}$")

	@Field(label = "qq")

	@View(groups = {VO_ADMIN, VO_ADMIN_FULL})

	private String qq;



	@NotBlank

	@Field(label = "头像")

	@View(name = "avatarThumbnail", type = String.class)

	@Length(max = 250)

	private String avatar;



	@NotNull

	@Query(Predicate.EQ)

	@Field(label = "是否冻结")

	@View(groups = {VO_ADMIN, VO_ADMIN_FULL})

	private Boolean isFrozen;



	@NotNull

	@Temporal(TemporalType.TIMESTAMP)

	@Query({Predicate.GTE, Predicate.LT})

	@Field(label = "注册时间")

	@View(groups = {VO_ADMIN, VO_ADMIN_FULL})

	private Date registerTime;



	@NotNull

	@Field(label = "注册ip")

	@View(groups = {VO_ADMIN, VO_ADMIN_FULL})

	private String registerIp;



	@Query({Predicate.EQ, Predicate.IN})

	@Field(label = "邀请人id", description = "此用户不是最终上下级关系")

	@AssociationView(name = "inviter", associationGroup = VO_ADMIN_SIMPLE, groups = {VO_ADMIN, VO_ADMIN_FULL})

	private Long inviterId;



	@Query({Predicate.EQ, Predicate.IN})

	@Field(label = "上级id")

	@AssociationView(name = "parent", associationGroup = VO_ADMIN_SIMPLE, groups = {VO_ADMIN, VO_ADMIN_FULL})

	private Long parentId;



	@Field(label = "remark")

	@View(groups = {VO_ADMIN, VO_ADMIN_FULL})

	private String remark;



	@Temporal(TemporalType.DATE)

	@Field(label = "vipExpiredDate")

	private Date vipExpiredDate;



	@Column(length = 60, unique = true)

	@Field(label = "微信openId")

	private String openId;



	@Column(length = 60, unique = true)

	@Field(label = "微信unionId")

	private String unionId;



	@Field(label = "上次升级时间")

	private Date lastUpgradedTime;



}

```



### 生成的结果   



#### 实体类Mapper

```java

public interface UserMapper {



	int insert(User user);



	int update(User user);



	int merge(@Param("user") User user, @Param("fields")String... fields);



	int delete(Long id);



	User findOne(Long id);



	List findAll(UserQueryModel userQueryModel);



	long count(UserQueryModel userQueryModel);



	User findByPhone(String phone);



	User findByOpenId(String openId);



}

```        



       

#### Mybatis XML

```xml



	

		

		

		

		

		

		

		

		

		

		

		

		

		

		

		

		

		

		

	



	

	  insert into `usr_user` (phone,password,nickname,user_type,user_rank,qq,avatar,is_frozen,register_time,register_ip,inviter_id,parent_id,remark,vip_expired_date,open_id,union_id,last_upgraded_time)

	  values (#{phone},#{password},#{nickname},#{userType,typeHandler=org.apache.ibatis.type.EnumOrdinalTypeHandler},#{userRank,typeHandler=org.apache.ibatis.type.EnumOrdinalTypeHandler},#{qq},#{avatar},#{isFrozen},#{registerTime},#{registerIp},#{inviterId},#{parentId},#{remark},#{vipExpiredDate},#{openId},#{unionId},#{lastUpgradedTime})

	



	

		delete from `usr_user` where id = #{id}

	



	

		update `usr_user`

		

			phone = #{phone},

			password = #{password},

			nickname = #{nickname},

			user_type = #{userType,typeHandler=org.apache.ibatis.type.EnumOrdinalTypeHandler},

			user_rank = #{userRank,typeHandler=org.apache.ibatis.type.EnumOrdinalTypeHandler},

			qq = #{qq},

			avatar = #{avatar},

			is_frozen = #{isFrozen},

			register_time = #{registerTime},

			register_ip = #{registerIp},

			inviter_id = #{inviterId},

			parent_id = #{parentId},

			remark = #{remark},

			vip_expired_date = #{vipExpiredDate},

			open_id = #{openId},

			union_id = #{unionId},

			last_upgraded_time = #{lastUpgradedTime},

		

		where id = #{id}

	



	

		update `usr_user`

			

				

				

					phone = #{user.phone},

					password = #{user.password},

					nickname = #{user.nickname},

					user_type = #{user.userType,typeHandler=org.apache.ibatis.type.EnumOrdinalTypeHandler,javaType=com.zy.entity.usr.User$UserType},

					user_rank = #{user.userRank,typeHandler=org.apache.ibatis.type.EnumOrdinalTypeHandler,javaType=com.zy.entity.usr.User$UserRank},

					qq = #{user.qq},

					avatar = #{user.avatar},

					is_frozen = #{user.isFrozen},

					register_time = #{user.registerTime},

					register_ip = #{user.registerIp},

					inviter_id = #{user.inviterId},

					parent_id = #{user.parentId},

					remark = #{user.remark},

					vip_expired_date = #{user.vipExpiredDate},

					open_id = #{user.openId},

					union_id = #{user.unionId},

					last_upgraded_time = #{user.lastUpgradedTime},

				

				

			

		where id = #{user.id}

	



	

		select

		id,phone,password,nickname,user_type,user_rank,qq,avatar,is_frozen,register_time,register_ip,inviter_id,parent_id,remark,vip_expired_date,open_id,union_id,last_upgraded_time

		from `usr_user`

		where id = #{id}

	



	

		select

		id,phone,password,nickname,user_type,user_rank,qq,avatar,is_frozen,register_time,register_ip,inviter_id,parent_id,remark,vip_expired_date,open_id,union_id,last_upgraded_time

		from `usr_user`

		

			

				and user_rank = #{userRankEQ,typeHandler=org.apache.ibatis.type.EnumOrdinalTypeHandler}

			

			

				 and nickname like #{nicknameLK}

			

			

				and inviter_id = #{inviterIdEQ}

			

			

				

				and parent_id in

				

				#{item}

				

				

				

				1 = 2

				

			

			

				and is_frozen = #{isFrozenEQ}

			

			

				

				and id in

				

				#{item}

				

				

				

				 and 1 = 2

				

			

			

				and user_type = #{userTypeEQ,typeHandler=org.apache.ibatis.type.EnumOrdinalTypeHandler}

			

			

				and register_time >= #{registerTimeGTE}

			

			

				and register_time < #{registerTimeLT}

			

			

				and parent_id = #{parentIdEQ}

			

			

				and phone = #{phoneEQ}

			

			

				

				and inviter_id in

				

				#{item}

				

				

				

				1 = 2

				

			

		

		

			

				order by ${orderByAndDirection}

			

			

				order by id desc

			

		

		

			limit #{offset}, #{pageSize}

		

	



	

		select count(*) from `usr_user`

		

			

				and user_rank = #{userRankEQ,typeHandler=org.apache.ibatis.type.EnumOrdinalTypeHandler}

			

			

				 and nickname like #{nicknameLK}

			

			

				and inviter_id = #{inviterIdEQ}

			

			

				

				and parent_id in

				

				#{item}

				

				

				

				1 = 2

				

			

			

				and is_frozen = #{isFrozenEQ}

			

			

				

				and id in

				

				#{item}

				

				

				

				1 = 2

				

			

			

				and user_type = #{userTypeEQ,typeHandler=org.apache.ibatis.type.EnumOrdinalTypeHandler}

			

			

				and register_time >= #{registerTimeGTE}

			

			

				and register_time < #{registerTimeLT}

			

			

				and parent_id = #{parentIdEQ}

			

			

				and phone = #{phoneEQ}

			

			

				

				and inviter_id in

				

				#{item}

				

				

				

				1 = 2

				

			

		

	



	

		select * from `usr_user` where phone = #{phone}

	



	

		select * from `usr_user` where open_id = #{openId}

	



        

```	 

   

#### UserQueryModel   

```java

@Getter

@Setter

@Builder

@NoArgsConstructor

@AllArgsConstructor

public class UserQueryModel implements Serializable {



	private Long[] idIN;



	private String phoneEQ;



	private String nicknameLK;



	private UserType userTypeEQ;



	private UserRank userRankEQ;



	private Boolean isFrozenEQ;



	private Date registerTimeGTE;



	private Date registerTimeLT;



	private Long inviterIdEQ;



	private Long[] inviterIdIN;



	private Long parentIdEQ;



	private Long[] parentIdIN;



	private Integer pageNumber;



	private Integer pageSize;



	private String orderBy;



	private Direction direction;



	public void setOrderBy(String orderBy) {

		if (orderBy != null && !fieldNames.contains(orderBy)) {

			throw new IllegalArgumentException("order by is invalid");

		}

		this.orderBy = orderBy;

	}



	public Long getOffset() {

		if (pageNumber == null || pageSize == null) {

			return null;

		}

		return ((long) pageNumber) * pageSize;

	}



	public String getOrderByAndDirection() {

		if (orderBy == null) {

			return null;

		}

		String orderByStr = camelToUnderline(orderBy);

		String directionStr = direction == null ? "desc" : direction.toString().toLowerCase();

		return orderByStr + " " + directionStr;

	}



	private String camelToUnderline(String param) {

		if (param == null || "".equals(param.trim())) {

			return "";

		}

		int len = param.length();

		StringBuilder sb = new StringBuilder(len);

		for (int i = 0; i < len; i++) {

			char c = param.charAt(i);

			if (Character.isUpperCase(c)) {

				sb.append("_");

				sb.append(Character.toLowerCase(c));

			} else {

				sb.append(c);

			}

		}

		return sb.toString();

	}



	private static Set fieldNames = new HashSet<>();



	static {

		fieldNames.add("qq");

		fieldNames.add("registerIp");

		fieldNames.add("unionId");

		fieldNames.add("registerTime");

		fieldNames.add("openId");

		fieldNames.add("remark");

		fieldNames.add("lastUpgradedTime");

		fieldNames.add("userRank");

		fieldNames.add("avatar");

		fieldNames.add("parentId");

		fieldNames.add("password");

		fieldNames.add("phone");

		fieldNames.add("inviterId");

		fieldNames.add("nickname");

		fieldNames.add("vipExpiredDate");

		fieldNames.add("id");

		fieldNames.add("userType");

		fieldNames.add("isFrozen");

	}



}

```

### VO

#### UserListVo

```java

@Getter

@Setter

public class UserListVo implements Serializable {

	/* 原生 */

	@Field(label = "id")

	private Long id;

	@Field(label = "手机号")

	private String phone;

	@Field(label = "昵称")

	private String nickname;

	@Field(label = "用户等级")

	private UserRank userRank;



	/* 扩展 */

	@Field(label = "头像")

	private String avatarThumbnail;



}

```

#### UserSimpleVo

```java

@Getter

@Setter

public class UserSimpleVo implements Serializable {

	/* 原生 */

	@Field(label = "id")

	private Long id;

	@Field(label = "昵称")

	private String nickname;



	/* 扩展 */

	@Field(label = "头像")

	private String avatarThumbnail;



}

```

#### UserAdminVo

```java

@Getter

@Setter

public class UserAdminVo implements Serializable {

	/* 原生 */

	@Field(label = "id")

	private Long id;

	@Field(label = "手机号")

	private String phone;

	@Field(label = "昵称")

	private String nickname;

	@Field(label = "用户类型")

	private UserType userType;

	@Field(label = "用户等级")

	private UserRank userRank;

	@Field(label = "qq")

	private String qq;

	@Field(label = "是否冻结")

	private Boolean isFrozen;

	@Field(label = "注册时间")

	private Date registerTime;

	@Field(label = "注册ip")

	private String registerIp;

	@Field(label = "remark")

	private String remark;



	/* 扩展 */

	@Field(label = "用户等级")

	private String userRankLabel;

	@Field(label = "头像")

	private String avatarThumbnail;

	@Field(label = "邀请人id")

	private UserAdminSimpleVo inviter;

	@Field(label = "上级id")

	private UserAdminSimpleVo parent;



}

```

####UserAdminSimpleVo

```java

@Getter

@Setter

public class UserAdminSimpleVo implements Serializable {

	/* 原生 */

	@Field(label = "id")

	private Long id;

	@Field(label = "手机号")

	private String phone;

	@Field(label = "昵称")

	private String nickname;

	@Field(label = "用户类型")

	private UserType userType;

	@Field(label = "用户等级")

	private UserRank userRank;



	/* 扩展 */

	@Field(label = "用户等级")

	private String userRankLabel;

	@Field(label = "头像")

	private String avatarThumbnail;



}

```

#### UserAdminFullVo

```java

@Getter

@Setter

public class UserAdminFullVo implements Serializable {

	/* 原生 */

	@Field(label = "id")

	private Long id;

	@Field(label = "手机号")

	private String phone;

	@Field(label = "昵称")

	private String nickname;

	@Field(label = "用户类型")

	private UserType userType;

	@Field(label = "用户等级")

	private UserRank userRank;

	@Field(label = "qq")

	private String qq;

	@Field(label = "是否冻结")

	private Boolean isFrozen;

	@Field(label = "注册时间")

	private Date registerTime;

	@Field(label = "注册ip")

	private String registerIp;

	@Field(label = "remark")

	private String remark;



	/* 扩展 */

	@Field(label = "portrait")

	private PortraitAdminVo portrait;

	@Field(label = "appearance")

	private AppearanceAdminVo appearance;

	@Field(label = "用户等级")

	private String userRankLabel;

	@Field(label = "头像")

	private String avatarThumbnail;

	@Field(label = "邀请人id")

	private UserAdminSimpleVo inviter;

	@Field(label = "上级id")

	private UserAdminSimpleVo parent;

	@Field(label = "userUpgrades")

	private List userUpgrades = new ArrayList<>();

	@Field(label = "teammates")

	private List teammates = new ArrayList<>();



}

```



### Spring Data Jpa



#### Entity



```java

@QueryModel

@Where(clause = "is_delete = 'false'")

@Entity

@Data

@Builder

@NoArgsConstructor

@AllArgsConstructor

@Table(name = "usr_users", uniqueConstraints = {

        @UniqueConstraint(name = "UK_CHANNEL_OPENID", columnNames = {"channel", "openId"})

})

public class User implements Serializable {

    private static final long serialVersionUID = 3709248849005085055L;



    @Field(label = "ID")

    @Id

    @Column(columnDefinition = "bigint(20)")

    private String id;



    /**

     * 渠道

     */

    @Query({Predicate.EQ, Predicate.IN})

    @Field(label = "渠道")

    @NotBlank

    private String channel;



    /**

     * 昵称 (第三方登录使用首渠道昵称)

     */

    @Query({Predicate.EQ, Predicate.LK})

    @Field(label = "昵称")

    @NotBlank

    private String nickName;



    /**

     * 微信openId

     */

    @Query({Predicate.EQ})

    @Field(label = "OpenID")

    private String openId;



    /**

     * 微信unionId

     */

    @Query({Predicate.EQ})

    @Field(label = "微信UnionId")

    private String unionId;



    /**

     * 性别 0: 男 1: 女

     */

    @Query({Predicate.EQ})

    @Field(label = "性别", description = "0: 男 1: 女")

    private Integer gender;



    /**

     * 手机号

     */

    @Query({Predicate.EQ})

    @Field(label = "手机号")

    private String phone;



    /**

     * 密码 (默认为空，无法登陆，需设置密码方能使用密码登录)

     */

    @Field(label = "密码")

    private String password;



    /**

     * 头像

     */

    @Field(label = "头像")

    private String avatar;



    /**

     * 是否删除 False(默认): 否 True: 是

     */

    @Query({Predicate.EQ, Predicate.NEQ})

    @Field(label = "删除标记", description = "False(默认): 否 True: 是")

    private Boolean isDelete = Boolean.FALSE;



    /**

     * 注册时间

     */

    @Query({Predicate.GTE, Predicate.LT})

    @Field(label = "注册时间")

    @Temporal(TemporalType.TIMESTAMP)

    private Date registerTime;



    /**

     * 更新时间

     */

    @Field(label = "最后一次更新时间")

    @Temporal(TemporalType.TIMESTAMP)

    private Date updateTime;



    /**

     * 最后活跃时间

     */

    @Query({Predicate.GTE, Predicate.LT})

    @Field(label = "最后一次访问时间")

    @Temporal(TemporalType.TIMESTAMP)

    private Date lastActiveTime;



    /**

     * 生日

     */

    @Field(label = "生日")

    private Date birthDay;



    /**

     * 是否禁用 0(默认): 正常 1: 禁用

     */

    @Query({Predicate.EQ, Predicate.NEQ})

    @Field(label = "状态标记", description = "0(默认): 正常 1: 禁用")

    private Integer state = 0;



    /**

     * 乐观锁

     */

    @Version

    private Integer version = 0;

}

```



#### Generator



```java

public class GdGenerator {



    public static void main(String[] args) throws Exception {

        String projectPath = System.getProperties().get("user.dir") + "";

        Config config = new Config();

        config.setEntityPackage("com.example.users.entity");

        config.setUseLombok(true);

        config.setQueryModelPackage("com.example.users.model.dto");

        config.setQueryModelPath(projectPath + "/src/main/java/com/example/users/model/dto");



        Generator.generate(config,

                new JpaQueryModelHandler(),

                new JpaRepositoryHandler("com.example.users.repository", projectPath + "/src/main/java/com/example" +

                                                                 "/users/repository", false)

                      );

    }

}

```



#### 生成结果



##### QueryModel



```java

package com.example.users.model.dto;



import com.example.users.entity.User;

import org.springframework.data.jpa.domain.Specification;



import javax.persistence.criteria.CriteriaBuilder;

import javax.persistence.criteria.CriteriaQuery;

import javax.persistence.criteria.Predicate;

import javax.persistence.criteria.Root;

import java.util.Objects;



import lombok.Getter;

import lombok.Setter;

import lombok.Builder;

import lombok.NoArgsConstructor;

import lombok.AllArgsConstructor;

import java.util.Date;



@Getter

@Setter

@Builder

@NoArgsConstructor

@AllArgsConstructor

public class UserQueryModel implements Specification {



    private String channelEQ;



    private String[] channelIN;



    private String nickNameEQ;



    private String nickNameLK;



    private String openIdEQ;



    private String unionIdEQ;



    private Integer genderEQ;



    private String phoneEQ;



    private Boolean isDeleteEQ;



    private Boolean isDeleteNEQ;



    private Date registerTimeGTE;



    private Date registerTimeLT;



    private Date lastActiveTimeGTE;



    private Date lastActiveTimeLT;



    private Integer stateEQ;



    private Integer stateNEQ;



    @Override

    public Predicate toPredicate(Root root, CriteriaQuery> query, CriteriaBuilder criteriaBuilder) {



        Predicate defaultPredicate = criteriaBuilder.and();

        if (Objects.nonNull(getChannelEQ())) {

            Predicate p = criteriaBuilder.equal(root.get("channel"), getChannelEQ());

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getChannelIN())

                && getChannelIN().length > 0) {

            Predicate p = criteriaBuilder.and(root.get("channel").in(java.util.Arrays.asList(getChannelIN())));

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getNickNameEQ())) {

            Predicate p = criteriaBuilder.equal(root.get("nickName"), getNickNameEQ());

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getNickNameLK())) {

            Predicate p = criteriaBuilder.like(root.get("nickName"), "%" + getNickNameLK() + "%");

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getOpenIdEQ())) {

            Predicate p = criteriaBuilder.equal(root.get("openId"), getOpenIdEQ());

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getUnionIdEQ())) {

            Predicate p = criteriaBuilder.equal(root.get("unionId"), getUnionIdEQ());

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getGenderEQ())) {

            Predicate p = criteriaBuilder.equal(root.get("gender"), getGenderEQ());

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getPhoneEQ())) {

            Predicate p = criteriaBuilder.equal(root.get("phone"), getPhoneEQ());

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getIsDeleteEQ())) {

            Predicate p = criteriaBuilder.equal(root.get("isDelete"), getIsDeleteEQ());

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getIsDeleteNEQ())) {

            Predicate p = criteriaBuilder.notEqual(root.get("isDelete"), getIsDeleteNEQ());

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getRegisterTimeGTE())) {

            Predicate p = criteriaBuilder.greaterThanOrEqualTo(root.get("registerTime"), getRegisterTimeGTE());

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getRegisterTimeLT())) {

            Predicate p = criteriaBuilder.lessThan(root.get("registerTime"), getRegisterTimeLT());

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getLastActiveTimeGTE())) {

            Predicate p = criteriaBuilder.greaterThanOrEqualTo(root.get("lastActiveTime"), getLastActiveTimeGTE());

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getLastActiveTimeLT())) {

            Predicate p = criteriaBuilder.lessThan(root.get("lastActiveTime"), getLastActiveTimeLT());

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getStateEQ())) {

            Predicate p = criteriaBuilder.equal(root.get("state"), getStateEQ());

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        if (Objects.nonNull(getStateNEQ())) {

            Predicate p = criteriaBuilder.notEqual(root.get("state"), getStateNEQ());

            defaultPredicate = criteriaBuilder.and(defaultPredicate, p);

        }

        return defaultPredicate;

    }

}

```



##### Repository



```java

package com.example.users.repository;



import com.example.users.entity.User;

import org.springframework.data.jpa.repository.JpaRepository;

import org.springframework.data.jpa.repository.JpaSpecificationExecutor;



import java.util.Optional;



public interface UserRepository extends JpaRepository, JpaSpecificationExecutor {



}



```



#### mysql



```java

@Entity

@Table(name = "demo",schema="测试表")

public class Demo {

    @Id

    private Long id;



    @Default("0")

    @Field(label = "数量")

    private Integer number;

    @NotEmpty

    @Field(label = "标题",columnDefinition = "char(20)")

    private String title;

}



```

##### @Table

生成表信息



属性 | 类型 | 描述

-----|------|----

name    | String    | 表名

schema    | String    | 表注释



##### @Column

生成字段信息



属性 | 类型 | 描述

-----|------|----

label    | String    | 字段注释



以下注解需使用AllMappingMysqlHandler且mappingAll为True才会生效



>##### @Column

>生成字段信息

>

>属性 | 类型 | 描述

>-----|------|----

>nullable    | boolean    |    用于控制NOT NULL

>columnDefinition    | String    | 数据库字段类型，不设置自动根据java类型转换

>

>

>##### @Default

>生成表字段时，设置默认值

>

>属性 | 类型 | 描述

>-----|------|----

>value    | String    | 要设置的默认值

>type    | DefaultType    | 值类型，VALUE为设置的值，DBKEY为数据库关键字，用于设置当前日期之类的特殊默认值

>

>

>##### @javax.validation.constraints.NotBlank

>##### @javax.validation.constraints.NotEmpty

>##### @javax.validation.constraints.NotNull

>设置表字段为NOT NULL