在 Java 中的基本理念是 结构不佳的代码不能运行,发现错误的理想时期是在编译期间,因为你不用运行程序,只是凭借着对 Java 基本理念的理解就能发现问题。但是编译期并不能找出所有的问题,有一些 NullPointerException 和 ClassNotFoundException 在编译期找不到,这些异常是 RuntimeException 运行时异常,这些异常往往在运行时才能被发现。
2025年04月15日
在 Java 中的基本理念是 结构不佳的代码不能运行,发现错误的理想时期是在编译期间,因为你不用运行程序,只是凭借着对 Java 基本理念的理解就能发现问题。但是编译期并不能找出所有的问题,有一些 NullPointerException 和 ClassNotFoundException 在编译期找不到,这些异常是 RuntimeException 运行时异常,这些异常往往在运行时才能被发现。
2025年04月11日
作为拥有十年经验的软件项目经理,我深知接口文档编写的痛点:开发团队抱怨格式混乱,测试人员吐槽更新滞后,产品经理追问“参数说明在哪?”……今天给大家推荐一款能终结这些烦恼的开源神器——
2025年04月11日
在使用 postman 做接口测试过程中,测试工程师会往界面中填入非常多的参数,包括 url 地址,请求方法,消息头和消息体等一系列数据,在请求参数比较多的情况下非常花时间。
2025年04月11日
目前大部分的项目都是前后端分离的,后端除了要提供接口外,还需要提供接口文档,有时由于需求、设计或方案的变更,会造成接口变更但是接口文档没有及时更新的情况。Swagger是一个在你写接口的时候帮你自动生成接口文档,并且文档会随着接口的变化而变化的东西,只要你遵循它的规范并写一些接口的说明注解即可。
Swagger是一个规范和完整的框架,用于生成、描述、调用和可视化RESTful风格的Web服务的接口文档。下面我们通过一个实例来看一下Swagger的使用。
2025年04月11日
将SWAG风潮作为设计核心的潮流品牌GAWS近日释出2016年春季Lookbook,设计师把美国嘻哈风格服饰与时下流行的细节相结合,以黑、白为基调,在服饰上融入了许多宗教风格图案以及抽象几何图形,打造出球服风T恤、长款连帽卫衣、太空棉棒球夹克、字母织带外套、两件式短裤+打底等款式,辅以金属拉链的装饰以及巧妙精致的拼接工艺,透着品牌一贯的高街味道。与此同时,满版的墨点印花设计也值得关注,网眼布材质对于细节的雕琢更是将街头Swagger独有的律动感呈现出来。在保证街头风格之上,将剪裁、用料、细节各方面都做到极致,目前已于网络店铺开始贩售,喜欢的朋友不妨至YOHO!BUY有货进行购买!text: 粗眉
2025年04月11日
1. Swagger(俗称:丝袜哥)是什么东西?
Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法,参数和模型紧密集成到服务器端的代码,允许API来始终保持同步。Swagger 让部署管理和使用功能强大的API从未如此简单。
2025年04月11日
前后端接口联调需要API文档,我们经常会使用工具来生成。之前经常使用Swagger来生成,最近发现一款好用的API文档生成工具smart-doc, 它有着很多Swagger不具备的特点,推荐给大家。
2025年04月11日
最近简单的学习了一下Golang,并且用Gin开发了两个小应用,一个短域名生成,一个微信小程序。感受到了Golang的代码简洁、部署简单、内存占用少、零停机平滑重启等优势。在开发小程序的时候,需要生成接口文档,这里需要用到Gin-Swagger了,所以简单的就来整理一下。
这里我用的环境是:
2025年04月11日
当我们使用swagger,进行接口测试,怕接口不安全,担心暴露。可以采用两种方式
可以对swagger文档配置只在测试环境可访问,生产环境不可访问。
@Profile({"dev","test"})