Swagger UI

　　在上一篇《 b2b2c系统jwt权限源码分享part1 》中和大家分享了b2b2c系统中jwt权限的基础设计及源码，本文继续和大家分享jwt和spring security整合部分的思路和源码。 在上一篇文章中已经分享了关键的类图： 如上图所示，权限的校验主要涉及到四个类： AbstractAuthenticationService BuyerAuthenticationService SellerAuthenticationService AdminAuthenticationService AbstractAuthenticationService 对于三端（买家买家管理端）验权的公用部分我们抽象在AbstractAuthenticationService中： public abstract class AbstractAuthenticationService implements AuthenticationService { @Autowired protected TokenManager tokenManager; private final Logger logger = LoggerFactory.getLogger(getClass()); /** * 单例模式的cache */ private static Cache<String, Integer>

swagger2 升级到了3，并改名为OpenAPI Spec，所有部分注解有一些变化，这里以thinkphp6+swagger-php3.0来配置 1、前端部分git或dowload一份swagger-ui到能够访问到服务目录中，如我这里nginx配置指向到thinkphp6根目录public中,所以download一份swagger-ui到该根目录中，swagger-ui下载地址https://github.com/swagger-api/swagger-ui 找到dist目录, 打开index.html把其中的url改成自己到服务器url，这里我以本地配置为例： 如果想支持中文在index.html中加上 <script src='lang/translator.js' type='text/javascript'> </script><script src='lang/zh-cn.js' type='text/javascript'></script> 原项目网页地址是： http://127.0.0.1:8806 , 现在接口前端ui地址是： http://127.0.0.1:8806/swagger-ui/dist/index.html , 此时因为没有配置swagger.json只能显示头部，无法显示接口详细信息 2、安装swagger-php后端

如何生成swagger-ui需要的json或者yaml的文件? tp5根目录, composer require zircote/swagger-php 方案1： 有需要的时候手动执行命令生成api_doc.json文件 添加命令 application/command.php 新增一行： \app\common\command\run\AutoCreateApiDoc::class , 就可以执行 php think run:autoCreateApiDoc 手动生成swagger json配置文件, 配置文件所在路径 public/api_doc.json /** * Created by querying. * Date: 19-2-20 * Time: 下午5:15 */ namespace app\common\command\run; use function \OpenApi\scan; use think\console\Command; use think\console\Input; use think\console\Output; use think\facade\App; class AutoCreateApiDoc extends Command { protected function configure() { $this->setName("run

Swagger-ui是一个用于提供restful接口api测试的工具，结合Springcloud引入后，可以部分代替像postman等 测试rest接口的工具。而且具有实时性，与其他系统对接时具有极大的方便性。 1、引入依赖 pom.xml <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.bincai.cloud</groupId> <artifactId>cloud-cust-domain</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>jar</packaging> <name>cloud-cust-domain</name> <url>http://maven.apache.org</url> <parent> <groupId>org

下载 swagger-ui 下载 wget https://gitee.com/qzeroq/swagger-ui/repository/archive/v3.25.0?format=zip 下载 swagger-php 下载,改变版本要求 php>=7.0 wget https://gitee.com/qzeroq/swagger-php/repository/archive/3.0.1?format=zip 安装依赖 [root@localhost local]# cd src/ [root@localhost src]# cd swagger-php [root@localhost swagger-php]# pwd /usr/local/src/swagger-php [root@localhost swagger-php]# ll total 136 drwxr-xr-x 2 root root 131 Jan 19 10:12 bin -rw-r--r-- 1 root root 108 Nov 16 2018 Changelog.md -rw-r--r-- 1 root root 1450 Jan 19 10:07 composer.json -rw-r--r-- 1 root root 94619 Jan 19 10:12 composer.lock drwxr

本文主要讲解如何创建一个swagger 的springboot starter项目，只要在其他服务中引入该starter.并添加相关注解，即可完成接口文档化。 并讲解了如何在spring cloud zuul网关中引入swagger，为前端提供统一的访问入口。 本文的完整代码: GitHub:swagger-starter 。 创建sawgger-springboot-starter项目 ＰＯＭ配置 pom引入swagger依赖 <!-- swagger 依赖 --> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.9.2</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.9.2</version> </dependency> pom引入springboot starter相关依赖 <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring

接上篇 swaggerUI提供了可视化界面帮助我们管理服务的访问路口，这就需要我们在代码中规范我们的书写格式。并且在swagger的界面上还能够模拟浏览器对服务进行访问。 接口总览 创建POST接口 创建一个保存用户的接口 @RequestMapping(value = "/addUser",method = RequestMethod.POST) @ApiModelProperty(value="user",notes = "用户信息的json串") @ApiOperation(value = "新增用户", notes="返回新增的用户信息") public Object adduser(@RequestBody User user){ Map map = new HashMap(); map.put("msg","success"); map.put("code","1"); return map; } 创建一个PUT接口 修改用户接口 @RequestMapping(value = "/updateUser",method = RequestMethod.PUT) @ResponseBody @ApiModelProperty(value="user",notes = "修改后用户信息的json串") @ApiOperation(value = "更新用户信息",

说明 第一步：创建项目 浏览器打开： https://start.spring.io/，生成一个spring boot项目 点击Generate这个按钮，下载项目包文件 第二步：导入开发工具 打开下载目录，解压项目文件 启动idea，引入项目文件 第三步：引入swagger-ui包 <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.9.2</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.9.2</version> </dependency> 第四步：创建一个swagger 配置 @EnableSwagger2 @Configuration public class SwaggerConfig { @Bean public Docket api(){ return new Docket(DocumentationType.SWAGGER_2) .apiInfo(apiInfo()) .select() .apis

【推荐】2019 Java 开发者跳槽指南.pdf(吐血整理) >>> SpringBoot-Swagger整合zuul智能列表 简介 可能大家都有用过 swagger ,可以通过 ui 页面显示接口信息，快速和前端进行联调。 现在基本都是多模块微服务化，每个服务都有这样的ui页面也是很不方便， swagger 也可以聚合在网关页面。 有开发过微服务的小伙伴应该体验过。当微服务模块多的情况下，每个模块都需要配置这样的一个类进行加载 swagger 。造成每个模块都存在大致一样的 SwaggerConfig ,极端的情况下，有些朋友复制其他模块的 SwaggerConfig 进行改造之后，发现仍然加载不出 swagger 的情况，造成明明是复制的，为何还加载不出，排查此bug极其费时间。 在此之上，可以构建出一个 swagger-starter 模块，只需要引用一个 jar ，加载一些特殊的配置，就可以快速地使用到 swagger 的部分功能了。 功能使用 添加依赖 ps: 实际version版本请使用最新版 最新版本: 点击查看最新新版本 <dependency> <groupId>com.purgeteam</groupId> <artifactId>swagger-spring-boot-starter<factId> <version>0.1.2.RELEASE<

【推荐】2019 Java 开发者跳槽指南.pdf(吐血整理) >>> 一、应用服务架构演进及微服务架构介绍 1.1 应用架构的演进历程 应用服务架构一直处于不断演进的过程中，上图通过对比5种比较主流的架构模式，展示应用架构的演进历程和变化。 单体架构（All in One）。在业务发展初期，为了快速落地应用，满足客户需求，一般会使用All in One的单体架构。单体架构的特点是：所有模块都耦合在一个进程里，系统完全封闭且很复杂，牵一发动全局。 竖井式架构（Vertical Application）。随着业务的增长，单体架构越来越臃肿，我们对系统做了垂直化的拆分，应用架构进入第二阶段即竖井式架构。竖井式架构，就是根据业务属性将一个大的单体拆分成一些不同的模块或子系统，子系统之间没有直接关联。竖井式架构依然存在紧耦合的问题，系统也是完全封闭的，且存在大量的重复代码拷贝及模块功能需大量重复造轮子的情况。 单体架构和竖井式架构都是围绕web容器打包及部署的架构模式，随着业务的快速发展，要求实现服务的快速迭代和快速交付，应用架构也由此演进为以服务为中心的架构模式。主流的面向服务的架构模式有：RPC架构、ESB中心化架构和微服务架构。 RPC架构。RPC架构在现在的应用系统中还是比较常见的架构模式，适用于高并发场景，性能比较好。Dubbo就是一个典型的RPC架构。RPC架构也存在一些问题