草庐IT

JAVA中让Swagger产出更加符合我们诉求的描述文档,按需决定显示或者隐藏指定内容

大家好,又见面啦。在前一篇文档《JAVA中自定义扩展Swagger的能力,自动生成参数取值含义说明,提升开发效率》中,我们探讨了如何通过自定义注解的方式扩展swagger的能力让Swagger支持自动从指定的枚举类生成接口文档中的字段描述的实现思路。其实swagger作为一个被广泛使用的在线接口文档辅助工具,上手会用很容易,但想用好却还是需要一定功夫的。所以呢,本篇文档就和大家一起来聊一聊如何用好swagger,让其真正的成为我们项目交付过程中的神兵利器。更改接口文档总标题与描述默认的情况下,Swagger的界面整个文档的名称以及描述内容都是通用值,这会让人拿到文档之后比较困惑,无法知晓这是哪

软件研发的核心问题 -- 效率,质量,成本与产出的关系

软件工程的核心问题-质量,时间,内容与投入之间的关系质量,时间,内容,三者各在一个端点。三者构成一个三角形关系,三者围成的三角形面积就是一个软件投入。在面积不变即投入不变的情况下,任何一个提高单一端点的行为都会降低剩余的两个端点。质量。指代码的质量。时间。指软件的开发时间。包括开发时间,测试时间。内容。指系统包含的模块,功能点等内容。软件开发的本质就是在一定的投入下,在一定的时间内,以一定的质量,开发出一定数据量的内容(功能模块或功能点)。 

软件研发的核心问题 -- 效率,质量,成本与产出的关系

软件工程的核心问题-质量,时间,内容与投入之间的关系质量,时间,内容,三者各在一个端点。三者构成一个三角形关系,三者围成的三角形面积就是一个软件投入。在面积不变即投入不变的情况下,任何一个提高单一端点的行为都会降低剩余的两个端点。质量。指代码的质量。时间。指软件的开发时间。包括开发时间,测试时间。内容。指系统包含的模块,功能点等内容。软件开发的本质就是在一定的投入下,在一定的时间内,以一定的质量,开发出一定数据量的内容(功能模块或功能点)。 
12