Jhipster开发平台笔记

简介

安装基础环境

初始化项目

JDL文件设计

entity SysCom(SYS_COM) {
	  /** 主键 */
	  id Long
    /** 头像 */
    avatar String
    /** 姓名 */
    name String required
}

// 设置无限滚动
// paginate xxx with infinite-scroll

// 所有实体类全都生成分页
paginate * with pagination

// 所有controller全部直接调用Service类
service * with serviceClass

生成实体类代码/按个人喜好修改配置

jackson:
    locale: zh
    time-zone: GMT+8
    date-format: yyyy-MM-dd HH:mm:ss
    deserialization:
      # json字符串中有不存在的属性时失败
      fail_on_unknown_properties: false
    parser:
      # 允许出现特殊字符和转义符
      allow_unquoted_control_chars: true
      # 允许出现单引号
      allow_single_quotes: true

hibernate.jdbc.time_zone: GMT+8

附录1: JDL相关说明

[<entity javadoc>]
[<entity annotation>*]
entity <entity name> [(<table name>)] {
  [<field javadoc>]
  [<field annotation>*]
  <field name> <field type> [<validation>*]
}

必选项:
<entity name> 实体名称，
<field name> 实体属性名称，
<field type> JHipster支持的属性类型，
可选项:
<entity javadoc> 实体描述，
<entity annotation> 实体的选项（有关可用选项的完整列表，请参见选项），
<table name> 数据库表名称（如果要指定与实体名称自动转换不同的名称），
<field javadoc> 属性描述，
<field annotation> 属性的选项，
<validation> 属性的校验规则。

简单栗子:

/**
 * 这是关于实体类的注释
 * @author 作者名称
 */
@dto(mapstruct) // 使用mapstruct生成dto
@search(elastisearch) // 使用es进行搜索
@service(serviceClass) // 直接生成service类 不使用service接口
entity SysUser(SYS_USER) { // entity是用来声明实体的关键字 SysUser是实体类的名称 SYS_USER是表名称
	/**
   * This comment will also be used!
   * @type...
   */
   id UUID required // id字段每个实体类都会默认添加, 默认为Long类型, 如果想改变id的类型, 必须要显式声明一下

	 age Integer min(32) max(32)
}

relationship (OneToMany | ManyToOne | OneToOne | ManyToMany) {
  <from entity>[{<relationship name>[(<display field>)]}] to <to entity>[{<relationship name>[(<display field>)]}]+
}

选项:
(OneToMany | ManyToOne| OneToOne | ManyToMany) 是你的关系类型
<from entity> 是关系的实体所有者的名称：源实体，
<to entity> 是关系要到达的实体的名称：目的实体，
<relationship name> 是具有另一端类型的属性名称，
<display field> 是应显示在选择框中的字段名称（默认值：id），
required 引入的关系属性是否不能为空。
with jpaDerivedIdentifier 或 @MapsId 用于关联关系 (仅适用于一对一（one-to-one）

简单栗子:

relationship ManyToMany {
	SysJob{sysTask(name) required} to SysTask{sysJob(title)}
}

上面关系的意思为, 一个SysJob实体对应着多个SysTask实体,
required 表示每个SysJob必须最少有一个SysTask,
在SysJob实体类中SysTask集合的字段名为sysTask(会自动处理复数名称),
在前端选项列表里展示的SysTask的字段名称为name,

同时另一端SysTask也对应着多个SysJob实体,
在SysTask实体类中的SysJob集合的字段名为sysTask(会自动处理复数名称),
在前端选项列表里展示的SysJob的字段名称为title,

附录2: 关于关联关系生成的代码

@ManyToOne
@JsonIgnoreProperties(value = { "sysStudents" }, allowSetters = true)
private SysClass sysClass;

@OneToMany(mappedBy = "sysClass")
@Cache(usage = CacheConcurrencyStrategy.READ_WRITE)
@JsonIgnoreProperties(value = { "sysClass" }, allowSetters = true)
private Set<SysStudent> sysStudents = new HashSet<>();