From 1204787cf3ad79ca35d0d5cbe7e630ce8a1ca711 Mon Sep 17 00:00:00 2001 From: zhuoda Date: Wed, 19 May 2021 10:48:01 +0800 Subject: [PATCH] =?UTF-8?q?update=20=E4=BB=A3=E7=A0=81=E8=A7=84=E8=8C=83/a?= =?UTF-8?q?pi=E6=8E=A5=E5=8F=A3=E8=A7=84=E8=8C=83.md.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 代码规范/api接口规范.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/代码规范/api接口规范.md b/代码规范/api接口规范.md index e94c8d3c..044b17dd 100644 --- a/代码规范/api接口规范.md +++ b/代码规范/api接口规范.md @@ -1,4 +1,4 @@ -#### Restful接口规范 +### Restful接口规范 1、不推荐使用 rest 命名 url, 只能使用 get/post 方法。url 命名上规范如下:虽然 Rest 大法好,但是有时并不能一眼根据 url看出来是什么操作。 url 格式为: @@ -12,7 +12,7 @@ POST /department/add 添加部门 POST /department/update 更新部门 GET /department/delete/{id} 删除部门 ``` -#### controller 里接口 swagger 规范 +### controller 里接口 swagger 规范 1、controller每个方法必须添加 swagger 文档注解 @ApiOperation ,并填写接口描述信息,描述最后必须加上作者信息 @author 哪吒 比如: ```java @@ -23,7 +23,7 @@ GET /department/delete/{id} 删除部门 } ``` -#### controller 里 传入和返回 JavaBean 规范 +### controller 里 传入和返回 JavaBean 规范 1、类中的每个字段添加注释 2、对于枚举值的类型,要清楚标注清楚可能的值,以及每个值表示什么含义 比如: