@ApiOperationSupport
是来自 io.swagger.annotations
包的一个注解,主要用于在 Swagger 文档中对 API 接口进行细化的配置和控制。
其中的 order
属性用于指定该接口在生成的文档中的排序顺序。这是一个整数值,数值越小,该接口在文档中的显示位置越靠前。这个属性在当你有多个接口需要在文档中按照特定顺序排列时非常有用。
例如,如果你有两个API接口,分别使用了 @ApiOperationSupport(order = 2)
和 @ApiOperationSupport(order = 1)
,那么在生成的 Swagger 文档中,后者将会出现在前者的前面。
需要注意的是,这个注解通常与 @ApiOperation
配合使用,来提供API方法的描述、HTTP方法、路径等信息。并且,@ApiOperationSupport
通常用在包含 @ApiOperation
的接口或方法的父类或者接口上,以实现复用和统一管理API排序等信息的目的。