swagger

\\\\\\\\\\\ 项目后端地址： https://github .com/olongfen/gorm-gin-admin 项目前端地址： https://github.com/olongfen/user_admin 项目指导文档 Web UI Framework：element-ui Server Framework：gin Grom Framework: gorm 1. 基本介绍 1.1 项目结构 │ ├─conf (Config file) │ ├─docs （swagger APIs docs） │ ├─log (log file) │ ├─public (public static file) │ ├─static (head icon) ├─src │ ├─controller (Controller) │ ├─middleware (Middleware） │ ├─models （Model entity） │ ├─pkg （Project private package） │ ├─adapter (Casbin adapter) │ ├─app (Gin service response) │ ├─codes (Response code) │ ├─error (Project private error) │ ├─gredis (Redis) │ ├

系列目录 一 . 创建项目并集成swagger 　　 1.1 创建 　　 1.2 完善 二. 搭建项目整体架构 三. 集成轻量级ORM框架——SqlSugar 　　 3.1 搭建环境 　　 3.2 实战篇：利用SqlSugar快速实现CRUD 　　 3.3 生成实体类 四. 集成JWT授权验证 前一章我们在项目中初步集成了swagger插件，但是还有一些问题需要解决，所以这一章要做的，就是完善swagger的相关设置。 1. 设置swagger ui页面为启动页 在前一章的末尾，我们通过在域名后面输入/swagger后，成功访问到swagger ui页，但是我们发现每次运行项目，都会默认访问api/values这个接口，我想要将启动页设为swagger（或者是你画好的任一个html页），那应该怎么设置呢？ 位置就在Properties下的launchSettings.json文件里，只要将profiles下的launchUrl改成你需要的地址就可以 当然，文件里还有其他一些基本设置，比如端口设置，就不一一说了。 2. 注释问题 swagger很重要的一个功能，就是将我们接口的注释信息和参数（包括实体类）的注释信息显示到页面上。 现在我们分别将控制器、函数和参数添加相应的注释（添加方式是在类或函数的上一行敲三下“/”） F5运行，发现swagger ui上并没有将它们显示出来

Swagger，SoapUI和SmartBear第三次发布了有关全球API趋势的年度报告。全球大流行和不断发展的API做法已显着影响团队经验。公司比以往任何时候都更加专注于在所有组织方面创建无缝、统一的系统。他们到底如何实现数字化转型？这是1500多个API开发人员、架构师、测试人员和产品潜在客户的焦点。 背景 SmartBear收到了超过3500份调查回复，揭示了涉及API生命周期和整个API生态系统背后驱动因素的当前趋势。问题包括以下内容： • API设计 • 发展历程 • 文献资料 • 测试中 • 监控方式 • 技术和工具 • 标准品 SmartBear的方法包括广泛的受访者。与类似调查（例如Cloud Elements的API集成状态）相反，SmartBear的研究似乎更加全面。2020年API状况报告的参与者人数几乎是前者的四倍。Smartbear收集了来自专业人士的3500多个回答，涉及52个单独的问题。该公司表示，这是在COVID-19危机期间首次出现的此类报告。 参与组织的规模从1到10000不等——大多数企业雇用100名或更少的员工，还有部分参与者雇用1000名以上的员工。接受调查的公司数量最多的是雇用1至25名员工，占受访者的23％。尽管每个组织的“层级”都有完整的代表，但数字表明SmartBear在较小的公司（或初创公司）中具有很高的吸引力。现在

Windos系统下使用 ASP.NET Core 系统必备 详情查看 https://docs.microsoft.com/zh-cn/aspnet/core/tutorials/first-web-api?view=aspnetcore-2.1 具有以下工作负载的 vs2017 15.7.3版或者更高版本: ASP.NET 和 Web 开发 .NET Core 跨平台开发 ASP.NET Core Web API 帮助页 官方Demo地址： https://docs.microsoft.com/zh-cn/aspnet/core/tutorials/web-api-help-pages-using-swagger?view=aspnetcore-2.1 第一步： 新建项目： 第二步： 通过NuGet安装 Swashbuckle.AspNetCore 第三步： 将 Swagger 生成器添加到 Startup.ConfigureServices 方法中的服务集合中： 如果有多个Xml就需要这种形式，只有一个的话则不需要~~ 在 Startup.Configure 方法中，启用中间件为生成的 JSON 文档和 Swagger UI 提供服务： 第四步： 生成Xml文件 第五步： 加上备注，运行看效果~ 但是我们运行看到的效果却是这样的~ 在浏览器地址 加上后缀

JHRS 一个新学WPF的IT老鸟，肝了2个月做了这么一个WPF企业级开发框架，站长clone学习，觉得甚是不错。这是一个使用了Prism搭建的插件式框架，封装了DataGrid的使用，使整个框架子模块简单易学、易扩展，特别是作者还写了一个系列博客教程，值得点赞。 下面是作者博文系列首篇： WPF企业级开发框架搭建指南（启示录），2020从入门到放弃 这个系列的文章旨在记录工作中使用WPF开发新的医疗项目中，有感于必须统一掉一些规范上的事情，并且提高团队开发效率，遂折腾了这么一个半吊子的框架，这个标题WPF企业级开发框架搭建指南，2020从入门到放弃可能会唬住一些人，但看到这些零碎文字的朋友就凑和着看吧，如果能帮助到你，那也荣幸了。 WPF技术是一个很不错的技术，但一直没有上手过正式的项目，趁在做这个医疗项目时，遂搭建一个WPF开发框架，目的是为了统一WPF开发并提高开发效率；我对WPF技术算是零基础，现学现卖，用这些不成体系的文字予以记录一些想法和实践。 WPF企业级开发框架搭建系列文章导航 WPF企业级开发框架搭建指南（启示录） JHRS开发框架之基础类库 JHRS开发框架之第三方框架选型 JHRS开发框架之WPF调用Web API封装 JHRS开发框架之客户端入口项目 JHRS开发框架之各子系统如何整合 JHRS开发框架之怎样设计合理的ViewModel基类

点击上方“ 黄小斜 ”，选择“ 设为星标 ” 做积极的人，而不是积极废人 作者 | 无知者云 链接 | https://www.cnblogs.com/davenkin 前言 在我的工作中，我从零开始搭建了不少软件项目，其中包含了基础代码框架和持续集成基础设施等，这些内容在敏捷开发中通常被称为“第0个迭代”要做的事情。但是，当项目运行了一段时间之后再来反观，我总会发现一些不足的地方，要么测试分类没有分好，要么基本的编码架子没有考虑周全。 另外，我在工作中也会接触到很多既有项目，公司内部和外部的都有，多数项目的编码实践我都是不满意的。比如，我曾经新加入一个项目的时候，前前后后请教了3位同事才把该项目在本地运行起来；又比如在另一项目中，我发现前端请求对应的Java类命名规范不统一，有被后缀为Request的，也有被后缀为Command的。 再者，工作了这么多年之后，我越来越发现基础知识以及系统性学习的重要性。诚然，技术框架的发展使得我们可以快速地实现业务功能，但是当软件出了问题之后有时却需要将各方面的知识融会贯通并在大脑里综合反应才能找到解决思路。 基于以上，我希望整理出一套公共性的项目模板出来，旨在尽量多地包含日常开发之所需，减少开发者的重复性工作以及提供一些最佳实践。对于后端开发而言，我选择了当前被行业大量使用的Spring Boot，基于此整理出了一套公共的、基础性的实践方式

1、加入 pom 文件 <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <!-- <scope>test</scope> --> <exclusions> <exclusion> <groupId>org.junit.vintage</groupId> <artifactId>junit-vintage-engine</artifactId> </exclusion> </exclusions> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox

作者：Rajiv Srivastava 翻译：mush 来源：http://mushiming.top/mushblog/archives/823 我是一名云API开发人员和架构师，目前正致力于为美国的大型零售客户提供基于Google GCP的微服务。 过渡/实施微服务给组织带来了重大挑战。基于我对生产中的微服务的曝光，我已经确定了这些挑战和解决方案。 我在2018年6月写这篇文章。目前，微服务架构尚未成熟到足以完全解决所有现有挑战，但是，开源社区和IT产品公司正试图解决所有这些未解决的问题。关于这一主题的所有新研究都是基于寻找新挑战的解决方案。 这些是微服务架构和提出的解决方案的十大挑战： 1.数据同步 – 我们使用事件源代码架构来使用异步消息传递平台解决此问题。传奇设计模式可以应对这一挑战。 2.安全性 – API网关可以解决这些挑战。Kong非常受欢迎，并且是开源的，并且正在被许多公司用于生产。还可以使用JWT令牌，Spring Security和Netflix Zuul / Zuul2为API安全性开发自定义解决方案。还有企业解决方案，如Apigee和Okta（两步认证）。Openshift用于公共云安全的顶级功能，如基于Red Hat Linux Kernel的安全性和基于命名空间的app-to-app安全性。 3.版本控制 –

背景 Swagger是目前最受欢迎的REST APIs文档生成工具，同时也是API的在线测试工具。功能强大谁用谁知道。我就不用在这里推广它了。今天要解决的问题是：如果让一些特定的API接口在Swagger中不显示，即从Swagger中过滤掉一些不想展示的接口？通常我们使用Swagger都是通过指定要扫描的包或者扫描具有某些注解的Controller，来生成API，那么如果这其中还想过滤掉一些特定API怎么做呢？ 实现方法 1、添加特性，隐藏swagger接口特性标识 /// <summary> /// /// </summary> /// <param name="swaggerDoc"> </param> /// <param name="context"> </param> public void Apply ( SwaggerDocument swaggerDoc, DocumentFilterContext context ) { foreach (ApiDescription apiDescription in context.ApiDescriptions) { if (apiDescription.TryGetMethodInfo( out MethodInfo method)) { if (method.ReflectedType.CustomAttributes

背景 Swagger是目前最受欢迎的REST APIs文档生成工具，同时也是API的在线测试工具。功能强大谁用谁知道。我就不用在这里推广它了。今天要解决的问题是：如果让一些特定的API接口在Swagger中不显示，即从Swagger中过滤掉一些不想展示的接口？通常我们使用Swagger都是通过指定要扫描的包或者扫描具有某些注解的Controller，来生成API，那么如果这其中还想过滤掉一些特定API怎么做呢？ 实现方法 1、添加特性，隐藏swagger接口特性标识 /// <summary> /// /// </summary> /// <param name="swaggerDoc"></param> /// <param name="context"></param> public void Apply(SwaggerDocument swaggerDoc, DocumentFilterContext context) { foreach (ApiDescription apiDescription in context.ApiDescriptions) { if (apiDescription.TryGetMethodInfo(out MethodInfo method)) { if (method.ReflectedType.CustomAttributes.Any(t