java.util.Preferences

JDK1.4为我们提供的java.util.prefs包，里面有一个Preferences类，能让以上的工作变得极其轻松!
写VB程序的人常常用SaveSetting函数和getSettging来存取注册表中的用户设定数据。而Java的Preferences类也提供了类似的机制。
Preferences类在不同的平台中有不同的实现方式。而在Windows平台中，Preferences是将数据保存在注册表中的，而在其它平台中的实现我就不得而知了(我对Linux等系统都不太了解).
但不管怎样，都是通过相同的接口来使用的，程序作者可以不管实现细节。

建立Preferences对象
为了区分不同的应用程序的参数项，在建立Preferences时要指定一个节点路径。
Preferences是一个抽象类，提供了一系列静态方法和抽象方法来操作参数项:
抽象方法:
Preferences userData = Preferences.userNodeForPackage(this);
Preferences sysData = Preferences.systemNodeForPackage(this);
这两个方法是从指定的物件所在的包(package)返回一个节点路径，如this是javax.swing.JComponent,则返回/javax/swing
静态方法:
Preferences userData = Preferences.userRoot().node("/com/sunway/spc");
Preferences sysData = Preferences.systemRoot().node("/com/sunway/spc");

以上每种方式提供了两套操作方法。其中一套是用户参数项，另一套是系统参数项。
在Windows平台中，用户参数项在注册表中的根节点是
HKEY_CURRENT_USER\Software\JavaSoft\Prefs
系统参数项在注册表中的根节点是
HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Prefs
而我们指定的节点路径是位于这些根节点之下的.

如何读写数据
Preferences提供了多种类型数据的读写方法。
先来看写(put)的方法,
put(String key, String value)
putBoolean(String key, boolean value)
putByteArray(String key, byte value[])
putDouble(String key, double value)
putFloat(String key, float value)
putInt(String key, int value)
putLong(String key, long value)
下面的是读(get)的方法,
get(String key, String default)
getBoolean(String key, boolean default)
getByteArray(String key, byte default[])
getDouble(String key, double default)
getFloat(String key, float default)
getInt(String key, int default)
getLong(String key, long default)
注意，每一种get方法的第二个参数需要我们为它指定缺省的参数。
除了以上方式之外，Preferences还允许我们将它的数据导出到一个XML文件保存，
void exportNode(OutputStream os)
void exportSubtree(OutputStream os)
我们可以导出一个节点，或是导出整个子节点树.

 

不多说,直接贴出源代码(代码中有详细的注释):

package com.lixing.util;

import java.io.File;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.util.prefs.BackingStoreException;
import java.util.prefs.Preferences;

/**
* Preferences有两种保存文件的方式:
* 1. sysRoot 与系统有关的用户配置文件,此文件只要是系统用户都可以访问
* 2. userRoot 与用户有关的用户配置文件,只有该用户才可以访问
* 但两者的操作方法完全一样
*
* @author Administrator
*
*/
public class PreferencesTest {
private String[] keys = { "userName", "userPwd", "userEmail" };
private String[] values = { "Lixing", "123456", "[e-mail]" };

/**
* 设置Preferences的值
* @param userRoot
*/
private void setPreference(Preferences userRoot) {
for (int i = 0; i < keys.length; i++) {
userRoot.put(keys[i], values[i]);
}

}

/**
* 获得Preferences的指定值
* @param userRoot
*/
private void getPreference(Preferences userRoot){
System.out.println( "userName: " + userRoot.get("userName", "佚名") );
System.out.println( "userPwd: " + userRoot.get("userPwd", "0000") );
System.out.println( "userEmail: " + userRoot.get("userEmail", "[e-mail]") );
}

/**
* 移除Preferences的首层包
* @param userRoot
*/
private void removeNode(Preferences userRoot){
try {
userRoot.removeNode();
} catch (BackingStoreException e) {
e.printStackTrace();
}
System.out.println( "removeNode success" );
}

/**
* 以树型结构导出为XML
* @param userRoot
*/
private void exportSubTree(Preferences userRoot) {
OutputStream os = null;
File file =new File("preferences.xml");
try {
os = new FileOutputStream( file );
userRoot.exportSubtree(os);
} catch (FileNotFoundException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
} catch (BackingStoreException e) {
e.printStackTrace();
} finally {
try {
os.close();
} catch (IOException e) {
e.printStackTrace();
}
}
System.out.println( "export tree success filename " + file.getName() );
}



public static void main(String[] args) {
PreferencesTest test = new PreferencesTest();

//以包的方式建立用户配置,目的就是防止冲突,便于管理
Preferences userRoot = Preferences.userNodeForPackage(PreferencesTest.class);
test.setPreference(userRoot);
test.exportSubTree(userRoot);
test.getPreference(userRoot);
test.removeNode(userRoot);
}
}