10 个实用的但偏执的 Java 编程技术

译文链接:http://www.codeceo.com/article/10-useful-paranoid-java-coding.html
英文原文:Top 10 Useful, Yet Paranoid, Java Programmer Techniques
译者:码农网– 小峰

在沉浸于编码一段时间以后(比如说我已经投入近20年左右的时间在程序上了),你会渐渐对这些东西习以为常。因为,你知道的……任何事情有可能出错。

这就是为什么我们要采用“防御性编程”,即一些偏执习惯的原因。下面是我个人认为的 10 个最有用但偏执的 Java 编程技术。一起来看一看吧:

  1. 将 String 字符串放在最前面
    --

为了防止偶发性的NullPointerException异常,我们通常将 String 放置在equals()函数的左边来实现字符串比较,如下代码:

// Bad
if (variable.equals("literal")) { ... }
// Good
if ("literal".equals(variable)) { ... }

这是随便用脑子想想就可以做的事,从 Bad 版本的代码改写表达式到 Good 版本的代码,这中间并不会丢失任何东西。欢迎不同的观点…

  1. 不要相信早期的 JDK API
    --

在 Java 早期,编程是一件非常痛苦的事情。那些 API 仍然很不成熟,也许你已经碰到过下面的代码块:

String[] files = file.list();
// Watch out
if (files != null) {
    for (int i = 0; i < files.length; i++) {
        ...
    }
}

看上去很偏执?也许吧,但请看 Javadoc:

如果这个虚拟路径不表示一个文件夹目录,则此方法返回 null。否则将会返回一个字符串数组,每一个字符串表示目录中的文件或文件夹。

对,没错。我们可以添加一些校验:

if (file.isDirectory()) {
    String[] files = file.list();
    // Watch out
    if (files != null) {
        for (int i = 0; i < files.length; i++) {
            ...
        }
    }
}
  1. 不要相信“-1”
    --

我知道这是偏执的,但 Javadoc 中对String.indexOf()方法明确指出:对象内第一次出现指定字符的位置索引,如果为 -1 则表示该字符不在字符序列中。

所以使用 -1 是理所当然的,对吗?我说不对,请看以下代码:

// Bad
if (string.indexOf(character) != -1) { ... }
// Good
if (string.indexOf(character) >= 0) { ... }

谁知道呢。也许到时候他们改变了编码方式,对字符串并不区分大小写,也许更好的方式是返回 -2?谁知道呢。

  1. 避免意外赋值
    --

是的。这种事情也许经常会发生。

// Ooops
if (variable = 5) { ... }
// Better (because causes an error)
if (5 = variable) { ... }
// Intent (remember. Paranoid JavaScript: ===)
if (5 === variable) { ... }

所以,你可以将比较常量放置在左侧,这样就不会发生意外赋值的错误了。

  1. 检查 Null 和 Length
    --

无论如何,只要你有一个集合、数组等,请确保它存在,并且不为空。

// Bad
if (array.length > 0) { ... }
// Good
if (array != null && array.length > 0) { ... }

你并不知道这些数组从哪里来,也许是来自早期版本的 JDK API,谁知道呢。

  1. 所有的方法都是 final 的
    --

你也许会告诉我你的开/闭原则,但这都是胡说八道。我不相信你(正确继承我这个父类的所有子类),我也不相信我自己(不小心继承我这个父类的所有子类)。所以对于那些意义明确的方法要严格用 final 标识。

// Bad
public void boom() { ... }
// Good. Don't touch.
public final void dontTouch() { ... }
  1. 所有变量和参数都是 final
    --

就像我说的。我不相信我自己(不要意外覆盖我的值)。话虽如此,我不相信我自己的是因为…

…这就是为什么所有的变量和参数都是 final 的原因。

// Bad
void input(String importantMessage) {
    String answer = "...";
    answer = importantMessage = "LOL accident";
}
// Good
final void input(final String importantMessage) {
    final String answer = "...";
}
  1. 重载时不要相信泛型
    --

是,它可以发生。你相信你写的超级好看的 API,它很直观,随之而来的,一些用户谁只是将原始类型转换成 Object 类型,直到那该死的编译器停止发牢骚,并且突然他们会链接错误的方法,以为这是你的错误。

看下面的代码:

// Bad
<T> void bad(T value) {
    bad(Collections.singletonList(value));
}
<T> void bad(List<T> values) {
    ...
}
// Good
final <T> void good(final T value) {
    if (value instanceof List)
        good((List<?>) value);
    else
        good(Collections.singletonList(value));
}
final <T> void good(final List<T> values) {
    ...
}

因为,你知道……你的用户,他们就像

// This library sucks
@SuppressWarnings("all")
Object t = (Object) (List) Arrays.asList("abc");
bad(t);

相信我。这一切我都看到过。包括下面的

这种偏执还是不错的。

  1. 总是在 Switch 语句的 Default 中抛出异常
    --

Switch 语句……它们其中一个可笑的语句我不知道该对它敬畏还是哭泣,但无论如何,既然我们坚持用 switch,那我们不妨将它用得完美,看下面的代码:

// Bad
switch (value) {
    case 1: foo(); break;
    case 2: bar(); break;
}
// Good
switch (value) {
    case 1: foo(); break;
    case 2: bar(); break;
    default:
        throw new ThreadDeath("That'll teach them");
}

value == 3时,将会出现无法找到的提示,而不会让人不知所谓。

  1. Switch 语句带花括号
    --

事实上,switch 是最邪恶的语句,像是一些喝醉了或者赌输了的人在写代码一样,看下面的例子:

// Bad, doesn't compile
switch (value) {
    case 1: int j = 1; break;
    case 2: int j = 2; break;
}
// Good
switch (value) {
    case 1: {
        final int j = 1;
        break;
    }
    case 2: {
        final int j = 2;
        break;
    }
    // Remember:
    default: 
        throw new ThreadDeath("That'll teach them");
}

在 switch 语句中,每一个 case 语句的范围只有一行语句,事实上,这些 case 语句甚至不是真正的语句,他们就像 goto 语句中的跳转标记一样。

结论

偏执编程看起来似乎不可思议,有时,因为代码经常被证明是更详细一点,但并不是需求需要。你可能会想,“哦,这是绝不会发生的”,但正如我所说。经过 20 年左右的时间编程,你不希望只修复这些愚蠢的 bug,因为编程语言是如此的陈旧的和有缺陷的。

现在到你了!什么是你在编程最偏执的怪癖?

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,560评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,104评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,297评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,869评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,275评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,563评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,833评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,543评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,245评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,512评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,011评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,359评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,006评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,062评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,825评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,590评论 2 273
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,501评论 2 268

推荐阅读更多精彩内容

  • 背景: 阅读新闻 10个实用的但偏执的Java编程技术 [日期:2015-08-31] 来源:码农网 作者:小峰 ...
    伏残828阅读 231评论 0 0
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,293评论 18 399
  • 经过一段时间的编码(咦,我已经经历了将近20年的编程生涯,快乐的日子总是过得很快),我们开始感谢那些好习惯。因为,...
    南屋阿米佛头阅读 369评论 0 1
  • (柏梁体) 天幕尚且未见光, 悉悉索索离绣床。 轻描淡抹雍容妆, 左挑右捡白领裳。 离家来到交通场, 朝霞满天道路...
    金明啊阅读 212评论 0 0
  • 每年我的生日,只有一个人记得,那就是我妈。 从小到大,时间越来越快,却没有过过一个所谓的“生日”,今年,也是如此。...
    柒梦为马阅读 966评论 7 5