Swagger UI

之前开源了一款项目骨架mall-tiny，完整继承了mall项目的整个技术栈。总感觉mall-tiny集成了太多中间件，过于复杂了。这次对其进行了简化和升级，使它成为了一款拥有完整权限管理功能的快速开发脚手架，希望对大家有所帮助！ 简介 mall-tiny 是一款基于SpringBoot+MyBatis-Plus的快速开发脚手架，拥有完整的权限管理功能，可对接Vue前端，开箱即用。 项目演示 mall-tiny 项目可无缝对接 mall-admin-web 前端项目，秒变权限管理系统。 技术选型 数据库表结构 化繁为简，仅保留了权限管理功能相关的9张表，方便自由定制； 使用流程 环境搭建 简化依赖服务，只需安装最常用的MySql和Redis服务即可，数据库中需要导入 mall_tiny.sql 脚本。 开发规约 项目包结构 src ├── common -- 用于存放通用代码 | ├── api -- 通用结果集封装类 | ├── config -- 通用配置类 | ├── domain -- 通用封装对象 | ├── exception -- 全局异常处理相关类 | └── service -- 通用业务类 ├── config -- SpringBoot中的Java配置 ├── domain -- 共用封装对象 ├── generator -- MyBatis

关于 Swashbuckle.AspNetCore3.0 一个使用 ASP.NET Core 构建的 API 的 Swagger 工具。直接从您的路由，控制器和模型生成漂亮的 API 文档，包括用于探索和测试操作的 UI。 项目主页： https://github.com/domaindrivendev/Swashbuckle.AspNetCore 项目官方示例： https://github.com/domaindrivendev/Swashbuckle.AspNetCore/tree/master/test/WebSites 之前写过一篇 Swashbuckle.AspNetCore-v1.10 的使用 ,现在 Swashbuckle.AspNetCore 已经升级到 3.0 了，正好开新坑(博客重构)重新封装了下，将所有相关的一些东西抽取到单独的类库中,尽可能的避免和项目耦合，使其能够在其他项目也能够快速使用。 运行示例 封装代码 Swagger封装相关源码： https://github.com/moxycoding/moxy.api.dotnet/tree/master/src/Core/Moxy.Swagger 参考下面步骤可自行封装 1. 新建类库并添加引用 我引用的版本如下 <PackageReference Include="Microsoft

前言 我们通常把 RPC 用作内部通信，而使用 Restful Api 进行外部通信。为了避免写两套应用，我们使用 grpc-gateway 把 gRPC 转成 HTTP 。服务接收到 HTTP 请求后， grpc-gateway 把它转成 gRPC 进行处理，然后以 JSON 形式返回数据。本篇代码以上篇为基础，最终转成的 Restful Api 支持 bearer token 验证、数据验证，并添加 swagger 文档。 gRPC转成HTTP 编写和编译proto 1.编写simple.proto syntax = "proto3"; package proto; import "github.com/mwitkow/go-proto-validators/validator.proto"; import "go-grpc-example/10-grpc-gateway/proto/google/api/annotations.proto"; message InnerMessage { // some_integer can only be in range (1, 100). int32 some_integer = 1 [(validator.field) = {int_gt: 0, int_lt: 100}]; // some_float can only be in

环境定义 根据实际需要，我们将整个系统划分为如下几个部分，除通用以外，对其余几个根据希腊字母顺序进行了命名。 code name description alpha 开发环境 供开发人员研发使用 beta 测试环境 供测试人员做功能测试使用 gamma 预发环境 供测试人员做集成测试使用 delta 生产环境 供运营人员、用户正常使用 common 通用环境 供开发、测试人员研发、测试使用 服务 通用 env service ip port username passwd common nginx 192.168.3.73 80/443 - - common gitlab 192.168.3.78 80 - - common zentao 192.168.3.77 80 - - common jenkins 192.168.3.68 8080 - - Beta env service ip port username passwd beta mysql 192.168.3.83 3306 root beta redis 192.168.3.81 6379 - beta nacos 192.168.3.74 8848 - - beta api-usr 192.168.3.85 18000 - - beta api-ops 192.168.3.85 18001 - - beta api

Swagger介绍 1.什么是Swagger 作为后端程序开发，我们多多少少写过几个后台接口项目，不管是编写手机端接口，还是目前比较火热的前后端分离项目，前端与后端都是由不同的工程师进行开发，那么这之间的沟通交流通过接口文档进行连接。但往往伴随很多问题，后端程序员认为编写接口文档及维护太花费时间精力，前端的认为接口文档变动更新不及时，导致程序之间相互调用出行问题。那么能简化接口文档的编写直接自动生成吗？当然能！如是乎Swagger这种接口文档在线自动生成工具便孕育而生。 Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法，参数和模型紧密集成到服务器端的代码，允许API来始终保持同步。Swagger 让部署管理和使用功能强大的API从未如此简单。 2.Swagger优点 代码变，文档变。只需要少量的注解，Swagger 就可以根据代码自动生成 API 文档，很好的保证了文档的时效性。 跨语言性，支持 40 多种语言。 Swagger UI 呈现出来的是一份可交互式的 API 文档，我们可以直接在文档页面尝试 API 的调用，省去了准备复杂的调用参数的过程。 还可以将文档规范导入相关的工具（例如 Postman、SoapUI）,

Swagger介绍 1.什么是Swagger 作为后端程序开发，我们多多少少写过几个后台接口项目，不管是编写手机端接口，还是目前比较火热的前后端分离项目，前端与后端都是由不同的工程师进行开发，那么这之间的沟通交流通过接口文档进行连接。但往往伴随很多问题，后端程序员认为编写接口文档及维护太花费时间精力，前端的认为接口文档变动更新不及时，导致程序之间相互调用出行问题。那么能简化接口文档的编写直接自动生成吗？当然能！如是乎Swagger这种接口文档在线自动生成工具便孕育而生。 Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法，参数和模型紧密集成到服务器端的代码，允许API来始终保持同步。Swagger 让部署管理和使用功能强大的API从未如此简单。 2.Swagger优点 代码变，文档变。只需要少量的注解，Swagger 就可以根据代码自动生成 API 文档，很好的保证了文档的时效性。 跨语言性，支持 40 多种语言。 Swagger UI 呈现出来的是一份可交互式的 API 文档，我们可以直接在文档页面尝试 API 的调用，省去了准备复杂的调用参数的过程。 还可以将文档规范导入相关的工具（例如 Postman、SoapUI）,

Swagger介绍 1.什么是Swagger 作为后端程序开发，我们多多少少写过几个后台接口项目，不管是编写手机端接口，还是目前比较火热的前后端分离项目，前端与后端都是由不同的工程师进行开发，那么这之间的沟通交流通过接口文档进行连接。但往往伴随很多问题，后端程序员认为编写接口文档及维护太花费时间精力，前端的认为接口文档变动更新不及时，导致程序之间相互调用出行问题。那么能简化接口文档的编写直接自动生成吗？当然能！如是乎Swagger这种接口文档在线自动生成工具便孕育而生。 Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法，参数和模型紧密集成到服务器端的代码，允许API来始终保持同步。Swagger 让部署管理和使用功能强大的API从未如此简单。 2.Swagger优点 代码变，文档变。只需要少量的注解，Swagger 就可以根据代码自动生成 API 文档，很好的保证了文档的时效性。 跨语言性，支持 40 多种语言。 Swagger UI 呈现出来的是一份可交互式的 API 文档，我们可以直接在文档页面尝试 API 的调用，省去了准备复杂的调用参数的过程。 还可以将文档规范导入相关的工具（例如 Postman、SoapUI）,

下载地址： 百度网盘 Java可视化UML工作流系统（Activiti7+SpringBoot） “程序是有逻辑的，业务是有流程的”，工作流引擎可以减少硬编码，高效处理业务需求变更，所以领悟工作流引擎背后的思想，将有助于在职场中高效交付工作结果，是助你奠定程序生涯迈向更高平台的“基石”。讲师倾囊相授三大核心：① 以“代码驱动式”教学模式，精讲最新版工作流引擎Activiti7核心组件；② 传授你业 务建模或者软件建模的“工程化思维”；③ 基于SpringBoot+Activiti+SpringSecurity 等技术栈，“手把手”带你设计与实战企业级的黑马项目：《通用型可视化UML工作流系统》。 适合人群 有志于成为“程序员”的优秀青年 初入职场Java工程师 对业务建模、UML软件建模感兴趣的人 技术储备要求 熟悉Java基本语法 了解Maven基本使用 MySQL基本的CRUD 章节目录： 第1章 清晰的学习目标，让学习更轻松 首先项目演示了解项目整体情况，便于小伙伴通过本课程学习，能够最终做出的怎样的项目效果。同时，明确学习activiti工作流对今后工作的重要性，确立学习目标。 1-1 玩转黑马项目，“技术+业务”能力齐飞试看 第2章 开发前准备：环境搭建篇【选修】 所谓“君欲善其事，必先利其器”，因此本章带着小伙伴们将课程所需环境一一构建起来，小伙伴们可以结合自己情况

在 WebSecurity 的配置类中设置放行swagger相关资源 @Configuration @EnableWebSecurity public class WebSecurityConfig extends WebSecurityConfigurerAdapter { @Override public void configure ( WebSecurity web ) throws Exception { web . ignoring ( ) . antMatchers ( "/v2/api-docs" , "/swagger-resources/configuration/ui" , "/swagger-resources" , "/swagger-resources/configuration/security" , "/swagger-ui.html" , "/css/**" , "/js/**" , "/images/**" , "/webjars/**" , "**/favicon.ico" , "/index" ) ; } } 添加之后再运行 http://localhost:9001/swagger-ui.html 就可以访问了 来源： oschina 链接： https://my.oschina.net/u/4270607/blog/4406292

新建Web API工程 选Empty，勾选Web API，不要选择Web API，那样会把MVC勾上，这里不需要MVC Web API工程属性 XML文件用于生成在线文档 新建Windows服务作为Web API的宿主 WebApiHost工程属性 控制台应用程序方便调试 Windows服务安装Microsoft.AspNet.WebApi.OwinSelfHost 工程WebApiDemo需要引用Microsoft.Owin.dll WebApiDemo安装Swashbuckle 应用程序入口 using System; using System.Collections.Generic; using System.Diagnostics; using System.Linq; using System.ServiceProcess; using System.Text; using System.Threading.Tasks; namespace WebApiHost { static class Program { /// <summary> /// 应用程序的主入口点。 /// </summary> static void Main( string [] args) { RunDebug(); StartService(); } private static void