add 整合 springdoc-openapi-javadoc 基于代码注释生成文档

疯狂的狮子li

2022-07-07 d9e54388e7fde2462e8b7e0165c5e7da3f202593

 ruoyi-common/src/main/java/com/ruoyi/common/core/domain/entity/SysDept.java

@@ -1,127 +1,80 @@
package com.ruoyi.common.core.domain.entity;

import com.baomidou.mybatisplus.annotation.*;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableLogic;
import com.baomidou.mybatisplus.annotation.TableName;
import com.ruoyi.common.core.domain.TreeEntity;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.experimental.Accessors;
import lombok.EqualsAndHashCode;

import javax.validation.constraints.Email;
import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;
import java.io.Serializable;
import java.util.*;

/**
 * 部门表 sys_dept
 *
 * @author ruoyi
 * @author Lion Li
 */

@Data
@NoArgsConstructor
@Accessors(chain = true)
@EqualsAndHashCode(callSuper = true)
@TableName("sys_dept")
public class SysDept implements Serializable {
   private static final long serialVersionUID = 1L;
public class SysDept extends TreeEntity<SysDept> {
    private static final long serialVersionUID = 1L;

   /**
    * 部门ID
    */
   @TableId(value = "dept_id", type = IdType.AUTO)
   private Long deptId;
    /**
     * 部门ID
     */
    @TableId(value = "dept_id")
    private Long deptId;

   /**
    * 父部门ID
    */
   private Long parentId;
    /**
     * 部门名称
     */
    @NotBlank(message = "部门名称不能为空")
    @Size(min = 0, max = 30, message = "部门名称长度不能超过30个字符")
    private String deptName;

   /**
    * 祖级列表
    */
   private String ancestors;
    /**
     * 显示顺序
     */
    @NotNull(message = "显示顺序不能为空")
    private Integer orderNum;

   /**
    * 部门名称
    */
   @NotBlank(message = "部门名称不能为空")
   @Size(min = 0, max = 30, message = "部门名称长度不能超过30个字符")
   private String deptName;
    /**
     * 负责人
     */
    private String leader;

   /**
    * 显示顺序
    */
   @NotBlank(message = "显示顺序不能为空")
   private String orderNum;
    /**
     * 联系电话
     */
    @Size(min = 0, max = 11, message = "联系电话长度不能超过11个字符")
    private String phone;

   /**
    * 负责人
    */
   private String leader;
    /**
     * 邮箱
     */
    @Email(message = "邮箱格式不正确")
    @Size(min = 0, max = 50, message = "邮箱长度不能超过50个字符")
    private String email;

   /**
    * 联系电话
    */
   @Size(min = 0, max = 11, message = "联系电话长度不能超过11个字符")
   private String phone;
    /**
     * 部门状态:0正常,1停用
     */
    private String status;

   /**
    * 邮箱
    */
   @Email(message = "邮箱格式不正确")
   @Size(min = 0, max = 50, message = "邮箱长度不能超过50个字符")
   private String email;
    /**
     * 删除标志（0代表存在 2代表删除）
     */
    @TableLogic
    private String delFlag;

   /**
    * 部门状态:0正常,1停用
    */
   private String status;

   /**
    * 删除标志（0代表存在 2代表删除）
    */
   @TableLogic
   private String delFlag;

   /**
    * 父部门名称
    */
   @TableField(exist = false)
   private String parentName;

   /**
    * 创建者
    */
   @TableField(fill = FieldFill.INSERT)
   private String createBy;

   /**
    * 创建时间
    */
   @TableField(fill = FieldFill.INSERT)
   private Date createTime;

   /**
    * 更新者
    */
   @TableField(fill = FieldFill.INSERT_UPDATE)
   private String updateBy;

   /**
    * 更新时间
    */
   @TableField(fill = FieldFill.INSERT_UPDATE)
   private Date updateTime;

   /**
    * 子部门
    */
   @TableField(exist = false)
   private List<SysDept> children = new ArrayList<SysDept>();

   /**
    * 请求参数
    */
   @TableField(exist = false)
   private Map<String, Object> params = new HashMap<>();
    /**
     * 祖级列表
     */
    private String ancestors;

}