给swagger的接口添加描述

最新推荐文章于 2024-08-19 00:15:00 发布

qisoft1213

最新推荐文章于 2024-08-19 00:15:00 发布

阅读量5.7k

点赞数 3

分类专栏： swagger java开发文章标签： swagger 接口描述前后端分离

本文链接：https://blog.csdn.net/qisoft1213/article/details/104004068

版权

swgger非常便于前后端分离开发，通过给swagger添加描述就可以实现前后端共同的开发接口，以下介绍如何给swagger的接口添加描述。

一.创建实体，并在实体和属性上使用@ApiModel()、@ApiModelProperty()注解。

注解的具体文档请参考https://blog.csdn.net/dejunyang/article/details/89527348

1.1 工作者实体

//工作者实体
import com.alibaba.fastjson.annotation.JSONField;
import com.baomidou.mybatisplus.annotations.TableField;
import com.baomidou.mybatisplus.annotations.TableId;
import com.baomidou.mybatisplus.annotations.TableName;
import com.baomidou.mybatisplus.enums.IdType;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import javax.validation.constraints.NotEmpty;
import java.util.Date;
import java.util.List;

@Data
@TableName("XXW_WORKER_T")
@ApiModel("工作者实体")
public class XxwWorkerT extends FieldFillBean {
    /**
     * 主键
     */
    @TableId(value = "XXW_WORKER_ID", type = IdType.UUID)
    @ApiModelProperty("主键id")
    private String xxwWorkerId;
    /**
     * 姓名
     */
    @TableField("NAME")
    @NotEmpty(
            message = "姓名不能为空"
    )
    @ApiModelProperty(&