开发规范
命名
- 配置文件及json属性的键名命名方式统一使用小驼峰。例如:userName、userAge。
- 包名全部小写,多个单词可用下划线。例如:user_info。
- 局部变量首字母小写,使用驼峰命名。名称要见名知义。例如:userName、userAge。
- 常量首字母使用大写,使用驼峰命名。例如:CofnigUserName、ConfigUserAge。
接口定义
在api目录中对接口进行定义,入参需要独立设置,不建议直接引用其它自定义包的类型。 与controller中的方法形成一个循环整体。需要与service的方法进行交互的时候,在controller中逐一转换。
接口命名
接口 | method | URL |
---|---|---|
查询列表 | GET | /api/v1/testDemo/list |
查询详情 | GET | /api/v1/testDemo/view |
新增 | POST | /api/v1/testDemo/add |
修改 | POST | /api/v1/testDemo/edit |
删除 | POST | /api/v1/testDemo/delete |
导出 | POST | /api/v1/testDemo/export |
参数与字典的使用
系统封装了参数管理、字典管理两个模块。在开发过程中,需要使用到参数或者字典的地方,可以直接调用接口获取到对应的值。 所有需要在运行过程中可以动态调整的可配项都要通过参数接口获取到对应的值。 系统中所有涉及到枚举类型的地方,都要采用字典来处理。