QShop商城-开发规范

时间:2024-05-31 12:10:50
  • 后端所有类名,方法,命名空间、类型、枚举类型、枚举值、事件、属性、常量 双峰命名:ListByWhere  所有参数、变量 单峰命名:fileName ),私有属性前缀一致以下划线+单峰命名法 如 :_fileName
  • 前端js 命名可以依照vscode变量规范,变量必须是有意义的单词,除循环变量for(var i=0)外不允许单字母命名(比如:d)
  • 单表列表查询方法名统一使用ListByWhere 分页查询统一使用SearchByWhere,单表内新增为Add 修改为Update 新增或修改AddOrUpdate ,根据ID查询单条记录为GetModel
  • 类名,方法必须以方法头注释方式注释方法用途,及传入参数注释.
  • 所有类不应超过500行 ,方法不应该超过40行最多60行 超过请拆分方法和类(一个方法只完成一个任务。不要把多个任务组合到一个方法中,即使那些任务非常小,超过60行肯定有问题)
  • 所有方法传入参数不允许超过5个,如超过5个请新建实体类至ViewModel层,以对象形式传递,实体类内属性必须属性注释(请严格执行,此处会带来一定工作量)
  • 除for循环的循环条件外所有变量以及参数等不允许出现无意义参数名,以及不常用简写
  • 凡符合下表所列的集合类型,应添加相应的前缀,以product为例

    Arrary arrProduct

    List listProduct

    DataTable/HashTable tbProduct

    Dictionary dicProcudct

  • 相关文章