swagger2注解(swagger 实体类注解)

swagger2注解(swagger 实体类注解)Swagger 2 是一个用于生成 RESTful API 文档的框架 它可以根据代码自动生成 API 文档 方便开发者进行 API 测试和调用 下面是 Swagger 2 注解 的介绍和演示 1 Api 用于类上 表示该类是 Swagger 2 的资源 2 ApiOperation 用于方法上 表示一个 HTTP 请求的操作 3 ApiParam 用于参数上 用来描述参数 4 ApiModel

大家好,我是讯享网,很高兴认识大家。

Swagger2是一个用于生成RESTful API文档的框架,它可以根据代码自动生成API文档,方便开发者进行API测试和调用。下面是Swagger2注解的介绍和演示:

1.@Api:用于类上,表示该类是Swagger2的资源。

2.@ApiOperation:用于方法上,表示一个HTTP请求的操作。

3.@ApiParam:用于参数上,用来描述参数。


讯享网

4.@ApiModel:用于类上,表示对类进行说明,用于参数用实体类接收的情况。

5.@ApiModelProperty:用于属性上,描述响应类的属性。

6.@ApiIgnore:用于类或者方法上,表示该类或方法不会被Swagger2处理。

下面是一个使用Swagger2注解的示例:

@RestController @Api(tags = "用户管理") @RequestMapping("/user") public class UserController { @Autowired private UserService userService; @ApiOperation(value = "获取用户列表", notes = "获取所有用户列表") @GetMapping("/list") public List<User> list() { return userService.list(); } @ApiOperation(value = "添加用户", notes = "添加一个新用户") @PostMapping("/add") public String add(@ApiParam(name = "user", value = "用户信息", required = true) @RequestBody User user) { userService.add(user); return "success"; } @ApiOperation(value = "更新用户", notes = "根据用户ID更新用户信息") @PutMapping("/update/{id}") public String update(@ApiParam(name = "id", value = "用户ID", required = true) @PathVariable Long id, @ApiParam(name = "user", value = "用户信息", required = true) @RequestBody User user) { userService.update(id, user); return "success"; } @ApiOperation(value = "删除用户", notes = "根据用户ID删除用户") @DeleteMapping("/delete/{id}") public String delete(@ApiParam(name = "id", value = "用户ID", required = true) @PathVariable Long id) { userService.delete(id); return "success"; } } 

讯享网
小讯
上一篇 2025-05-21 21:39
下一篇 2025-06-05 17:52

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/149157.html