System Properties

Java針對系統的一些設定提供了取得的管道，但怎用並不是這篇的重點。重點是這些property的用途與注意事項，以下整理的是之前我所遇到的問題與使用經驗。

對於不曉得怎麼使用的同協們，我還是做了簡單說明。我們可以透過以下程式碼dump出所有的system properties:

Set<Entry<Object,Object>> sysPropEntrySet = System.getProperties().entrySet();
 
for( Entry<Object,Object> sysPropEntry : sysPropEntrySet ){
	System.out.println(sysPropEntry.getKey() + ":" + sysPropEntry.getValue());
}

結果會像這個樣子:

java.runtime.name:Java(TM) SE Runtime Environment
sun.boot.library.path:C:\Program Files\Java\jdk1.6.0_21\jre\bin
java.vm.version:17.0-b17
java.vm.vendor:Sun Microsystems Inc.
java.vendor.url:http://java.sun.com/
path.separator:;
java.vm.name:Java HotSpot(TM) 64-Bit Server VM
file.encoding.pkg:sun.io
...

如果只想取得對應的設定要透過getProperty:

String version = System.getProperty("os.version");
System.out.println(version);

結果如下:

java.version:1.6.0_21

os.name即作業系統名稱，os.version即版本，「用於功能會根據不同系統甚至版本而做不同處理時」。最常使用情況是用來辨別Linux或Windows:

String osName = System.getProperty("os.name").toLowerCase();
 
if(osName.indexOf("windows") != -1){
	// do something for windows
} else if(osName.indexOf("linux") != -1){
	// do something for linux
} else {
	// do something for other os
}

也可能根據不同版本的Windows去做處理。實作上有人會使用os.name去判斷，有人會使用os.version去判斷。以org.apache.commons.lang.SystemUtils而言，是兩者交互使用去判斷不同版本的Windows。首先以os.name去判斷不同版本的Windows為例:

String osName = System.getProperty("os.name").toLowerCase();
if( osName.startsWith("windows 7") ){
	// do something for win7
} else if(osName.startsWith("windows vista")){
	// do something for vista
}

我這裡點到為止，Windows版本非常多，在網上都可以找到範例程式碼去滿足你的需求。我要補充的是: 不管在Java6或Java7，都曾出現過取os.name的bug，不要以為自己code寫完就沒事情了，還要小心JRE版本。最近也有試過用JRE6去取得Windows 8的os.name，取出來卻是Windows NT! 所以，有另外一種選擇就是判斷os.version。

假設需求是在Vista之後的版本就執行某個操作，為此我實作了getWindowsMajorVersion的method，讓我可以確認os.version中的major version必須大於6。版本對照表可以參考Reference 1。

public static int getWindowsMajorVersion(){
	if( !isWindows() ){
		return -1;
	}
 
	String osVersion = System.getProperty("os.version");
	int dotIndex = osVersion.indexOf(".");
	String majorVersionStr = osVersion;
	if( dotIndex != -1 ){
		majorVersionStr = osVersion.substring(0, dotIndex);
	}
	try {
		return Integer.valueOf(majorVersionStr);
	} catch( NumberFormatException e ){
		return -1;
	}
}

要使用os.name還是os.version就看個人了。

別以為它們是用來判斷作業系統是32還是64位元，os.arch與sun.arch.data.model是根據JRE版本的! 這兩個屬性我會使用在「JNA判斷要Load的Library版本」。參考之前寫的JNA範例:

Native.loadLibrary( Platform.is64Bit() ? "JNADLLBugx64" : "JNADLLBugWin32",
                    CJNADLLBug.class);

JNA的Platform.is64Bit()內就是判斷sun.arch.data.model是否為64，os.arch是否為x86_64、ppc64、amd64或sparcv9，去決定JVM是32位元還是64位元。如果要抓到系統是否為64位元，可以參考這篇-如何在Ant中辨別OS是使用32位元還是64位元?。

這兩個屬性在我遇到亂碼問題後才知道它的價值。在Windows上，區域與語言設定的格式影響file.encoding屬性:

系統管理影響sun.jnu.encoding:

這兩個屬性到底有什麼用途呢? 以InputStreamReader為例，它的建構元其實可以指定你所要使用的讀取編碼Charset，而Charset的預設值由file.encoding決定。假設file.encoding與sun.jnu.encoding是不同的編碼: 中文與日文，當你透過Runtime的exec執行了一個外部程式，接著透過InputStreamReader讀取Process的InputStream，我相信你可能會讀到亂碼! 解決方法可以透過指定sun.jnu.encoding的編碼以讀取正確的結果:

Process p = Runtime.getRuntime().exec("date /t");
InputStreamReader isReader = new InputStreamReader(p.getInputStream(), 
	Charset.forName(System.getProperty("sun.jnu.encoding")));

你也可以透過-Dfile.encoding=去指定預設編碼，但你怎麼知道user到底會用什麼編碼呢? System.out.println也會受到file.encoding影響的，PrintStream物件是你可以選擇的解決方式。Linux的部分可以參考Refernce的Java Platform Encoding，實作就大同小異了。

我目前能分享的屬性就以上這幾個，有些像separator淺顯易懂的我就不贅述了，希望能幫上大家。 如果知道其它使用方式的高手們，也希望能分享給我喔!

友藏內心獨白: 一個能夠支援多個作業系統、32與64位元，還有多國語言的軟體，是很困難滴~

1. Windows version number list
2. Java6 JavaDoc
3. Java Platform Encoding

---