swagger

20200207 项目调研可以写一下俩工程的实现原理，最后采用哪个工程进行改造，采用的实现方案是什么 20200206 https://segmentfault.com/a/1190000021008147 早前..... 大家好，关于接口文档工具，结合前天群里的讨论，简单做了些调研，我觉得可以参考目前咱们工作实际，从短期和长期两个方向考虑，短期来讲解决当前使用中的痛点，长期来讲看看能否封装一个产品话的工具。大家有什么问题可以提出来，比如下面的是我结合群聊做的一个demo springfox-swagger 的代码侵入问题 yapi接口录入麻烦问题 可以考虑结合 https://github.com/zxcvbnmzsedr/apidoc 二次开发 0.1.0版本 这两天我写一个Demo，做一个maven插件，结合上述代码库，将javadoc 通过yapi的 openapi的方式自动导入ypai pom配置 导入效果： 只需要相关注释，不用写注解侵入性小 对于没有注释的可兼容优化类型和方法名代替 是否需要私有化部署yapi 建议使用公司现有工具，不重复造轮子 如果现有工具不能满足需求，或者咱们提出的问题沟通支持缓慢，再考虑私有化部署 0.2.0版本 Spring spi机制，伴随Spring容器启动，自动上传api，业务侧不感知 org.springframework.boot

前言 之前一直使用 http://start.spring.io/ 搭建初始化项目，或者编译工具自带的功能创建springboot项目。虽然都是start的jar，但是还是不可避免的要去写配置文件，或一些基本的整合配置，基本上没一个项目这些步骤都跳不掉。 刚好最近接了一个任务搭建基础项目脚手架，于是就有了下面这个项目 https://gitee.com/kinbug/quickstart quickstart 介绍 quickstart：创建一个微服务脚手架，只需要一个maven命令，不光整合了springboot和springcloud Alibaba与所有配置，还加入了代码自动生成工具，并自动带swagger。并实现了分布式表id，和sql注入。懒到极致，让开发更快一步。 懒是什么？懒是一种理智，一种从不会委曲求全的理智。懒也是一种境界，一种平静内心，激荡思绪的境界；懒推动我们整个人类的进步，现如今，更高更快更强这种奥林匹克精神早已传遍五湖四海，这不就是要我们有更高的效率，懒的价值在于节省时间和金钱，在于降低做事的成本。 它告诉我们，不要总是一根弦崩下去，我们要包容它，接受它，懒是人类进步的源泉，正是因为懒，才有了我们如今的繁荣和昌盛，才有了我们面对困难时的从容和不慌不忙。懒得去做，其实没有错，相比那些盲目的，从未思考的奋斗，更有价值。它不仅提升了我们的生活质量

using Swashbuckle.Swagger; using System.Linq; using System.Web.Http.Description; namespace InvoiceApi.InvoiceHelper { /// <summary> /// 隐藏接口，不生成到swagger文档展示 /// </summary> [System.AttributeUsage(System.AttributeTargets.Method | System.AttributeTargets.Class)] public partial class HiddenApiAttribute : System.Attribute { } public class HiddenApiFilter : IDocumentFilter { public void Apply(SwaggerDocument swaggerDoc, SchemaRegistry schemaRegistry, IApiExplorer apiExplorer) { foreach (ApiDescription apiDescription in apiExplorer.ApiDescriptions) { if (Enumerable.OfType<HiddenApiAttribute>

有时候我们会遇到这样的需求，公司不大，但是信息化程度也蛮高，公司的员工素质也很高，管理也很规范，甚至还有外地分公司，直接上一个OA系统吧，往往也无法符合公司的灵活管理需求，往往受制于商品化OA的功能限制，商业限制。直接定制一个OA系统也不大愿意承受几十万的开发费用，同时也不知道都提什么需求比较好，也不想去惹麻烦， 也没精力去整理需求。 这里不得不提到现在流行的java快速开发平台，价格不高，可扩展强。平台可以搭建OA、ERP、CRM多种企业系统。 快速开发平台，简单的理解就是：开发人员以某种编程语言或者某几种编程语言（比如：目前流行的多种web技术，包括springboot， JPA，Druid， Activiti，Lombok，swagger，poi，WebSocket，Jquery，BootStrap， maven，Jenkins 等等 ）为基础，将各种需要的功能封装在不同的层中，具大家调用而开发出来的一个软件。 这个java快速开发平台其实不是一个最终的软件产品，它是一个二次开发软件框架，用户可以在这个产品上进行各种各样的软件产品的开发，并且在这个产品上进行开发的时候，不需要像以往的编程方式那样编写大量的代码，而是只需要进行一些简单的配置，或者是写极少量的代码便可以完成一个业务系统的开发工作——XJR快速开发平台。 这款 XJR快速开发平台

Web端应用测试主要障碍之一就是在不同的浏览器上“测试他们的网站/应用程序”，也称为“跨浏览器测试”或者“兼容性测试”。 浏览器和浏览器版本很多（Google Chrome，Mozilla Firefox，Internet Explorer，Microsoft Edge，Opera，Yandex等），可以通过多种设备（通过台式机，笔记本，智能手机，平板电脑等）访问网站/应用。 ）以及可能用于访问网站的多种操作系统（Windows，MacOS，Linux，Android，iOS等）。 要确保网站的UI/UX及其功能正常运行，并且在“浏览器+浏览器版本+操作系统+设备配置”的组合上没有任何BUG，则将需要大量的开发，测试和维护工作。手动跨浏览器测试的主要痛点是，测试人员可能需要花费大量时间来测试不同的网页，跨浏览器跨越来越多的“复杂”组合中的不同断点测试Web应用程序。 测试人员要确保在不影响迭代周期的情况下，保持测试流程覆盖到位以提高执行测试的速度。下面是改善手动跨浏览器测试（兼容测试）的一些方法和技巧。 并行测试 不管测试策略是否涉及自动化测试，众所周知的事实是，与串行开发/串行测试相比，并行模块开发/并行测试将始终更快。可以通过开发测试脚本来实现并行测试，该脚本将允许跨不同浏览器，操作系统和设备的源代码进行跨浏览器测试。您可以使用Selenium

swagger2 接口文档,整个微服务接口文档 // @HystrixCommand 默认开启服务隔离，是以线程池方式 // @HystrixCommand 默认开启服务降级，fallbackMethod 方法名就是服务的降级名称 // @HystrixCommand 默认开启服务熔断机制 // @Hystrix 要禁止超时时间，默认1 秒，如果没有即使响应，会走业务逻辑，但是也会走服务降级方法，所以要禁止超时时间 @HystrixCommand(fallbackMethod = "orderServiceFallback") spring-boot-starter-swagger spring-bot-starter-swagger 来源： oschina 链接： https://my.oschina.net/miaojiangmin/blog/3164618

顾名思义，可用性测试是对网站或应用程序的可用性进行的一种测试类型。通过可用性测试，可能会将其与产品的“易用性 ”相混淆。易用性是一个广义术语，还有很多其他内容。本文中，您将了解到可用性和可用性测试的各个方面。 在详细讨论可用性测试之前，您需要了解为什么可用性如此重要。根据ISO，人们可能会认为可用性是： 在产品使用的特定上下文中，可以使用产品有效、高效且令人满意地达到目标的程度。 这些行定义了可用性测试背后的核心基本理论。无论是产品还是产品用例，即使定义产品可用性的参数会发生变化，可用性测试背后的关键特性和基本原理也保持不变。 为什么我们需要关注可用性？ 根据最新统计： 在第一时间无法弄清楚网站功能后，有46％的人离开了网站。 44％的人因为发现网站中的引导性信息不足而离开该网站。 37％的人因为设计不佳或导航不佳而决定永远不回网站。 这些比例很高，任何企业都不愿意失去这些用户，因此有必要进行可用性测试，并确保您不会错过如此众多的用户。换句话说，如果用户访问您的网站，而该网站无法以直观，有效和令人满意的方式达到他们的目标，他们很可能会投入对手的怀里。用户体验是使在线业务成功的最重要方面之一。这就是在可用性测试需要测试的内容。 那么，要测试产品的可用性要进行哪些测试？ 有效性 有效性是指用户是否能够准确地实现目标。在执行可用性测试时，需要确保网站/产品是否确实解决了核心用户需求

1、在springboot中使用swagger的话，首先在pom文件中引入依赖 <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 --> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.9.2</version> </dependency> <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui --> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.9.2</version> </dependency>2、创建配置类 @Configuration @EnableSwagger2 public class Swagger2Config{ @Bean public Docket swaggerSpringMvcPlugin(){ return new Docket