譯文鏈接:http://www.codeceo.com/article/10-useful-paranoid-java-coding.html
英文原文:Top 10 Useful, Yet Paranoid, Java Programmer Techniques
譯者:碼農(nóng)網(wǎng)– 小峰
在沉浸于編碼一段時(shí)間以后(比如說(shuō)我已經(jīng)投入近20年左右的時(shí)間在程序上了)华糖,你會(huì)漸漸對(duì)這些東西習(xí)以為常麦向。因?yàn)槲谅悖阒赖摹魏问虑橛锌赡艹鲥e(cuò)客叉。
這就是為什么我們要采用“防御性編程”,即一些偏執(zhí)習(xí)慣的原因话告。下面是我個(gè)人認(rèn)為的 10 個(gè)最有用但偏執(zhí)的 Java 編程技術(shù)兼搏。一起來(lái)看一看吧:
- 將 String 字符串放在最前面
--
為了防止偶發(fā)性的NullPointerException
異常,我們通常將 String 放置在equals()
函數(shù)的左邊來(lái)實(shí)現(xiàn)字符串比較沙郭,如下代碼:
// Bad
if (variable.equals("literal")) { ... }
// Good
if ("literal".equals(variable)) { ... }
這是隨便用腦子想想就可以做的事佛呻,從 Bad 版本的代碼改寫表達(dá)式到 Good 版本的代碼,這中間并不會(huì)丟失任何東西病线。歡迎不同的觀點(diǎn)…
- 不要相信早期的 JDK API
--
在 Java 早期吓著,編程是一件非常痛苦的事情鲤嫡。那些 API 仍然很不成熟,也許你已經(jīng)碰到過(guò)下面的代碼塊:
String[] files = file.list();
// Watch out
if (files != null) {
for (int i = 0; i < files.length; i++) {
...
}
}
看上去很偏執(zhí)绑莺?也許吧暖眼,但請(qǐng)看 Javadoc:
如果這個(gè)虛擬路徑不表示一個(gè)文件夾目錄,則此方法返回 null廉嚼。否則將會(huì)返回一個(gè)字符串?dāng)?shù)組诅病,每一個(gè)字符串表示目錄中的文件或文件夾泄私。
對(duì),沒錯(cuò)栋豫。我們可以添加一些校驗(yàn):
if (file.isDirectory()) {
String[] files = file.list();
// Watch out
if (files != null) {
for (int i = 0; i < files.length; i++) {
...
}
}
}
- 不要相信“-1”
--
我知道這是偏執(zhí)的,但 Javadoc 中對(duì)String.indexOf()
方法明確指出:對(duì)象內(nèi)第一次出現(xiàn)指定字符的位置索引谚殊,如果為 -1 則表示該字符不在字符序列中丧鸯。
所以使用 -1 是理所當(dāng)然的,對(duì)嗎络凿?我說(shuō)不對(duì)骡送,請(qǐng)看以下代碼:
// Bad
if (string.indexOf(character) != -1) { ... }
// Good
if (string.indexOf(character) >= 0) { ... }
誰(shuí)知道呢。也許到時(shí)候他們改變了編碼方式絮记,對(duì)字符串并不區(qū)分大小寫摔踱,也許更好的方式是返回 -2?誰(shuí)知道呢怨愤。
- 避免意外賦值
--
是的派敷。這種事情也許經(jīng)常會(huì)發(fā)生。
// Ooops
if (variable = 5) { ... }
// Better (because causes an error)
if (5 = variable) { ... }
// Intent (remember. Paranoid JavaScript: ===)
if (5 === variable) { ... }
所以撰洗,你可以將比較常量放置在左側(cè)篮愉,這樣就不會(huì)發(fā)生意外賦值的錯(cuò)誤了。
- 檢查 Null 和 Length
--
無(wú)論如何差导,只要你有一個(gè)集合试躏、數(shù)組等,請(qǐng)確保它存在设褐,并且不為空颠蕴。
// Bad
if (array.length > 0) { ... }
// Good
if (array != null && array.length > 0) { ... }
你并不知道這些數(shù)組從哪里來(lái),也許是來(lái)自早期版本的 JDK API助析,誰(shuí)知道呢犀被。
- 所有的方法都是 final 的
--
你也許會(huì)告訴我你的開/閉原則,但這都是胡說(shuō)八道外冀。我不相信你(正確繼承我這個(gè)父類的所有子類)寡键,我也不相信我自己(不小心繼承我這個(gè)父類的所有子類)。所以對(duì)于那些意義明確的方法要嚴(yán)格用 final 標(biāo)識(shí)雪隧。
// Bad
public void boom() { ... }
// Good. Don't touch.
public final void dontTouch() { ... }
- 所有變量和參數(shù)都是 final
--
就像我說(shuō)的西轩。我不相信我自己(不要意外覆蓋我的值)员舵。話雖如此,我不相信我自己的是因?yàn)椤?/p>
…這就是為什么所有的變量和參數(shù)都是 final 的原因藕畔。
// Bad
void input(String importantMessage) {
String answer = "...";
answer = importantMessage = "LOL accident";
}
// Good
final void input(final String importantMessage) {
final String answer = "...";
}
- 重載時(shí)不要相信泛型
--
是固灵,它可以發(fā)生。你相信你寫的超級(jí)好看的 API劫流,它很直觀巫玻,隨之而來(lái)的,一些用戶誰(shuí)只是將原始類型轉(zhuǎn)換成 Object 類型祠汇,直到那該死的編譯器停止發(fā)牢騷仍秤,并且突然他們會(huì)鏈接錯(cuò)誤的方法,以為這是你的錯(cuò)誤可很。
看下面的代碼:
// 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) {
...
}
因?yàn)槭Γ阒馈愕挠脩粑铱伲麄兙拖?/p>
// This library sucks
@SuppressWarnings("all")
Object t = (Object) (List) Arrays.asList("abc");
bad(t);
相信我。這一切我都看到過(guò)菜拓。包括下面的
這種偏執(zhí)還是不錯(cuò)的。
- 總是在 Switch 語(yǔ)句的 Default 中拋出異常
--
Switch 語(yǔ)句……它們其中一個(gè)可笑的語(yǔ)句我不知道該對(duì)它敬畏還是哭泣俺夕,但無(wú)論如何,既然我們堅(jiān)持用 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");
}
當(dāng)value == 3
時(shí),將會(huì)出現(xiàn)無(wú)法找到的提示瞎颗,而不會(huì)讓人不知所謂。
- Switch 語(yǔ)句帶花括號(hào)
--
事實(shí)上言缤,switch 是最邪惡的語(yǔ)句禁灼,像是一些喝醉了或者賭輸了的人在寫代碼一樣,看下面的例子:
// 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 語(yǔ)句中弄捕,每一個(gè) case 語(yǔ)句的范圍只有一行語(yǔ)句导帝,事實(shí)上,這些 case 語(yǔ)句甚至不是真正的語(yǔ)句穿铆,他們就像 goto 語(yǔ)句中的跳轉(zhuǎn)標(biāo)記一樣您单。
結(jié)論
偏執(zhí)編程看起來(lái)似乎不可思議,有時(shí)荞雏,因?yàn)榇a經(jīng)常被證明是更詳細(xì)一點(diǎn)虐秦,但并不是需求需要。你可能會(huì)想凤优,“哦悦陋,這是絕不會(huì)發(fā)生的”,但正如我所說(shuō)筑辨。經(jīng)過(guò) 20 年左右的時(shí)間編程俺驶,你不希望只修復(fù)這些愚蠢的 bug,因?yàn)榫幊陶Z(yǔ)言是如此的陳舊的和有缺陷的棍辕。
現(xiàn)在到你了暮现!什么是你在編程最偏執(zhí)的怪癖?