JAVA規則——開發篇

本文介紹的JAVA規則的說明分為3個主要層級，本篇拋棄了平時開發中很少遇到的情況，那些用得比較少的以後再進階篇裡面出現。並有六個有用的國際軟體開發重要注意的有關String的問題，遵守了這些規則可以提高程式的效率、使代碼又更好的可讀性等。
（1） 如果有JDBC串連沒有關掉的話，需要在"finally"方法中關掉
如果資料庫連接失敗或者是沒有釋放串連，看上去無關緊要。但是其他的使用者就需要用更長的時間等待串連，這樣資料庫利用效率就會下降。確保你的代碼在任何情況下，包括出錯或者程式異常終止的情況下都釋放資料庫連接。在"finally"方法中關掉串連，就可以確保這一點。
錯誤樣本：
try {
Statement stmt = con.createStatement();
} catch(SQLException e) {
e.printStackTrace();
}
正確樣本：
try {
Statement stmt = con.createStatement();
} finally {
if (con != null && !con.isClosed()) {
con.close();
}
}

（2） 盡量避免使用'Thread.resume ()', 'Thread.stop ()', 'Thread.suspend ()'和 'Runtime.runFinalizersOnExit ()' 方法。
這些方法在平時的開發或者是教科書裡面也有用到過，但是這些方法會導致四鎖的傾向。一下有充足的資料來說明為什麼不建議用上述方法。
參考：1."java.lang.Thread" in the JDK API documentation
2.http://java.sun.com/j2se/1.3/docs/guide/misc/threadPrimitiveDeprecation.html
3.Paul Hyde: "Java Thread Programming"
Sams, ISBN: 0-672-31585-8 pp. 270

（3） 在表示長整常量的時候，用L來代替l.
因為l很容易和1混一起。
錯誤樣本：
long temp = 23434l;
正確樣本：
long temp = 23434L;
參考：Ken Arnold, James Gosling: "The Java Programming Language Second Edition"Addison Wesley, 1997, pp.108

（4） 最好在jsp開頭寫一條注釋
在 jsp檔案頭上面寫一條注釋，這樣可以協助別人來理解你的代碼。這條規則不僅適用於jsp，更是用於任何開發的文檔。
正確樣本：<%-- JSP comment --%>

(5)明確的初始化一個構造類裡面的所有的欄位
因為沒有初始化的欄位會是一個潛在的bug，所以最好初始化類裡面的所有的欄位。特別是靜態欄位，最好在一開始就分配一個初始值
錯誤樣本：
public class CSI {
public CSI () {
this (12);
k = 0;
}

public CSI (int val) {
j = val;
}

private int i = 5;
private int j;
private int k;
}

正確樣本：
public class CSIFixed {
public CSIFixed () {
this (12);
}

public CSIFixed (int val) {
j = val;
k = 0;
}

private int i = 5;
private int j;
private int k;
}
參考：http://www.ambysoft.com/javaCodingStandards.pdf

（5） 國際化開發建議：邏輯操作符不要再一個單個的字元的前面或者後面
一個單個字元的前後不要用邏輯操作符，如果代碼要在一個國家環境中啟動並執行話。我們可以使用字元比較方法，這些方法使用統一字元比較標準來定義字元的屬性的。
錯誤樣本：public class CLO {
public boolean isLetter (char ch) {
boolean _isLetter = ( ch >= 'a' && ch <= 'z') //錯誤
|| (ch >= 'A' && ch <= 'Z');
return _isLetter;
}
}

正確樣本：
public class CLOFixed {
public boolean isLetter (char ch) {
boolean _isLetter = Character.isLetter(ch);
return _isLetter;
}
}
參考： http://java.sun.com/docs/books/tutorial/i18n/intro/checklist.html
更多的字元比較方法請參考：http://java.sun.com/docs/books/tutorial/i18n/text/charintro.html

（6） 國際化開發建議：不要對日期對象使用'Date.toString ()'
不要使用'Date.toString ()'方法，日期格式對於地區和語言不同的國家來說是不一樣的，務必不要使用。
錯誤樣本：'DateFormat'類提供了一個預定義的格式類型來指定本地的格式。
public void printToday () {
Date today = new Date ();
String todayStr = today.toString ();
System.out.println (todayStr);
}
正確樣本：
public void printToday () {
Locale currentLocale = Locale.getDefault ();
DateFormat dateFormatter = DateFormat.getDateInstance (
DateFormat.DEFAULT, currentLocale);
Date today = new Date ();
String todayStr = dateFormatter.format (today);
System.out.println (todayStr);
}
參考：http://java.sun.com/docs/books/tutorial/i18n/intro/checklist.html
http://java.sun.com/docs/books/tutorial/i18n/format/dateFormat.html

（7） 國際化開發建議：不要對數字變數使用'toString ()'方法
在全球化的開發中，不要對數字變數使用'toString ()'方法，對於java.lang.Number的任何子類都適用。包括：BigDecimal, BigInteger, Byte, Double, Float, Integer, Long, and Short.對於這樣的情況，java裡也與定義了"NumberFormat"方法來格式化。
錯誤樣本：
public class NTS {
public void method (Double amount) {
String amountStr = amount.toString ();
System.out.println (amountStr);
}
}
正確樣本：
public class NTSFixed {
public void method (Double amount) {
Locale currentLocale = Locale.getDefault ();
NumberFormat numberFormatter =
NumberFormat.getNumberInstance (currentLocale);
String amountStr = numberFormatter.format (amount); //
System.out.println (amountStr + ' ' + currentLocale.toString ());
}
}
參考：http://java.sun.com/docs/books/tutorial/i18n/intro/checklist.html
http://java.sun.com/docs/books/tutorial/i18n/format/numberFormat.html

（8） 國際化開發建議:不要使用'String.equals ()'方法
建議不要使用'String.equals ()'方法，因為在統一字元比較標準中不一定按照相關的順序來比較。'Collator'提供的預定義整理規則來排序string，Collator類調用'getInstance ()'方法，一般來說，可以為預設的本地建立一個Collator。例如：Collator myCollator = Collator.getInstance ();建立Collator的時候你也可以指定一個特殊的locale。例如：Collator myFrenchCollator = Collator.getInstance (Locale.FRENCH);然後就可以調用'Collator.compare ()'來執行一個本地的字元比較myCollator.compare (s1,s2);從這裡可以瞭解更多的有關Collator類的資訊：http://java.sun.com/docs/books/tutorial/i18n/text/collationintro.html

錯誤樣本：
public class SE {
public boolean compstr (String s1, String s2) {
boolean b = (s1.equals (s2));
return b;
}
}
正確樣本：
public class SEFixed {
public boolean compstr (String s1, String s2) {
Collator myCollator = Collator.getInstance ();
boolean b = (myCollator.compare(s1,s2) == 0);
return b;
}
}

參考：http://java.sun.com/docs/books/tutorial/i18n/intro/checklist.html
http://java.sun.com/docs/books/tutorial/i18n/text/locale.html

（9） 國際化開發建議：不要使用'StringTokenizer()'方法
錯誤樣本：StringTokenizer st = new StringTokenizer(str);
可以從這裡得到更多的資訊：‘
參考：http://java.sun.com/docs/books/tutorial/i18n/intro/checklist.html

（10） 國際化開發建議：不要使用'Time.toString ()'方法
因為時間的格式各個國家也不一樣。如果你使用日期格式類，你的應用就能夠在世界上各個地方正確的顯示時間和日期了。首先，用'getTimeInstance ()'方法建立一個formatter。然後，調用'format ()'方法。
錯誤樣本：
public class TTS {
public void printTime (Time t1) {
String timeStr = t1.toString ();
System.out.println (timeStr);
}
}
正確樣本：
import java.sql.Time;
import java.text.DateFormat;
import java.util.Locale;

public class TTSFixed {
public void printTime (Time t1) {
DateFormat timeFormatter = DateFormat.getTimeInstance(
DateFormat.DEFAULT, Locale.getDefault ());
String timeStr = timeFormatter.format(t1);
System.out.println (timeStr);
}
}