@ApiModel与@invoke

ApiModel注解应用

使用场景：该注解应用于实体类，用于标识被Swagger解析的类

1.什么是Swagger
OpenAPI规范（OpenAPI Specification，简称OAS）是由Linux基金会发起的一个项目，旨在通过制定一种描述API格式或定义语言的标准，以规范RESTful服务的开发流程。当前版本为V3.0，并已在GitHub平台上完成开源与发布。

Swagger是一款遵循OpenAPI规范的接口开发工具，其功能覆盖了从设计、文档编写到测试及部署的整个API生命周期的开发过程。

概述

补充与swagger模型相关的附加信息，当类在操作中被用作类型时，系统将自动进行内省处理。

属性名称

数据类型

默认值

说明

value

String

类名

为模型定义一个替代名称

description

String

" "

提供详细说明内容

parent

void.class

用于为模型指定父类，从而支持继承关系的描述

discriminatory

String

" "

用于支持模型的继承与多态特性，该字段名称可用于确定应使用哪个子类型

subTypes

{}

表示从该模型继承的子类型数组