问题分析：

今天在使用swagger注解接口，编写文档的时候，发现了一个大问题：如何在让swagger文档识别带下划线（_）的属性名？如：

{"account_name": "nspd1","password": "zg=="
}

问题现象：

查看了网上资料发现，并没有该问题的解决方法，有的都是在说如何解决Map数据类型的子属性注解问题。

于是我就开始自己尝试：

1.当我使用网上大神么的创建新注解的方法时注解Map数据类型的对象时，确实可以解决这个问题：

当也有很大局限性，固定的Map格式注解，是不适用于其他数据模型的情况的，例如：像下面这种（嵌套Map）数据模型，就很复杂，我在网上没有找到这种数据模型的注解实现方法：

{"reply": {"code": 1000,"msg": "成功"},"result": {"user_id": ""}
}

2.然后自己也是刚接触swagger不久，没有怎么了解过深层逻辑代码，所以只能使用最基本但也是最简单的方法，就是利用把实体类注解 @ApiModel 和 实体类属性注解 @ApiModelProperty，即可实现；

3.回到最开始的问题：如何在让swagger文档识别带下划线（_）的属性名？

我试过把实体类的属性从正规的小驼峰，改为下划线格式，但还是不行，swagger文档还是识别成了小驼峰格式

后来通过思考，终于想起来一个经常忘记的知识点：从上面的尝试中，可以知道，对属性名格式的识别其实和属性名无关，至此我终于想起来是和getter、setter方法有关，

于是修改了setter/getter 方法之后终于可以了；

解决方法：

1.先把属性名修改为带下划线的格式，

2.在IDEA中可以按快捷键 alt + Insert 快速生成getter/setter方法即可

注意：其实带下划线是不符合前后端数据交互和开发规范的，但由于本项目是老旧的项目，所以也是挺无奈的，这里还是建议尽量不要使用下划线。

swagger学习日记4 文档无法识别下划线属性名相关推荐

赛效：WPS如何给文档内容添加下划线
在文档中,给文本内容加下划线是非常有必要的.下划线用于强调内容,比如在标题.重要段落或关键词中加上下划线,以强调文本中的重要部分.下划线的样式和颜色也是可以设置的,从某种程度上来说,还起到了美化文档的 ...
WPS文档设置空格下划线
Spring Boot 集成 Swagger 生成 RESTful API 文档
原文链接: Spring Boot 集成 Swagger 生成 RESTful API 文档简介 Swagger 官网是这么描述它的:The Best APIs are Built with Swa ...
文档扫描识别——基于M-LSD线段检测的拍照文档校正
前言 1.拍照文档扫描识别是办公类App里面最常用到的的一类应用,市面上有很多相关的App,及主要技术点有几个要用到图像处理,有边缘检测校正,文档滤镜,和OCR. 2.关于边缘文档连续检测,有用传统算 ...
【学习日记】手写数字识别及神经网络基本模型
2021.10.7 [学习日记]手写数字识别及神经网络基本模型 1 概述张量(tensor)是数字的容器,是矩阵向任意维度的推广,其维度称为轴(axis).深度学习的本质是对张量做各种运算处理,其分 ...
Swagger UI教程 API 文档神器搭配Node使用
一.node.js的安装运行环境必须使用node.js,把其作为服务器来跑, 安装教程二.swagger的安装教程对上面的图片进行进行讲解,教程博客中大部分都讲清楚了,所以我这里就不说了,在我 ...
软件工程学习管理系统需求分析文档
软件工程学习管理系统需求分析文档 [摘要] 学生学习管理系统是学生管理的一个重要组成部分,也是学校管理的组成部分.尤其是在信息技术高度发达的今天,利用信息技术实现高效的校园学习管理有着巨大的实用价 ...
（二）MkDocs学习笔记——撰写文档
mkdocs学习笔记系列 (一)MkDocs 学习--快速开始 (二)MkDocs学习笔记--撰写文档 (三)MkDocs学习--配置主题 (四)MkDocs学习--自定义主题 (五)MkDocs学习 ...
swagger自动创建接口文档用法
现在的开发大部分都是前后端分离的模式了,后端提供接口,前端调用接口.后端提供了接口,需要对接口进行测试,之前都是使用浏览器开发者工具,或者写单元测试,再或者直接使用Postman,但是现在这些都已经o ...

swagger学习日记4 文档无法识别下划线属性名

问题分析：

问题现象：

3.回到最开始的问题：如何在让swagger文档识别带下划线（_）的属性名？

解决方法：

swagger学习日记4 文档无法识别下划线属性名相关推荐

最新文章

热门文章