== 代码贡献 欢迎各路英雄好汉参与KCloud-Platform-IoT代码贡献,期待您的加入!Fork本仓库 新建 feat_xxx_环境_时间(如 feat_laokou_dev_20230116) 分支提交代码,新建Pull Request!我觉得没问题就会合并到主干分支,你也就成为正式贡献者啦! == RESTFul代码风格 - url路径名词均为复数 - 响应结果必须使用JSON - url结尾不应该包含斜杠'/' - API必须有版本的概念,v1,v2,v3 - url中大小写不敏感,不要出现大写字母 - 使用-而不是使用_做URL路径中字符串连接(脊柱命名法) - 使用Token令牌来做用户身份的校验与权限分级,而不是Cookie - 使用动词表示增删改查, GET查询,POST新增,PUT更新,DELETE删除 - HTTP状态码,在REST中都有特定的意义:200,201,202,204,400,401,403,500。比如401表示用户身份认证失败,403表示没有操作资源的权限 == 提交规范 - fix => 【名称】修改bug - test => 【名称】添加或修改测试用例 - feat => 【名称】新功能(feature) - docs => 【名称】文档(documentation) - chore => 【名称】构建过程或辅助工具的变动 - style => 【名称】格式(不影响代码运行的改动) - refactor => 【名称】重构(即不是新增功能,也不是修改bug的代码变动) - build => 【名称】构建系统或者包依赖更新 - revert => 【名称】回滚代码 - ci => 【名称】脚本文件配置 == 代码规范 https://koushenhai.github.io/pages/d29eab[COLA代码规范] == 测试用例 - 测试用例的类名必须以Test结尾 - 测试用例的方法名必须test_{方法名}_{场景}_{期望结果}命名 - 强制使用 `org.assertj.core.api.Assertions` 断言,禁止使用 `org.junit.jupiter.api.Assertions` 断言