java开发的格式与书写规范

举报
小鲍侃java 发表于 2021/10/24 09:40:57 2021/10/24
【摘要】 ​在企业开发中,代码规范是非常重要的,博主在日常开发中,以阿里规范设计了一套基础的开发规范。本文将详细介绍。 1.idea设置注释与格式规范 1.安装插件安装idea插件–eclipse code formatter按住ctrl + alt + S 然后点击 plugins —marketplace —installed— ok 2添加配置文件下载好eclipse格式化文件 按住ctrl ...

​在企业开发中,代码规范是非常重要的,博主在日常开发中,以阿里规范设计了一套基础的开发规范。本文将详细介绍。

1.idea设置注释与格式规范

1.安装插件

  1. 安装idea插件–eclipse code formatter

  2. 按住ctrl + alt + S 然后点击 plugins —marketplace —installed— ok
    在这里插入图片描述

2添加配置文件

下载好eclipse格式化文件 按住ctrl + alt + S,重启后会发现出现eclipse code formatter 选项,点击进入 按照图片进行配置,路径选择文件夹内eclipse-codestyle文件。
在这里插入图片描述

注意:每次保存需要 ctrl+alt +l。

2.注释规范

ctrl + alt + S — file and code templates – includes —file header,然后填写下面代码。
在这里插入图片描述

/**
* 应用模块名称: 
* 代码描述: 
* Copyright: Copyright (C) ${YEAR}, Inc. All rights reserved.
* Company: 
* @author 
* @since ${DATE} ${TIME} 
*/

2.代码书写规范

  1. 入参必须使用对象或者List<VO>,非特殊情况下不允许使用jsonobject。

  2. service与dao层也尽量使用对象封装,减少参数罗列。

  3. 参数传递非必要情况不要使用map传递。

  4. 出参使用封装好的Result对象。

  5. 接口文档书写需要详细 。

  6. 在使用系统统一异常处理时 不需要使用try catch。

  7. 在特别需要时 需要向统一异常处理方法维护异常类别。
    在这里插入图片描述

  8. 需要加入类注释与方法注释 详细请参考新人项目搭建文档。

  9. 非特殊情况方式不允许使用@requstmapping。

  10. 实体类需要继承 BaseEntity。

  11. 尽量将同一业务的接口写到一个类中,通用方法抽取出来,并提交给组长,维护到文档中。

  12. 服务间调用请参考ribbon与feign。

  13. 使用格式化文档对代码格式化。

  14. 类上与接口路径都需要书写,且不要省略“/”。

  15. 类命名规范 分别为xxController,xxService,xxServiceImpl,xxDao,xxMapper。

  16. 方法命名规范:
    在这里插入图片描述

  17. 事务书写方式。
    在这里插入图片描述

  18. 失效代码尽量删除掉,而不是注释。

  19. 是否等可复用魔法值需要放入枚举类中 不要在代码中写死。

  20. 实体类需要写明各字段注释,可使用代码生成器生成 。

  21. 实体中除了设计到计算字段,其他一律使用封装类类型。

  22. 接口类型不需要public等关键字。

  23. mapper中需要写全jdbcType,可以使用代码生成器生成。

其他详细可以参考 阿里巴巴Java开发手册(华山版).pdf。

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息, 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。