Swagger中@API tags中含有中文异常问题的解决
目录
- Swagger @API tags中含有中文异常
- 重点
- 解决方法
- Swagger注解@Api(tags={中文})无法点击展开
- 升级swagger依赖为2.9.2+
Swagger @API tags中含有中文异常
最近在接触新项目中用到了swagger,之前公司同事不喜好使用swagger也没有在意。我个人比较偏好swagger 文档开发,喜欢使用中文在标注各个接口。
重点
当前项目使用的是 swagger2 2.6.1 版本,这个版本有一个异常的地方:
在@API 注解中的 tags 包含中文后会导致界面UI接口方法不能正常伸缩,必须点击外层的 Expand Operations 才能正常使用
解决方法
这里使用的解决方法比较粗暴,升级swagger 版本 更新至 2.9.2,工程中引入更高级的swagger版本信息。
在引入后,记得打开浏览器,清除浏览器缓存。
google 为例:
更新后的新版本界面,没有 Expand Operations这个一个按键了
Swagger注解@Api(tags={中文})无法点击展开
升级swagger依赖为2.9.2+
<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中@ApiIgnore注解的使用详解
目录 Swagger @ApiIgnore注解的使用 1.作用在类上时,整个类都会被忽略 2.当作用在方法上时,方法将被忽略 3.作用在参数上时,单个具体的参数会被忽略 4. 在实体类中忽略不需要字段的方式 Swagger中的常用注解 1.作用在类上时,整个类都会被忽略 2.当作用在方法上时,方法将被忽略 3.作用在参数上时,单个具体的参数会被忽略 Swagger @ApiIgnore注解的使用 @ApiIgnore 可以用在类.方法上,方法参数中,用来屏蔽某些接口或参数,使其不在页面上显示.
-
SpringBoot集成Swagger2实现Restful(类型转换错误解决办法)
pom.xml增加依赖包 <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.2.2</version> </dependency> <dependency> <groupId>io.springfox</groupId> <
-
浅谈springfox-swagger原理解析与使用过程中遇到的坑
swagger简介 swagger确实是个好东西,可以跟据业务代码自动生成相关的api接口文档,尤其用于restful风格中的项目,开发人员几乎可以不用专门去维护rest api,这个框架可以自动为你的业务代码生成restfut风格的api,而且还提供相应的测试界面,自动显示json格式的响应.大大方便了后台开发人员与前端的沟通与联调成本. springfox-swagger简介 签于swagger的强大功能,java开源界大牛spring框架迅速跟上,它充分利用自已的优势,把swagger集成
-
Swagger中@API tags中含有中文异常问题的解决
目录 Swagger @API tags中含有中文异常 重点 解决方法 Swagger注解@Api(tags={中文})无法点击展开 升级swagger依赖为2.9.2+ Swagger @API tags中含有中文异常 最近在接触新项目中用到了swagger,之前公司同事不喜好使用swagger也没有在意.我个人比较偏好swagger 文档开发,喜欢使用中文在标注各个接口. 重点 当前项目使用的是 swagger2 2.6.1 版本,这个版本有一个异常的地方: 在@API 注解中的
-
基于Linux系统中python matplotlib画图的中文显示问题的解决方法
最近想学习一些python数据分析的内容,就弄了个爬虫爬取了一些数据,并打算用Anaconda一套的工具(pandas, numpy, scipy, matplotlib, jupyter)等进行一些初步的数据挖掘和分析. 在使用matplotlib画图时,横坐标为中文,但是画出的条形图横坐标总是显示"框框",就去查资料解决.感觉这应该是个比较常见的问题,网上的中文资料也确实很多,但是没有任何一个彻底解决了我遇到的问题.零零碎碎用了快3个小时的时间,才终于搞定.特此分享,希望能帮到有同
-
Linux 中unzip解压时中文乱码的解决办法
Linux 中unzip解压时中文乱码的解决办法 当我们在linux中解压一个含有中文名字的压缩包如"资料.zip"时,如果直接使用如下的命令,将会出现中文乱码. unzip 资料.zip 主要的原因是因为unzip在解压的时候会将编码转化为其内部默认的编码,而默认的编码根本不支持中文CP936编码.因此我们需要在解压的时候明确的指定需要使用的编码. 目前可以采用如下两种方式解决 方法一 在解压的时候直接指定编码格式 #指定GBK GB18030编码也是可以的 unzip -O CP9
-
Python 爬虫之超链接 url中含有中文出错及解决办法
Python 爬虫之超链接 url中含有中文出错及解决办法 python3.5 爬虫错误: UnicodeEncodeError: 'ascii' codec can't encode characters 这个错误是由于超链接中含有中文引起的,超链接默认是用ascii编码的,所以不能直接出现中文,若要出现中文, 解决方法如下: import urllib from urllib.request import urlopen link="http://list.jd.com/list.html?
-
Thinkphp 在api开发中异常返回依然是html的解决方式
现在谁不开发接口的呢?但是在接口开发过程中,报错误异常后居然返回错误的信息依然是html信息!TP官方也不知道为啥不添加,说好的为接口而生,我的解决方案也很简单,把系统的异常处理类复制出来,去掉模板相关,直接以json方式输出 下面是解决方案: 1:按照TP扩展异常的方式引用这个文件 https://www.kancloud.cn/manual/thinkphp5_1/354092 // 判断默认输出类型 // $app 是配置数组 if ($app['default_return_type']
-
php中判断字符串是否全是中文或含有中文的实现代码
一,判断全是中文 复制代码 代码如下: $str="'324是"; if(!eregi("[^\x80-\xff]","$str")){ echo "全是中文"; }else{ echo "不是"; } 二,判断含有中文 复制代码 代码如下: $str = "中文"; if (preg_match("/[\x7f-\xff]/", $str)) { echo &quo
-
jquery.ajax的url中传递中文乱码问题的解决方法
JQuery JQuery默认的contentType:application/x-www-form-urlencoded 这才是JQuery正在乱码的原因,在未指定字符集的时候,是使用ISO-8859-1 ISO8859-1,通常叫做Latin-1.Latin-1包括了书写所有西方欧洲语言不可缺少的附加字符. JQuery的Ajax根本没有考虑到国际化的问题,使用了欧洲的字符集,所以才引起了传递中文出现乱码的问题. 而我们的UTF-8则可以解决这一问题. 最终指需要修改JQuery的代码,显式
-
Yii2 RESTful中api的使用及开发实例详解
什么是RESTful风格的API 对于各种客户端设备与服务端的通信,我们往往都通过API为客户端提供数据,提供某种资源.关于RESTful的概念,一查一大推,一两句也解释不清,姑且先按照我们通俗的理解:在众多风格.众多原则的API中,RESTful就是一套比较优秀的接口调用方式. Yii2如何实现RESTful风格的API 1.建立单独的应用程序 为了增加程序的可维护性,易操作性,我们选择新建一套应用程序,这也是为了和前台应用.后台应用区分开操作.有些人要嚷嚷了,为啥非得单独搞一套呢?如果你就单
-
swagger配置正式环境中不可访问的问题
目录 swagger配置正式环境中不可访问 如何在生产环境中禁止swagger了? 以下是正式环境访问 swagger无法打开的说明 总结了以下几个解决方案 swagger配置正式环境中不可访问 Swagger是我们常用的API Doc工具,非常便于开发人员调试,后台和前端开发人员协作,以及对外公布API使用. 如何在生产环境中禁止swagger了? @Profile("beta") // 只允许在测试服务器访问Swagger package com.demo.swagger; imp
-
PHP 中 DOMDocument保存xml时中文出现乱码问题的解决方案
php中DOMDocument对于xml操作我们只要是英文是没有问题了,但如果是中文字体就会有乱码问题了,下面我们就此问题给各位介绍一些解决办法吧. PHP的DOM内部是utf8机制的,在loadHTML时,是通过检查字符中meta的charset来设置编码的,如果没有charset,就当iso8859进行处理了,而这种情况下进行saveXML时,输出来的却是utf8,所以就看到乱码了. 这么说是不是还不太理解,举个例子: $xml = new DOMDocument(); @$xml->loa
随机推荐
- AngularJS入门教程中SQL实例详解
- JavaScript和jquery获取父级元素、子级元素、兄弟元素的方法
- perl写的一个随机编故事的程序(rand随机函数)
- Java经验点滴:类注释文档编写方法
- js+FSO遍历文件夹下文件并显示
- 写的不错批处理教程一
- 使用PHP把HTML生成PDF文件的几个开源项目介绍
- Mysql Error Code : 1436 Thread stack overrun
- 基于Jquery的表格隔行换色,移动换色,点击换色插件
- jQuery 插件 将this下的div轮番显示
- 浏览器窗口大小变化时使用resize事件对框架不起作用的解决方法
- Firefox getBoxObjectFor getBoundingClientRect联系
- 获取DOM对象的几种扩展及简写
- 计算字符串和文件MD5值的小例子
- php商品对比功能代码分享
- Android自定义扇形倒计时实例代码
- Spring中的事务隔离级别的介绍
- Spark在Windows下的环境搭建方法
- 通过实例讲解springboot整合WebSocket
- MySQL Community Server压缩包安装配置方法