文章目录 将swagger API导出为HTML或者PDF 什么是Asciidoc swagger2markup-maven-plugin asciidoctor-maven-plugin 使用命令行 PDF的中文展示 PDF中文主题在maven中的使用 将swagger API导出为HTML或者PDF 现在有很多项目都是使用的swagger,将API直接写在swagger文档中,使用起来非常方便,并且支持在线调试.但是它不方便对外提供,这里我们找到了一种方法,可以方便的将swagger API…

问题描述:通过Swagger接口导出Excel模板文件时,报错:URL.createObjectURL: Argument 1 is not valid for any of the 1-argument overloads. 问题现象: 解决方案: 1.打开浏览器调试窗口,将请求复制为cURL命令 火狐浏览器: 谷歌浏览器: 2.将cURL命令粘贴到命令行窗口中,在命令最后加上" -o test.xlsx ",将文件下载到当前目录.( test.xlsx 为自定义的文件名称 ) 3.…

一丶前言 最近刚接触到Swagger,在github上下载了它的源码和demo学习了一遍,发现这个组件非常好用,不过不足的是它没有导出离线文档的功能,于是乎我就想给它加一个导出功能 Swagger Github开源地址 二丶思路 其实说白了api文档就是一个html静态页面,html可以转word或者pdf,那问题就变简单了. 1.想办法拿到swagger生成的api接口json数据. 2.将json转化为html. 3.将html转换成word或者pdf等文件. 三丶实现 1.首先我们要解决第…

swagger-export是一个提供swagger文档导出功能的服务,不依赖于具体的API接口服务实现,你可以很方便地导出html和pdf两种格式的静态文档.源码来自swagger导出静态API文档工具,做了一些修改,以符合实际的项目需要. 一.在src下配置asciidoc 二.pom.xml 也就是maven插件 <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http:…

场景: 前几天项目验收,赶了一整天补API接口设计文档,给爷整吐了.周末的时候就想能不能直接把swagger的json文件导出成word? 顺便学习一下NPOI的使用. 实现思路: 1.先把swaager.json中的文件进行json反序列化,解析成对象. 2.用NPOI进行word的创建和内容的编写. 结果: 做了两三天,最后结果可以正常解析swaager版本为3.0的json文件,然后导出word,word内容如图: 优点:导出的word有标题段落关系,格式清晰:把swaager.json中…

下面所用工具下载   http://editor.swagger.io/#/  demo   一.安装 swagger editor   说明:安装swagger前需要安装node工具   工具安装 1. node 下载地址:http://nodejs.cn/     根据自己的需要下载版本即可,本人电脑是: win7 64bit,所以下载后的文件是:node-v10.13.0-x64.msi (双击安装即可,没啥特殊的,不再说明)     测试node工具是否安装成功?打开cmd终端   C:…

序言 API经济生态链已经在全球范围覆盖, 绝大多数企业都已经走在数字化转型的道路上,API成为企业连接业务的核心载体, 并产生巨大的盈利空间.快速增长的API规模以及调用量,使得企业IT在架构上.模式上面临着更多的挑战.关于如何承载现有快速发展的API生态链,本文接下来介绍API网关在其中扮演的角色. API是什么 应用编程接口(Application Programming Interface,简称:API),就是软件系统不同组成部分衔接的约定[维基百科].简单的例子: 您每次登陆微信, 需…

导读:本文中,阿里云高级技术专家高磊(花名:埃兰)将聚焦API网关加速能力聚合与生态集成,讲述API如何实现系统间的衔接和API网关的产品升级进程,重点展示了一些新功能.新体验和新变化. 大家下午好,我是来自阿里云API网关团队的,我今天给大家介绍一下API网关在加速能够聚合与生态集成方面的一些话题,并且发布一下API网关近期产品的一些进展. 刚才郑刚已经讲过了, SLK是为了企业实现上云,上云是为了实现能力化,能力化下一步要拥抱API经济,在拥抱API经济的过程当中我们是离不开API网关这一个…

Swagger 导出API 这算是在博客园的第一篇博客吧,之后发的应该也会同步到博客园上. 此前的博客地址: https://blog.mytyiluo.cn Swagger简介 Swagger是一个开源软件框架,可帮助开发人员设计,构建,记录和使用RESTful Web服务. 其中,Swagger可以生成一个交互式的API控制台,以便于快速测试API. 从个人角度讲,Swagger对于前后端分离的小团队来说是非常有帮助的.尤其是像我们这种平时没写文档习惯的人来说,Swagger能根据代码自动生…

C#中缓存的使用   缓存的概念及优缺点在这里就不多做介绍,主要介绍一下使用的方法. 1.在ASP.NET中页面缓存的使用方法简单,只需要在aspx页的顶部加上一句声明即可:  <%@ OutputCache Duration="100" VaryByParam="none" %> Duration:缓存时间(秒为单位),必填属性 2.使用微软自带的类库System.Web.Caching 新手接触的话不建议直接使用微软提供的类库,因为这样对理解不够深刻…