JAVA接口开发规范
1、 实现规范
a) 接口应功能单一，并能正确相应
b) 建议使用restful方式来实现
c) 不要返回null值
d) 服务已https对外提供，符合安全规范
e) 接口编码尽量统一使用UTF-8
f) 接口参数的校验
2、 代码规范
a) 规范的类名、方法名、变量名等
i. 类名使用 UpperCamelCase 风格，遵从驼峰形式
ii. 方法名、参数名、成员变量、局部变量都统一使用 lowerCamelCase 风格，遵从驼峰形式,首字母小写
iii. 常量命名全部大写，单词间用下划线隔开
b) 有效完整的代码注释
c) 尽量使用post形式接受参数
d) 统一使用json格式返回响应数据
e) 使用统一的接口相应数据结构：调用状态码status、状态信息msg、自定义数据data
f) 有效的日志记录
3、 文档完善
a) 确保文档的唯一性
b) 文档内容要丰富标准
i. 接口名称、版本
ii. 用途、调用场景、授权
iii. 开发语言、编码、协议、签名等
iv. 接口示例、参数说明、返回值说明
JAVA接口开发规范
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
- 文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
- 文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
- 文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
