Swagger
文章平均质量分 82
介绍Swagger相关的内容
Stephen·You
这个作者很懒,什么都没留下…
展开
-
Springboot自定义全局异常处理器-封装接口异常的响应体,防止异常时暴露程序包名类名路径信息(附swagger文档的使用教程与资源拦截问题)
aaa问题现象:今天在项目中,遇到了一个需求: 如何解决接口调用报错时,暴露了接口涉及的包名、类名等敏感信息的问题?问题分析: 其实在很多正常的小项目,对这种情况是不做处理的,因为即使暴露了 起因是因为甲方在使用安全测试工具检测接口的时候,发现接口返回的报文中存在敏感信息,会暴露接口逻辑中用到的包名、类名,举个例子如:如上图,接口:/pms-amap-sgcc-serv...原创 2022-05-23 17:56:33 · 1463 阅读 · 0 评论 -
swagger学习日记4 文档无法识别下划线属性名
问题分析:今天在使用swagger注解接口,编写文档的时候,发现了一个大问题:如何在让swagger文档识别带下划线(_)的属性名?如:{ "account_name": "nspd1", "password": "zg=="}问题现象:查看了网上资料发现,并没有该问题的解决方法,有的都是在说如何解决Map数据类型的子属性注解问题。于是我就开始自己尝试:1.当我使用网上大神么的创建新注解的方法时注解Map数据类型的对象时,确实可以解决这个问题:当也有很大局限性,固定的Ma原创 2021-02-26 18:54:38 · 1015 阅读 · 0 评论 -
swagger学习笔记3 java.lang.NumberFormatException: For input string: ““
问题现象:今天在学习swagger的过程中,启动swaggerUI页面后,后台报错:java.lang.NumberFormatException: For input string: ""问题分析:这个报错的意思是整型数据类型格式异常: 传入了空字符串给整型数据类型,导致该错误.通过查阅网上资料可知:这是因为springfox-swagger2(2.9.2)依赖于swagger-models(1.5.0) ;而该版本的swagger会将实体类中非String类型的属性...原创 2020-10-29 15:31:25 · 1363 阅读 · 0 评论 -
swagger学习笔记2 No operations defined in spec!
问题现象:今天在学习swagger的过程中,发现了一个问题:接口信息无法显示:No operations defined in spec!问题分析:这个信息的意思就是: 规范中没有定义操作(也就是:配置中没有定义接口api)!出现这个问题的原因有很多:1.swagger配置类中配置controller的包路径出错(可能性最大)通过查看配置类的包路径,发现并没有问题:2.controller层的swagger注解配置有误发现controller层配置也没有问题:原创 2020-10-29 11:04:47 · 9877 阅读 · 7 评论 -
swagger学习日记1 swagger测试接口时传入参数的类型问题
问题现象:今天在学习swagger做接口api说明的时候,出现了一个一直解决不了的问题,而且网上搜了很久,都找不到任何相似的问题和解决方法:当用swagger测试一个需要传入(Integer数据类型)参数的接口时,一直是显示红框状态,不能被execute(执行),没有任何错误提示!问题分析:于是我就通过以下几个方面去查看问题所在:1.swagger依赖:(没问题) <!--swaggerUI--> <dependency>原创 2020-10-29 10:23:28 · 23430 阅读 · 6 评论