如何让编码更加的标准

简介:

1.概述

  在写这片博文时,我也是思绪良久,参考了不同语言的编码风格,最后总结出如何让自己的编码更加标准。

2.基础

  以Java的基础为例子来说明:

  • 文件编码格式为UTF-8
  • package需要置于最顶层
  • import包时,使用eclipse的快捷键(command+1)倒入对应的包(这样我们可以不用考虑包的顺序如何排列)
  • 格式化代码采用eclipse的快捷键(command+shift+f)进行格式代码
  • if,else,for,while等语句,必须加上大括号({}),即使语句为空
  • 代码块缩进,采用2个空格
  • 列限制在120个字符,对于超过120个字符的语句或方法建议重构(这样方便阅读,及代码的美观性)
  • tab键默认采用4个字符的长度

3.规范

  在编写代码时,需要注意一下规范:

  在进行逻辑判断时,else语句必须添加,即使,else语句为空,也得添加在if语句后面

复制代码
 1 public void getAppDetail(App app){
 2   
 3     if(app != null){
 4        // 业务逻辑处理
 5     }else{
 6        // 若没有业务逻辑处理,此处也需要加上,可以打印一条log
 7        log.info("App object is null");
 8     }  
 9     
10 }
复制代码

  在书写switch语句时,default需要加上,即使它什么代码也不包含

复制代码
switch(index){
    case 1:
              //  调用逻辑方法
              break;
    case 2:
              //  调用逻辑方法
              break;
    default:
              //  不涉及任务业务,打印日志信息
              log.info("Index is undefined");
              break;
}
复制代码

  在进行代码块注释的时候,需要注意,但行可以使用 /* ... */,也可以使用 // ... 。对于多行的 /* ... */注释,必须从 * 开始,并且与前一行的 * 对其。以下为范例:

复制代码
// 当行注释

/* 当行注释 */

/*
 * 多行
 * 注释
 */
复制代码

  关于命名约定可以参考,如何让命名变得优雅

  在书写try ... catch语句时,建议catch语句中只设计输出日志信息(或者将异常抛出),不涵盖业务逻辑处理。

复制代码
try{
    // 业务逻辑处理
    ......    
}catch(Exception e){
    // 打印对应的异常信息
    log.error(String.format("Error message is %s",e));    
}

try{
    // 业务逻辑处理
    ......    
}catch(Exception e){
    // 抛出对应的异常信息
    throw new Exception();  
}
复制代码

4.总结

  冰冻三尺非一日之寒,要养成好的风格也非一朝一夕能完成,这需要我们自己在平时编码的时候去注意这些细节,并且严格的要求自己。亡羊补牢,为时不晚,特写此博文,与君共勉。

联系方式: 
邮箱:smartloli.org@gmail.com 
Twitter: https://twitter.com/smartloli 
QQ群(Hadoop - 交流社区1): 424769183 
温馨提示:请大家加群的时候写上加群理由(姓名+公司/学校),方便管理员审核,谢谢! 

热爱生活,享受编程,与君共勉!



本文转自哥不是小萝莉博客园博客,原文链接:http://www.cnblogs.com/smartloli/,如需转载请自行联系原作者

相关文章
|
6月前
|
JavaScript 数据安全/隐私保护
41 # 编码的问题
41 # 编码的问题
33 0
|
5月前
|
数据可视化 数据管理 数据处理
编码集的作用?
编码集的作用?
|
9月前
|
SQL IDE Java
如何高效编码? 使用有意义的命名
编码中随处可见命名。我们给变量、函数、参数、类和包命名;我们jar文件命名。我们命名,命名,不断命名,既然有怎么多命名要做,不妨就做好它。
|
7月前
|
XML JSON 算法
Unicode 14 标准发布
Unicode 14 标准发布
41 0
|
JavaScript
编码
编码
68 0
数制与编码
十进制整数转换为二进制数 可以将十进制数逐次用2除,取余数,一直到商为0.然后把全部余数按相反的次序排列起来。(除二取余)
254 0
数制与编码
|
数据格式
网络标准之:IANA定义的传输编码
网络标准之:IANA定义的传输编码
网络标准之:IANA定义的传输编码
|
存储 安全 索引
计算机编码规则之:Base64编码
计算机编码规则之:Base64编码
|
机器学习/深度学习 算法 索引
关于Onehot编码的总结
关于Onehot编码的总结
529 0
关于Onehot编码的总结
|
Web App开发 JavaScript 前端开发