morris.js 其js代码如下，该怎么动态的更改这些数据呢？

哦哦哦哦哦哦哦是极度极度洗脑的一首歌《swagger》。歌曲《Swagger》，由网红歌手饭思思演唱。作词：Tomas coleman/Matthew coleman/郭德紫毅/李宗驰/杜钇樵/周淞莱；作曲：Tomas coleman/Matthew coleman/李宗驰/杜钇樵/周淞莱。制作协力/SP/OP：北京音尚律动文化传媒有限公司。于2020年10月10日，由讯飞音乐发行。《swagger》爆火起因：这首歌的原版歌曲歌名叫做《Swagger》，抖音上火起来的版本是莹酱翻唱的版本。最近的噢噢噢噢letmeseeyou得给得给歌真的是非常非常的火啊，真的是很魔性，而且网友们还给这首歌发明了一段舞蹈 Let me see you that get that get Let me see you bass bass。歌手简介：饭思思，出生于江西省 ，中国内地女歌手，YY直播金牌女艺人 。代表作品有《童话里》《外表》《最初的心动》《蜜雪冰城》。饭思思凭借其温柔的声线和甜美的嗓音在各个平台走红。以上部分内容参考：swagger(饭思思演唱歌曲) - 百度百科

在韩国swag表示很厉害的意思，也表达自己很有自信有风格。Swag：Swagger 的简写，字面意思“自大、骄傲”，和“strut”意思雷同。后来慢慢演变成了指代“酷、有腔调、有逼格”，什么酷什么就可以套上去用。“Swag”真正开始爆红全球则是在 2008 年，JayZ 联手T.I.、Lil Wayne 和 Kanye West 发布了一首超级热单“Swagga Like Us”(像我们一样有腔调)四位饶舌超巨一起登台格莱美演唱的视频也被视为最能诠释“Swag”含义的影像。侃爷在这首歌中开口第一句话就是“Mr. West is in the buildin" Swagger on a hundred thousand trillion”。Swag 被称为了 Hip-Hop 的年度最热门单词。各种歌手在歌词中提到swag这个词，如：美国歌手Jay-z, lil wayne,韩国歌手GD等。其实，swag是由你自身的信心，文化，风格，和风度带出的感觉。Swag的感觉可以让你总是保持昂首阔步的态度表现出"酷" "自信" "有型" "有自己的风格"的意思。再很多的新hip-hop mv里都有歌手用这个词吹嘘自己或标榜自己的团队。你也可以翻译成：牛逼，帅爆，地球人已经无法阻止他了，等多种语境。有一首歌曲 《turn my swag on 》，这歌名就比较内涵， 你可以翻译为“霸气外露”。一般黑人用得多，这词在黑人圈是褒义词，白人圈算中性词，看具体用法。Swagga是演化的用法，意为举手投足都很潇洒的人。看用的地方，你要是和比较年青的美国人聊swag这个词，人家会觉得没什么，并且很时尚。如果你跑去和一个中年白人说 man you got swag，人家可能会觉得你很没教养。所以看文化来使用。Swag原本在美语口语里有一个意思指促销赠品, 另一个意思指个人表现出来的感觉. 所以用swag来形容swag就是指 Swag [free stuff] that is actually swag [awesome] (很棒的免费赠品)。这个词通常用在时装秀, 受邀参加的人通常会拿到一袋礼物袋, 这袋子里面如果装的是些真正好的, 有价值, 令人兴奋的东西, 收到的人就会用swag swag来形容.。例句: "Jesus, if I had known that the swag was going to be swag swag, I would have gotten out of bed instead of catching up on Netflix!"翻译为 “天啊, 如果我早知道这礼物袋会这麼赞, 我就不会在家看Netflix的影片而不起床出门了!”此外，swag还有一个本身的意思：一束花。总之，swag on you 就是你很帅、酷、时尚、潮流。美国达人ASTRO不是也喜欢用这个词吗，rap完一首，落款一般都是swag,这时你可以把它翻译为“就是这么帅!”swag应该是比较new skool的作风，和old skool的感觉不太一样，就穿着来说可能更偏向于紧身，而不是宽松或巨大，混搭的元素会更多，配色上会选更弄骚的颜色，但每个人都希望自己与众不同。对于女孩来说swag应该是sexy中夹杂着那么一点坏坏的感觉。

不太确定你说的这个到底用的是哪首歌的伴奏，对于这个我们了解的也是不太多的了。

在实习接触第一个公司项目时，就已经见识过了项目中的Swagger注解。但对其并不了解，甚至是干什么的都不知道，今天对其学习了一下，在此简单记录一下Swagger在多Model项目中是如何整合使用的。 前后端分离开发模式中，api文档是最好的沟通方式。 Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。 1.及时性 (接口变更后，能够及时准确地通知相关前后端开发人员) 2.规范性 (并且保证接口的规范性，如接口的地址，请求方式，参数及响应格式和错误信息) 3.一致性 (接口信息一致，不会出现因开发人员拿到的文档版本不一致，而出现分歧) 4.可测性 (直接在接口文档上进行测试，以方便理解业务) 在日常写接口过程中，有些接口是无法直接在浏览器中进行测试，这时候我们就可以采用接口测试工具。 在我所了解的接口测试工具中，常用的应该就是postman和Swagger了。但是对于后端开发人员来说，更倾向于使用Swagger。 以我的多Model项目为例 在顶级父工程下创建common模块，并在其pom.xml文件中引入Swagger依赖 引入依赖后在common模块下再创建common_base模块并创建Swagger配置类 Swagger配置类： 这样Swagger大致就配置好了，接下来，就往接口模块进行引入。 在模块service模块引入service_base 在service的子模块——service_edu模块的启动类中添加 @ComponentScan 注解这样，我们便可以对功能接口通过Swagger进行测试了。 我们也可以进行一些自定义设置 1.启动你的项目 2.访问路径 http://localhost :你的端口号/swagger-ui.html 3.进行测试 这里我用查询讲师列表为例 以上就是使用Swagger进行接口测试整合方法的简单介绍。

用Swagger能够在后端写好接口后进行测试，测试过程非常方便。 Swagger 是一个用于生成、描述和调用 RESTful 接口的 Web 服务。通俗的来讲，Swagger 就是将项目中所有（想要暴露的）接口展现在页面上，并且可以进行接口调用和测试的服务。 Swagger 官网地址：https://swagger.io/ 从上述 Swagger 定义我们不难看出 Swagger 有以下 3 个重要的作用： swagger2是：http://localhost:8080/swagger-ui.html swagger3是：http://localhost:8080/swagger-ui/index.html 注意观察：swagger2的注解基本都是以API开头的，以此来判断注解是否为swagger2注解。同样,swagger3也有类似特性。 swagger2必须要引入springfox-swagger2、springfox-swagger-ui这两个依赖 lombok插件要引入lombok依赖 这样swagger就配置完成了，接下来是使用方式 在entity实体类上使用 在controller实体类上使用 访问地址 http://localhost:8080/swagger-ui.html 图示 输入内容后，点击try it out ，即可得到结果 swagger2使用起来非常方便，引入依赖，创建一个配置类就能直接用了，用postman还得手动创建每个访问链接，非常麻烦，swagger2算是挺方便了。 它与swagger2的差异在于 配置文件上添加的注解是@EnableOpenApi而swagger2是@EnableSwagger2 访问地址http://localhost:8080/swagger-ui/index.html 而swagger2是http://localhost:8080/swagger-ui.html pom引入的文件只有一个 springfox-boot-starter 而swagger2有两个springfox-swagger2 springfox-swagger-ui entity实体类 和swagger2对比没有变化 controller appication.properties 访问网址：http://localhost:8080/swagger-ui/index.html 可以看到,ui变大变好看了点

Swagger的作用1. Rest API文档的在线自动生成。2. 功能测试。3、Swagger 主要提供了几种开源工具，提供相应的功能Swagger Codegen: 通过Codegen 可以将描述文件生成html格式和cwiki形式的接口文档，同时也能生成多钟语言的服务端和客户端的代码。支持通过jar包，docker，node等方式在本地化执行生成。也可以在后面的Swagger Editor中在线生成。Swagger UI:提供了一个可视化的UI页面展示描述文件。接口的调用方、测试、项目经理等都可以在该页面中对相关接口进行查阅和做一些简单的接口请求。该项目支持在线导入描述文件和本地部署UI项目。Swagger Editor: 基于浏览器的编辑器，该编辑支持实时预览描述文件的更新效果。也提供了在线编辑器和本地部署编辑器两种方式。Swagger Inspector: 感觉和postman差不多，是一个可以对接口进行测试的在线版的postman。比在Swagger UI里面做接口请求，会返回更多的信息，也会保存你请求的实际请求参数等数据。Swagger Hub：集成了上面所有项目的各个功能，你可以以项目和版本为单位，将你的描述文件上传到Swagger Hub中。在Swagger Hub中可以完成上面项目的所有工作，需要注册账号，分免费版和收费版。学习编程知识，推荐来北京尚学堂，完备的师资资源以及科学的教学方式，带给你最好的学习体验。

小号sw21 尺寸20x 16.5x 10cm 中号sw27 尺寸27x 20x 13cm 折扣 比国内 便宜N多 coach swagger 15mini新款，尺寸：11*19*7cm可详聊

swag，网络流行词，形容一种有自信、有风格的状态，是hiphop圈常见的用来夸一个人很酷很厉害的意思。swag表示的意思是赃物、窗饰等，但是实际上综艺节目里面说的swag是来自于swagger这个单词，swagger表示趾高气扬地走、大摇大摆地走。swag最早用在说唱当中，swag就是swagger的缩写，是一种hiphop的潮范儿，很多人rap完就会加个swag，大致就是体现自己有自信、有风格的那种状态。可能和另外一句更为常见的英文“just do it”的含义比较接近。可以理解为自己最酷、最厉害、最6等等意思，是一个很明显的语气助词。英语单词“swag”的用法：当你用到dress with swag这个英语表达的时候，就表示你有敏锐的时尚感和对自己风格的自信。示例：You just gotta have swag and you gotta know who you are as a person.你得有范儿，要知道自己是谁。以上内容参考：百度百科-swag

Swagger词曲：Martin Schmidt演唱：AG高杰Verse:Got it all locked down and my style got swaggerDrop them beats and the girls like butterHits so fresh and its like no otherGirls wanna take me back home to their motherChicks so hot gonna make you stutterWent down south and I just got hotterGot more ass than a full time loverRoll ten deep be down for whateverChorus:Straight B to the A to the L L I NWe ballin ballinStraight S to the T to the Y L I NWe stylin stylinB to the A to the L L I NWe ballin ballinStraight S to the T to the Y L I NRap:DJ turn up the bass and let the beat kick inRock the microphone and let the fun beginLadies on the floor now come and shake that thingPeople at the door you gotta let them inShots of tequila bottle of XOTable full of honeys gotta freak them allThis is how we rollin when u roll with meStraight ballin fresh stylin is the way I beChorus:Straight B to the A to the L L I NWe ballin ballinStraight S to the T to the Y L I NWe stylin stylinB to the A to the L L I NWe ballin ballinStraight S to the T to the Y L I NBridge:You"re looking so damn hot girl everydayI dunno what to do everytime that I see u shake that thingYou"re so damn hot I cant help it but I gotta feel this wayGive it to me now girl come and bounce with me, bounce with me, bounce with me, bounce with meVerse:Got it all locked down and my style got swaggerDrop them beats and the girls like butterHits so fresh and its like no otherGirls wanna take me back home to their motherChicks so hot gonna make you stutterWent down south and I just got hotterGot more ass than a full time loverRoll ten deep be down for whateverChorus X2:Straight B to the A to the L L I NWe ballin ballinStraight S to the T to the Y L I NWe stylin stylinB to the A to the L L I NWe ballin ballinStraight S to the T to the Y L I Nhttp://music.baidu.com/song/20655144

报错信息： Unable to infer base url. This is common when using dynamic servlet registration or when the API is behind an API Gateway. The base url is the root of where all the swagger resources are served. For e.g. if the api is available at http://example.org/api/v2/api-docs then the base url is http://example.org/api/ . Please enter the location manually: 输入swagger地址时，跳出弹框的不允许测试。 解决办法： 1、可能启动类没有加@EnableSwagger2 2、清理浏览器缓存

可以发现只是存在了一个URLEncoding的设置，猜测原因可能是因为存在中文路径的问题。在把SwaggerConfig中的 接口声明中的最后一个参数修改成英文后，即使不加URLEncoding的设置也可以正常访问，所以可以确定就是中文路径引起的问题。在查询接口的时候，swagger的请求路径如下图： 如果group参数存在中文，而没有设置URLEncoding，那就会无法解析。 可以发现只是存在了一个URLEncoding的设置，猜测原因可能是因为存在中文路径的问题。在把SwaggerConfig中的 接口声明中的最后一个参数修改成英文后，即使不加URLEncoding的设置也可以正常访问，所以可以确定就是中文路径引起的问题。在查询接口的时候，swagger的请求路径如下图： 如果group参数存在中文，而没有设置URLEncoding，那就会无法解析。

Swagger2一些常用注解 最近遇到了一个使用swagger来生成接口文档的项目，在controller看到了一些没用过的注解（@API、@ApiOperation等），遂记录一下 @API 使用在类上，表明是swagger资源，@API拥有两个属性:value、tags，源码如下 //If tags is not used,this value will be used to set the tag for the operations described by this resource. Otherwise, the value will be ignored. String value() default ""; //Tags can be used for logical grouping of operations by resources or any other qualifier. String[] tags() default {""}; 1 2 3 4 5 生成的api文档会根据tags分类，直白的说就是这个controller中的所有接口生成的接口文档都会在tags这个list下；tags如果有多个值，会生成多个list，每个list都显示所有接口 @Api(tags = "列表1") @Api(tags = {"列表1","列表2"}) 1 2 value的作用类似tags,但是不能有多个值 @ApiOperation 使用于在方法上，表示一个http请求的操作 源码中属性太多，记几个比较常用 value用于方法描述 notes用于提示内容 tags可以重新分组（视情况而用） @ApiParam 使用在方法上或者参数上，字段说明；表示对参数的添加元数据（说明或是否必填等） name–参数名 value–参数说明 required–是否必填 @ApiModel() 使用在类上，表示对类进行说明，用于参数用实体类接收 value–表示对象名 description–描述 @ApiModelProperty() 使用在方法，字段上，表示对model属性的说明或者数据操作更改 value–字段说明 name–重写属性名字 dataType–重写属性类型 required–是否必填 example–举例说明 hidden–隐藏

版本不同导致上传改变了文件类型。因为Springfox-Swagger针对不同的版本，某些版本也会出现此问题，为一劳永逸，SwaggerBootstrapUi特别指定需要强指定dataType类型为MultipartFile。Swagger的目标是对RESTAPI定义一个标准且和语言无关的接口，可以让人和计算机拥有无须访问源码、文档或网络流量监测就可以发现和理解服务的能力。当通过Swagger进行正确定义，用户可以理解远程服务并使用最少实现逻辑与远程服务进行交互。与为底层编程所实现的接口类似，Swagger消除了调用服务时可能会有的猜测。

默认的swagger-ui好用但是不够美观，为了让生成的文档更加可观，我们可以使用swagger-ui-layer 来美化。 swagger-ui-layer，基于layui 开源的swagger-ui的替换。界面大气，使用起来也很方便。swagger-ui-layer 依于swagger的功能，所以在原先项目中导入以下依赖即可 注意： 使用规则： 一、在返回对象类上中要使用注解@ApiModel(value="实体类对象", description="实体类描述")，对象字段上使用@ApiModelProperty(value=”字段说明“,required=”是否必填”)表示对model属性的说明 注意：@ApiModel value 不能同名，否则会导致参数乱窜. 二、@API使用在Controller类上，表明是swagger资源 @Api(value = "仓库管理controller", tags = {"仓库管理接口"}) 三、在每个接口方法中使用注解@ApiOperation(value = “接口说明”, httpMethod = “接口请求方式”, response = “接口返回参数类型”, notes = “接口发布说明”)；表示一个http请求的操作 四、 @RequestBody和@ApiImplicitParam不能共用 @RequestBody主要用来接收前端传递给后端的json字符串中的数据的，如果想要swagger显示出实体类的参数描述信息要在实体类上使用@ApiModel(value="") 原先：在接口方法中会使用@ApiImplicitParam(name = "vo", value = "用户实体类", paramType = "body", required = true, dataType = "UserVo") 但@RequestBody和@ApiImplicitParam注解，会使实体类参数描述信息显示不出来，所以@ApiImplicitParam适用于没有接收实体类参数的方法 五、 @ApiParam 用于 Controller 中方法的参数说明。如图所示。 六、如果接口中，实体参数的描述没有显示出来可以加上@ModelAttribute 注解 七、通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中：URL 中的 {xxx} 占位符可以通过@PathVariable(“xxx“) 绑定到操作方法的入参中。在swagger接口文档中，不会显示出这个占位符的具体信息，如下不会显示出这个id的说明 建议使用@ApiParam注解： 也可以使用@ApiImplicitParam对接收的参数进行解释 注意： 要改成这样 八、在使用@RequestParam注解，获得前台传递的值，一般要结合@ApiParam注解使用

swagger 不同目录下的controller怎么设置会扫描配置的API文档格式自动生成一份json数据，而swagger官方也提供了ui来做通常的展示，当然也支持自定义ui的。不过对后端开发者来说，能用就可以了，官方就可以了。最强的是，不仅展示API，而且可以调用访问，只要输入参数既可以try it out.

pom文件加入如下依赖 启动类上加入@EnableSwagger2注解 增加配置类 访问http://localhost:8080/swagger-ui.html 取其中一个例子，示例返回以及要填的各种参数都已经帮你弄好了，直接填入参数就能测试，非常方便 导出文档 可以将测试页面导出为各种格式的文档，不再介绍 Swagger注解 可以用Swagger提供的注解，对显示在页面的上的各种参数进行描述，和代码耦合性比较高，不再演示 @Api：修饰整个类，描述Controller的作用 @ApiOperation：描述一个类的一个方法，或者说一个接口 @ApiParam：单个参数描述 @ApiModel：用对象来接收参数 @ApiProperty：用对象接收参数时，描述对象的一个字段 @ApiResponse：HTTP响应其中1个描述 @ApiResponses：HTTP响应整体描述 @ApiIgnore：使用该注解忽略这个API @ApiError ：发生错误返回的信息 @ApiImplicitParam：一个请求参数 @ApiImplicitParams：多个请求参数

只要是可以打印，就可以使用虚拟打印机来处理：方法一：使用虚拟打印机pdf factory即可，而且其他格式文件只要是能够打印，选择这个虚拟打印机，都可以做成PDF文件，很简单实用；方法二：用其他虚拟打印机转成PDF文件。方法三：使用专门的转换软件，把文件转成PDF文件。实在不能打印，还可以截屏嘛，然后按照下面的方法做出PDF的：方法一：使用虚拟打印机pdf factory即可，而且其他格式文件只要是能够打印，选择这个虚拟打印机，都可以做成PDF文件，很简单实用；方法二：使用FreePic2Pdf软件，进行批量转换；方法三：用其他虚拟打印机转成PDF文件。

一楼说的就是FineReport报表，这款报表工具确实支持多数据源的，而且挺好用，楼主可以下载一个试试。 Web报表工具FineReport提供了异构数据源模型，使得同一张报表中可以呈现来自多个不同类型的数据源，这个多种不同类型的数据源可以是同一数据库的多个不同表，或多个不同数据库，或者多种不同类型的数据源。可支持的数据源类型包括：1. 数据库数据源：包括Oracle，SqlServer，MySql,DB2,Sybase,Informix等主流的关系型数据库；支持SQL取数据表或视图，亦支持存储过程。2. 文本数据源：包括Excel文件，Txt文件等存储在文件中的数据。3. 程序数据源：支持程序数据源。4. 标准数据源：支持WebService，SOA标准数据等标准数据源。

这首歌叫《swagger》，前奏哦哦哦是抖音ID莹酱的，BGM背景音乐是溯（钢琴版）

首先我们来聊聊SpringBoot的版本，目前最新版本是 2.6.4 版本， 2.7.x 即将发布， 2.4.x 及以下版本已经停止维护了，目前的主流版本应该是 2.5.x 和 2.6.x 。具体可以看下下面这张表。 首先在 pom.xml 中修改SpringBoot的版本号，注意从 2.4.x 版本开始，SpringBoot就不再使用 .RELEASE 后缀了。 提到Swagger，我们一般在SpringBoot中集成的都是springfox给我们提供的工具库，看了下官网，该项目已经快两年没有发布新版本了。 再看下Maven仓库中的版本，依旧停留在之前的 3.0.0 版本。如果springfox再不出新版本的话，估计随着SpringBoot版本的更新，兼容性会越来越差的！ 今天带大家体验了一把SpringBoot升级 2.6.x 版本的过程，主要解决了循环依赖和Swagger无法使用的问题，希望对大家有所帮助！ 官网地址：https://github.com/springfox/springfox https://github.com/macrozheng/mall-learning/tree/master/mall-tiny-swagger2

大部分集成swagger项目，都是在项目中修改配置文件，新建swagger配置类。其实更合适的做法是新建一个swagger模块，需要加入swagger的模块只要引入这个模块就可以了。 关于如何新建一个swagger模块，可以参考以下的链接 本人做了如下修改，新建了SwaggerInfo类，去读取配置文件swagger.properties里的包扫描路径和title等一些需要定制化的数据，因为各个模块的属性是不一样的； SwaggerConfig: 会去swaggerInfo里拿包路径。 最后总结一下，扩展swagger模块的做法体现了软件设计原则中的开闭原则，对扩展开放，对修改关闭。在实践中或多或少会运用到一些设计原则，只是没意识到，还未上升到理论高度，逐渐积累中。

@ApiOperation(value = "分页查询用户", notes = "" + "部分机密的查询字段、返回字段需要另外申请授权； " + "【关键字段】提示（详见字段备注）： " + "1、判断用户是否失效，status; " + "2、获取用户所在组织，directDepartId;如果需要获取用户所在部门或系统，自行实现：根据部门全路径以及每个部门的级别判断 " + "【信息安全】提示： " + "1、用户邮箱、手机、教育、职级等个人敏感消息请勿泄露给普通用户 " + "此接口可提供的【功能示例】： " + "1、【根据多个工号查询用户】，必要参数usernames; " + "2、【根据部门查询用户】，必要参数departmentId（部门ID），不包含子组织 " + "其他1、【全量同步用户】，只用于初始化用户数据，先查出所有部门，再按部门查询用户 " + "其他2、【增量同步用户】，对接消息推送服务，对接文档：" ) @ApiImplicitParams(value = { @ApiImplicitParam(name = "pageIndex", value = "页码,默认1", paramType = "query", defaultValue = "1"), @ApiImplicitParam(name = "pageSize", value = "页大小,最大2000，默认10", paramType = "query", defaultValue = "10")})

vt. 吓唬；趾高气扬地行走或行事vi. 大摇大摆；吹牛；虚张声势吓人n. 大摇大摆；吹牛；威吓；下摆散开状的女式短大衣adj. 炫耀的；时髦的

http://dict.baidu.com/s?wd=swag

“哦哦哦哦哦哦”出自抖音歌曲《 Swagger》，这是一首英文歌曲，由P.W.W.演唱。

小号sw21 尺寸20x 16.5x 10cm 中号sw27 尺寸27x 20x 13cm 折扣 比国内 便宜N多 coach swagger 15mini新款，尺寸：11*19*7cm可详聊

哦哦哦哦哦哦哦是极度极度洗脑的一首歌《swagger》。歌曲《Swagger》，由网红歌手饭思思演唱。作词：Tomas coleman/Matthew coleman/郭德紫毅/李宗驰/杜钇樵/周淞莱；作曲：Tomas coleman/Matthew coleman/李宗驰/杜钇樵/周淞莱。制作协力/SP/OP：北京音尚律动文化传媒有限公司。于2020年10月10日，由讯飞音乐发行。《swagger》爆火起因：这首歌的原版歌曲歌名叫做《Swagger》，抖音上火起来的版本是莹酱翻唱的版本。最近的噢噢噢噢letmeseeyou得给得给歌真的是非常非常的火啊，真的是很魔性，而且网友们还给这首歌发明了一段舞蹈 Let me see you that get that get Let me see you bass bass。歌手简介：饭思思，出生于江西省 ，中国内地女歌手，YY直播金牌女艺人 。代表作品有《童话里》《外表》《最初的心动》《蜜雪冰城》。饭思思凭借其温柔的声线和甜美的嗓音在各个平台走红。以上部分内容参考：swagger(饭思思演唱歌曲) - 百度百科

配置pom后： 1、生成markdown、ASCIIDOC，执行mvn swagger2markup:convertSwagger2markup 2、生成 html 、pdf，执行1后，执行mvn generate-resources 3、pdf中文显示存在问题

Swagga -- 摇摆Swagga like us -- 像我们一样摇摆

哦哦哦哦哦哦哦是极度极度洗脑的一首歌《swagger》。歌曲《Swagger》，由网红歌手饭思思演唱。作词：Tomas coleman/Matthew coleman/郭德紫毅/李宗驰/杜钇樵/周淞莱；作曲：Tomas coleman/Matthew coleman/李宗驰/杜钇樵/周淞莱。制作协力/SP/OP：北京音尚律动文化传媒有限公司。于2020年10月10日，由讯飞音乐发行。《swagger》爆火起因：这首歌的原版歌曲歌名叫做《Swagger》，抖音上火起来的版本是莹酱翻唱的版本。最近的噢噢噢噢letmeseeyou得给得给歌真的是非常非常的火啊，真的是很魔性，而且网友们还给这首歌发明了一段舞蹈 Let me see you that get that get Let me see you bass bass。歌手简介：饭思思，出生于江西省 ，中国内地女歌手，YY直播金牌女艺人 。代表作品有《童话里》《外表》《最初的心动》《蜜雪冰城》。饭思思凭借其温柔的声线和甜美的嗓音在各个平台走红。以上部分内容参考：swagger(饭思思演唱歌曲) - 百度百科

json文件挂在到容器中 -p：宿主机端口：容器端口，将容器端口暴露给宿主机端口 -d:后台启动 -e：执行容器中/foo/swagger.json -v：将宿主机中/home/service/swagger/swagger.json挂载到容器 /foo中执行 输入：http://主机IP：端口

哦哦哦哦哦哦哦是极度极度洗脑的一首歌《swagger》。歌曲《Swagger》，由网红歌手饭思思演唱。作词：Tomas coleman/Matthew coleman/郭德紫毅/李宗驰/杜钇樵/周淞莱；作曲：Tomas coleman/Matthew coleman/李宗驰/杜钇樵/周淞莱。制作协力/SP/OP：北京音尚律动文化传媒有限公司。于2020年10月10日，由讯飞音乐发行。《swagger》爆火起因：这首歌的原版歌曲歌名叫做《Swagger》，抖音上火起来的版本是莹酱翻唱的版本。最近的噢噢噢噢letmeseeyou得给得给歌真的是非常非常的火啊，真的是很魔性，而且网友们还给这首歌发明了一段舞蹈 Let me see you that get that get Let me see you bass bass。歌手简介：饭思思，出生于江西省 ，中国内地女歌手，YY直播金牌女艺人 。代表作品有《童话里》《外表》《最初的心动》《蜜雪冰城》。饭思思凭借其温柔的声线和甜美的嗓音在各个平台走红。以上部分内容参考：swagger(饭思思演唱歌曲) - 百度百科

如果你有类似的疑问，这篇文章可以帮助你。 项目源码地址: github 出于稳定性考虑，在提测前不允许发布到测试环境，开发阶段如何保障swagger接口的稳定性？ 在安装了docker的机器，通过 run.sh 可以执行镜像build及容器运行。 Dockerfile 就是一个 nginx 服务，提供了http访问json的能力。 Dockerfile nginx.conf 中配置跨域操作 Access-Control-Allow-Origin * static 目录下是接口json文件 通过 http://localhost:8080/v2/api-docs 获取json文件，命名后push到git项目 api 目录下 浏览器访问swagger-ui服务，并在窗口输入json文件访问路径 https://localhost:8080/demo_api_2.json ，然后就可以看到swagger接口定义。 看了一下 swagger-ui 的镜像实现，内部也是一个nginx，运行js。所以没必要自己搞一套nginx，直接把json文件copy到 swagger-ui 即可。 更新后到swagger服务Dockerfile如下 关于 缺陷2 可以考虑使用 API_URLS 环境变量实现，但是设置后，不能自定义输入jsonUrl 效果图如下

springfox的大致原理就是，在项目启动的过种中，spring上下文在初始化的过程，框架自动跟据配置加载一些swagger相关的bean到当前的上下文中，并自动扫描系统中可能需要生成api文档那些类，并生成相应的信息缓存起来。如果项目MVC控制层用的是springMvc那么会自动扫描所有Controller类，跟据这些Controller类中的方法生成相应的api文档。

重命名 swagger: 2.0 openAPI: 3.0.0 Swagger 2.0 基础URL结构 OpenAPI 3.0 基础URL结构 我们可以定义一个基础url，通过{}里面装载变量值（类似于路径模版），在使用时，通过variables属性可以定义变量值，当然也可以给定默认值 Swagger 2中的definitions概念在OpenAPI 3中标准化为【组件】，可以在多个地方重复使用且可定义，组件列表如下： Swagger 2 Swagger 2最容易混淆的方面之一是body / formData。它们是参数的子集，只能有一个或另一个，如果你使用body，格式与参数的其余部分不同（只能使用body参数，名称不相关，格式不同，等等） OpenAPI 3 现在，body已经被移入了它自己的叫做requestBody的部分，并且formData也已经被合并到里面。另外，cookies已经被添加为参数类型（除了现有的标题，路径和查询选项之外）。 requestBody有很多新的功能。现在可以提供example（或数组examples）for requestBody。这是非常灵活的（你可以传入一个完整的例子，一个参考，甚至是一个URL的例子）。 新的requestBody支持不同的媒体类型（content是一个MIME_Types的数组，像application/json或者text/plain，当然你也可以用 / 捕捉所有）。 对于参数，你有两个选择你想如何定义它们。你可以定义一个“模式”（像原来2.0那样），可以尽情地描述项目。如果更复杂，可以使用“requestBody”中的“content”。 通配符的出现，我们可以以“4XX”来定义响应，而不必单独定义每个响应码。 响应和响应头可以更复杂。可以使用“content”对象（如在请求中）的有效载荷。 链接是OpenAPI 3最有趣的补充之一。它有点复杂，但可能非常强大。这基本上是描述“下一步是什么”的一种方式。 比方说，你得到一个用户，它有一个addressId。这addressId本身是无用的。您可以使用链接来展示如何“扩大”，并获得完整的地址。 在“/ users / {userId}”的响应中，我们找回了一个addressId。“链接”描述了如何通过引用“$ response.body＃/ addressId”来获取地址。 另一个用例是分页。如果要获取100个结果，links可以显示如何获得结果101-200。它是灵活的，这意味着它可以处理任何分页方案limits来cursors。 Swagger 2 OpeanAPI 3 一堆安全性的变化！它已被重命名，OAuth2流名已更新，您可以有多个流，并且支持OpenID Connect。“基本”类型已被重命名为“http”，现在安全可以有一个“方案”和“bearerFormat”。 飞机票至 Swagger 2 https://blog.readme.io/an-example-filled-guide-to-swagger-3-2/ https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#oasDocument https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#componentsObject

Github : https://github.com/ChaselX/springboot-swagger2-offline-api-doc Gitee : https://gitee.com/chasel96/springboot-swagger2-offline-api-doc 个人觉得 旧版的配置简单许多 ，新版的配置按照官方demo的配置来做还是复杂了很多 配置到Springboot项目中以后，在项目打包的时候便会通过单元测试在指定的目录生成被 官方 称为staticdocs的离线文档 该篇博文引用的依赖都要引入，Spring Rest Docs的依赖spring-restdocs-mockmvc，离线文档的依赖springfox-staticdocs，因为要在单元测试的时候生成文档，所以需要再加测试相关的spring-boot-starter-test。 asciidoctor-maven-plugin 插件会把Asciidoc格式文件转成HTML5格式输出。 这个类包含两个方法，TestApi()是用来生成例子，test()用来生成Asciidoc的文档。生成例子用到了spring-restdocs-mockmvc，每一个API都要进行单元测试才能生成相应的文档片段（snippets），生成的结果如图： 生成完整的Asciidoc文档用到了 Swagger2MarkupConverter ，第一步先获取在线版本的文档并保存到文件 swagger.json 中，第二步把 swagger.json 和之前的例子snippets整合并保存为Asciidoc格式的完整文档。生成结果如图： 通过配置类定义一些文档相关的信息 路径：项目名/docs/asciidoc/index.adoc 利用前面配置的maven插件，只需要执行打包就可以生成相应的文档，如图： 该篇博文引用的依赖都要引入，Spring Rest Docs的依赖spring-restdocs-mockmvc，离线文档的依赖springfox-staticdocs，因为要在单元测试的时候生成文档，所以需要再加测试相关的spring-boot-starter-test。 asciidoctor-maven-plugin 插件会把Asciidoc格式文件转成HTML5格式输出。 这个类包含两个方法，TestApi()是用来生成例子，createSpringfoxSwaggerJson()用来生成Asciidoc的文档。生成例子用到了spring-restdocs-mockmvc，每一个API都要进行单元测试才能生成相应的文档片段（snippets），生成的结果如图： 生成完整的Asciidoc文档用到了 Swagger2MarkupConverter ，第一步先获取在线版本的文档并保存到文件 swagger.json 中，第二步把 swagger.json 和之前的例子snippets整合并保存为Asciidoc格式的完整文档。生成结果如图： 通过配置类定义一些文档相关的信息 在resources目录下创建一个名为logback.xml的配置文件，使用LogstashEncoder作为Default Log Encoder 路径：项目名src/docs/asciidoc/index.adoc 利用前面配置的maven插件，只需要执行打包就可以生成相应的文档，如图：

一份好的接口文档能够让接口调用者很清晰的知道如何调用一个API接口，包括请求方式、传参规范、接口返回信息等；也能帮助团队新人快速了解业务。 传统的做法是由开发人员维护一个API接口文档，一般是一个word文档或一个提供接口文档管理的网站。这种做法有很多弊端：文档难以维护、浪费开人员时间、文档难以与接口保持一致等。 Swagger2的出现很好的解决了上述问题，可以实现接口文档实时在线生成，提供在线接口测试功能。唯一的弊端就是对接口程序有侵入，但本人认为还是利大于弊的。 接下来我们将Swagger2整合到springboot项目中，并用swagger-bootstrap-ui对Swagger2进行界面美化，废话不多说，我们开始。。。 在pom.xml中导入 在application.yml中设置swagger2是否开启的开关，关闭后接口文档被关闭，在生产环境部署时就需要关闭接口文档。 1.创建注解SwaggerCustomIgnore.java，主要用于忽略某些不想生成接口文档的接口。 2.创建配置类SpringfoxSwagger2Config.java，配置Swagger接口文档生成规则和过滤规则。 3.拦截器排除swagger相关资源，新建或修改WebConfig.java文件，内容如下。 1.编写内容参考如下 2.注解说明 启动项目，浏览器输入http://location:8081/doc.html,效果如下。

公司新项目使用了萧明大佬的swagger加强版， 地址： https://github.com/xiaoymin/swagger-bootstrap-ui/blob/master/README_zh.md 打开文档时遇到 java.lang.NumberFormatException: For input string: "" 的异常，原因是swagger文档上每个参数都会设定一个默认值，包装类型的默认值是""，所以会出现转换异常。 解决方案： 方案1：在@ApiModelProperty设定默认值 方案2：降低 springfox-swagger2 包中 swagger-annotations 和 swagger-models 的版本号

每个API接口描述和参数、请求方法都能在每个json数组中定制。下面是目前项目中使用到的部分预览图

http://blog.csdn.net/qq_33350186/article/details/70244705

在使用SpringBoot中配置Swagger2的时候，出现 Unable to infer base url. This is common when using dynamic servlet registration or when the API is behind an API Gateway. The base url is the root of where all the swagger resources are served. For e.g. if the api is available at http://example.org/api/v2/api-docs then the base url is http://example.org/api/ . Please enter the location manually: 引用来自 https://github.com/springfox/springfox/issues/1996#issuecomment-335155187 4.但是在我的项目中，发现是我使用Spring的ResponseBodyAdvice全局返回再处理的一个类，本意是为所有返回JSON数据统一添加“状态=succuess”等信息，没想到该实现影响了Swagger的使用，会导致swagger返回的JSON数据格式和期望的不一致，故swagger报错。解决方法在该接口实现类上面的@ControllerAdvice 注解限制接口的扫描包即可避免。 5.在排查该问题时，假设你的swagger-ui访问路径是 http://localhost:8080/swagger-ui.html， 可以先直接访问 http://localhost:8080/v2/api-docs， 查看swagger是否正确获取到了JSON格式的数据，且JSON格式数据是否为类似以下格式，如果不对则可能是因为别的返回预处理接口对数据进行了处理，导致swagger无法获取到正确的数据。

在项目开发过程中出现了swagger-bootstrap-ui 页面提示"请确保swagger资源接口正确",效果如下: 将example中的Json结构梳理正确，并在后续Swagger2相关参数的编写时，注意检查"{"、"["等有对Json结构产生干扰的字符串，或者不用。

对于集成Swagger（2.9.2版本，其他版本没有验证是否存在该问题），搭建Spring boot基本架构，请查看之前的文章，这里直接分析Swagger的bug SpringBoot+MyBatis搭建SSM基本骨架(Redis + Swagger+自定义配置 +mysql ) 之前测试一直用postman，直到打开 http://localhost:5088/swagger-ui.htm 才发现存在bug 一、异常分析： Illegal DefaultValue null for parameter type integer 和 NumberFormatException: For input string: "" 从上面这句可以看出，有个默认值是空字符串的变量转换成Integer类型时异常。 根据上面这句报错信息，点进去AbstractSerializableParameter.java:412可以看到 if(BaseIntegerProperty.TYPE.equals(type)){ } 就是说如果实体属性类型是Integer，就把example转为Long类型，而example默认为"",导致转换错误。 二、解决办法： 我们知道，在Swagger的浏览器界面打开的时候，对上述的默认值解析错误。一般情况下我们都省略了实体类上加@ApiModelProperty。因此解决这个问题可以在实体类中的Integer类型的属性添加注解，并给example参数赋值，且值必须为数字类型。 如果每个值都需要添加，那么会很多。 所以下面是第二种办法。我们知道报错的是at io.swagger.models.parameters.AbstractSerializableParameter.getExample(AbstractSerializableParameter.java:412) ~[swagger-models-1.5.20.jar:1.5.20] 查看pom.xml我们引用的是springfox的包，找到github项目# springfox / springfox issue查询swagger-models-1.5.20.jar，查看前面几天issue，可以发现有人已经给出了解决方案 比如 https://github.com/springfox/springfox/issues/2265

问题记录： 本例采用的swagger版本及相关组件 问题出现原因： 加入了Shiro后就出现了乱码，可能是在加入Shiro的时候编码选择错了，网上介绍的办法大多是在setting设置以及对tomcat的设置，但是还是不得，在先不探讨Shiro倒置的情况下，找到了如下的解决办法 在config类中，继承自WebMvcConfigurationSupport类，重写以下方法： 注意：不要直接在swagger配置类直接继承WebMvcConfigurationSupport，不然会出现 No mapping for GET /swagger-ui.html 的报错

Hope this helps. For Fields @ApiModelProperty(required = false, hidden = true) private String hiddenProperty For Apis @ApiIgnore public class MyApi {} For Parameters public void getApi(@ApiIgnore String param){} @ApiModelProperty(hidden="true") public String paramInsideClass

参考链接网页链接

"definitions": {"ownerNumer": {"type": "object","properties": {"status": {"type": "integer","format": "int64","description": "状态:0正常1异常"},"number": {"type": "integer","format": "int64","description": "用户数量"}}}},

swag就是swagger的缩写，是一种hiphop的潮范儿，也就是体现自己有自信、有风格的那种状态。很多人rap完就会加个swag，大致就是说：我就是这么有型有个性，大家high起来。。。

原因是连接到环境，但我们写的python脚本是在windows下的，Linux下的Python无法访问windows下的python脚本。连接环境不同，运行python脚本也是不同的，如果我们想直接在当前Pycharm下运行python脚本，需要将脚本上传到linux环境。发现pythonwindows运行正常，linux下异常，首先文件编辑后提示不认识的编码utf-8，应为linux系统默认的是中文gb18030，python文件中用的utf-8，修改成gb18030就OK了，这个问题解决了。

在你的application.properties中，可以配置。server.port = 8084server.servlet.context-path=/search注意springboot1,2有差别