Swagger与RestFul 集成 以及 注解使用Demo

时间：2025-03-18 19:24:10

//2 GET (多条件查询分页）--- URL:/apps 

@ApiOperation(value = "应用查询", notes = "")
@ApiImplicitParams(value = {
    @ApiImplicitParam(paramType = "query", name = "appType", dataType = "String", required = true, value = "应用类型", defaultValue = "10"),
    @ApiImplicitParam(paramType = "query", name = "appClassId", dataType = "String", required = true, value = "应用分类id"),
    @ApiImplicitParam(paramType = "query", name = "appId", dataType = "String", required = true, value = "appId"),
    @ApiImplicitParam(paramType = "query", name = "appName", dataType = "String", value = "应用名称"),
    @ApiImplicitParam(paramType = "query", name = "appStatus", dataType = "String", required = true, value = "状态 0：已下架 1：正常"),
    @ApiImplicitParam(paramType = "query",name = "page", value = "当前页码", required = true, dataType = "integer"),
    @ApiImplicitParam(paramType = "query",name = "rows", value = "每页条数", required = true, dataType = "integer")
})
@RequestMapping(method = )
public App list(@RequestParam("appType") String appType,
                @RequestParam("appClassId") String appClassId,
                @RequestParam("appId") String appId,@RequestParam("appName") String appName,
                @RequestParam("appStatus") String appStatus,
                @RequestParam(name = "page", defaultValue = "1") int page,
                @RequestParam(name = "rows", defaultValue = "10") int rows) {
    //todo
return 按规范自己封装; 
}

//3 get ---url/{appid}

@ApiOperation(value = "获取产品详情", notes = "产品详情") 
@ApiImplicitParam(paramType = "path", name = "appId", value = "产品appId", 
                  required = true, dataType = "String") 
@RequestMapping(value = "/{appId}", method = ) 
private App getAppDetail(@PathVariable("appId") String appId) { 
    //todo
    return 按规范自己封装;
}

//4 PUT --URL/{appId} and RequestBody 
@ApiOperation(value="update", notes="") 
@ApiImplicitParams(
    value={ 
        @ApiImplicitParam(paramType="path",name="appId",value="",
                          required=true,dataType = "String"), 
        @ApiImplicitParam(name="app",value ="App",
                          required=true,dataType ="App") 
}) 
@RequestMapping(value="/{appId}",method =, 
                consumes = MediaTypes.JSON_UTF_8) 
public App Appupdate(@PathVariable(value = "appId") String appId,
                     @RequestBody App app) {
    //todo
    return 按规范自己封装;
}

//Post Many app objects
@ApiOperation(value="创建多条APPs", notes="")
@RequestMapping(value="/postApps", method=)
public String postApps(@ApiParam(name="apps",value="用户s",required = true) 
                       @RequestBody List<App> apps) {
    (apps);
    return "success";
}
4 常见swagger注解一览与使用
 
最常用的5个注解
@Api ：修饰整个类，描述Controller的作用
@ApiOperation ：描述一个类的一个方法，或者说一个接口
@ApiParam ：单个参数描述

@ApiModel ：用对象来接收参数
@ApiProperty ：用对象接收参数时，描述对象的一个字段
其它若干 @ApiResponse ：HTTP响应其中 1 个描述
@ApiResponses ：HTTP响应整体描述
@ApiIgnore ：使用该注解忽略这个API
@ApiClass
@ApiError @ApiErrors
@ApiParamImplicit @ApiParamsImplicit 
/**
@ApiParam:  
* Adds additional meta-data for operation parameters. 
* <p/> 
* This annotation can be used only in combination of JAX-RS / annotations. 
*/


/**
@ApiParamImplicit:  
* Represents a single parameter in an API Operation. <p/> 
* While {@link ApiParam} is bound to a JAX-RS parameter, 
* method or field, this allows you to manually define a parameter in a fine-tuned manner. 
* This is the only way to define parameters when using Servlets or other non-JAX-RS 
* environments. 
* <p/> 
* This annotation must be used as a value of {@link ApiImplicitParams} 
* in order to be parsed. 
* * @see ApiImplicitParams 
*/
 
   
 
   

     5 Swagger 使用参考网址 
   
 
   
 
    Swagger 
    注解说明： 
    Annotations · swagger-api/swagger-core Wiki · GitHub 
   
 
   
 
    Swagger RESTful API Documentation Specification： 
   
 
   
 
    OpenAPI-Specification/1. at main · OAI/OpenAPI-Specification · GitHub 
   
 
   
 
    Swagger 
    注解使用  
    微服务之Swagger - 沧海一滴 - 博客园 
    有什么问题请指正。。。。。 
   
相关文章