java 之 注册表操作篇

使用Preferences API    参考资料

        Preferences的误解：
         首先要指明的是：Preferences API并不是为访问Windows注册表而设计的。

        我们之所以会有上面的误解是由于Sun的Windows版本的JDK在实现Preferences API时使用了Windows注册表作为存储库，即我们用Preferences API存储的数据会保存到Windows注册表中，这样Preferenes API也就有了访问Windows注册表的能力。但是换到其它的平台或其它厂商的JDK实现又会怎么样呢？这个问题是和Preferences API的实现相关的，我们没有办法回答。

        Preferences适用的条件：
              如果程序不关心存储库的细节，只是要找一个存放数据的地方，那么Preferences API很合适。

        Preferences API的局限：
        一个Java软件，这次我在Sun的JDK上运行并使用Preferences API保存了我的个人喜好，下次我在IBM的JDK上运行，这时我的个人喜好还可以通过Preferences API得到吗？可能可以也可能不可以，这时的行为是由Sun和IBM的Preferences API实现决定的。（在相同的JDK实现上可以使用Preferences API来在不同的程序间共享数据）
        一个Java软件需要让用户设置是否和操作系统一起启动，类似的需求还很多。这类需求就是要求Java程序有真正的和相关操作系统协同的能力。这种能力不是Preferences API的设计目标。

使用JNI  参考资料
        Windows操作系统提供了操作注册表的API，因此用JNI将Java和这些API连接起来我们就获得了用Java操作注册表的能力。这说起来有些简单，实现起来却需要处理大量的细节。幸运的是这样的工作已经有人做了，我们要感谢他们。下面我们就来看看其中的一个包。

         com.ice.jni.registry包是通过JNI(Java native interface)实现的Windows注册表操作API，可以用来访问、修改和导出Windows注册表。现在这个包已经公开了，可以放心的使用而不必担心license的问题，并且包括一个构建好的DLL和Java、C的源代码。它可以在Java 1.1和更高的版本上工作。



下面详细的描述一下这个包中的类，数量不是很多：

• HexNumberFormat 用来格式化和分析十六进制整数。
• RegBinaryValue 表示类型为REG_BINARY的注册表值。REG_BINARY是指任意形式的二进制数。
• RegDWordValue 表示类型为REG_DWORD的注册表值。REG_DWORD是指一个32位的整数。根据该整数的字节序不同又分为REG_DWORD_LITTLE_ENDIAN和REG_DWORD_BIG_ENDIAN。在Windows中REG_DWORD和REG_DWORD_LITTLE_ENDIAN有相同的含义。
• RegistryValue 表示任意类型的注册表值，这是一个抽象类，不能被实例化。
• RegMultiStringValue 表示类型为REG_MULTI_SZ的注册表值。REG_MULTI_SZ是一个null-terminated的字符串的序列。
• RegStringValue 表示类型为REG_SZ和REG_EXPAND_SZ的注册表值。REG_SZ是指一个null-terminated的字符串，REG_EXPAND_SZ是指一个含有未展开的环境变量的null-terminated的字符串。
• Registry 这个类定义了定级项(Key)，包括HKEY_CLASSES_ROOT、HKEY_CURRENT_CONFIG、HKEY_CURRENT_USER、HKEY_DYN_DATA、HKEY_LOCAL_MACHINE、HKEY_PERFORMANCE_DATA和HKEY_USERS。还定义了错误代码，这些错误代码会包含在RegistryException中。最后是一些工具方法，如dumpHexData、exportRegistryKey、getErrorMessage、getTopLevelKey、openSubkey、parseArgumentString、parseArgumentVector、splitString和usage。
• RegistryKey 定义了注册表的一个表项(Key)和相关的一些操作。

RegistryKey的方法概要：

方法	简短描述
void closeKey()	关闭该subkey。
RegistryKey connectRegistry(java.lang.String hostName)	连接远程主机hostName的注册表。
RegistryKey createSubKey(java.lang.String subkey, java.lang.String className)	创建和打开该key的subkey，具有写权限。
RegistryKey createSubKey(java.lang.String subKey, java.lang.String className, int access)	创建和打开该key的subkey，具有指定的权限。
int decrDoubleWord(java.lang.String valueName)	该方法将消减REG_DWORD的值。
void deleteSubKey(java.lang.String subKey)	删除该subkey。
void deleteValue(java.lang.String valueName)	删除一个命名的值。
static java.lang.String expandEnvStrings(java.lang.String exString)	展开exString中的环境变量。
void export(java.io.PrintWriter out, boolean descend)	导出key。
void finalize()	重载了的finalize()方法，确保能够关闭key。
void flushKey()	确保这个key被写到磁盘，对性能有一定的影响。
java.lang.String getDefaultValue()	得到该key的默认值。
java.lang.String getFullName()	得到key的全名。
int getMaxSubkeyLength()	得到所有subkey名称的最大长度。
int getMaxValueDataLength()	得到所有subkey值的最大长度。
int getMaxValueNameLength()	得到所有值的名称的最大长度。
java.lang.String getName()	得到该key的名称。
int getNumberSubkeys()	得到subkey的数量。
int getNumberValues()	得到值的数量。
java.lang.String getStringValue(java.lang.String valueName)	得到REG_SZ或REG_EXPAND_SZ的值。
RegistryValue getValue(java.lang.String valueName)	得到valueName的值。
boolean hasDefaultValue()	判断该key是否有默认值。
boolean hasOnlyDefaultValue()	判断该key是否只有默认值。
int incrDoubleWord(java.lang.String valueName)	该方法将增强REG_DWORD的值。
java.util.Enumeration keyElements()	枚举该key的subkey的名称。
RegistryKey openSubKey(java.lang.String subkey)	打开该key的subkey，具有写权限。
RegistryKey openSubKey(java.lang.String subKey, int access)	打开该key的subkey，具有指定的权限。
java.lang.String regEnumKey(int index)	得到该key在index处的subkey。
java.lang.String regEnumValue(int index)	得到该key在index处的subkey的值。
void setCreated(boolean created)	设置该key的created状态。
void setValue(RegistryValue value)	设置该key的值。
void setValue(java.lang.String valueName, RegistryValue value)	设置valueName的值。
java.util.Enumeration valueElements()	枚举该key的值的名称。
boolean wasCreated()	判断该key是被opened还是被created和opened。

最后我们来看一个代码示例：

package org.solol.test;
import com.ice.jni.registry.NoSuchKeyException;
import com.ice.jni.registry.RegStringValue;
import com.ice.jni.registry.Registry;
import com.ice.jni.registry.RegistryException;
import com.ice.jni.registry.RegistryKey;
/**
* @author solo L
*
*/
public class JNIRegistryTest {
     /**
      * @param args
      */
     public static void main(String[] args) {
       //创建注册表项并设置相应的值
       try {
         RegistryKey software = Registry.HKEY_LOCAL_MACHINE
           .openSubKey("SOFTWARE");
         RegistryKey subKey = software.createSubKey("SubKeyName", "");
         subKey.setValue(new RegStringValue(subKey, "subKey1",
           "subKey1Value"));
         subKey.setValue(new RegStringValue(subKey, "subKey2",
           "subKey2Value"));
         subKey.closeKey();
       } catch (NoSuchKeyException e) {
         e.printStackTrace();
       } catch (RegistryException e) {
         e.printStackTrace();
       }
                  
       //打开注册表项并读出相应的值
       try {
         RegistryKey software = Registry.HKEY_LOCAL_MACHINE.
           openSubKey("SOFTWARE");
         RegistryKey subKey = software.openSubKey("SubKeyName");
         String subKey1Value = subKey.getStringValue("subKey1");
         String subKey2Value = subKey.getStringValue("subKey2");
         System.out.println(subKey1Value);
         System.out.println(subKey2Value);
         subKey.closeKey();
       } catch (NoSuchKeyException e) {
         e.printStackTrace();
       } catch (RegistryException e) {
         e.printStackTrace();
       }                     
     }
}

创建的注册表项如图所示：

输出结果为：

subKey1Value

subKey2Value

参考资料

• 用Preferences API存储对象，这是一篇来自IBM的文章可以使您进一步了解Preferences API。
• Microsoft Windows 注册表说明
• Description of the Microsoft Windows registry
• 在JNIRegistry这里可以下载到需要的包和源代码。
• 如果您想阅读JNIRegistry的Java doc可以来这里。
• 在Registry和Registry Reference可以找到关于注册表、注册表函数、注册表结构、注册表元素大小限制和注册表值类型等大量的信息。

说明：我的体会“第一步：把下载下来的jar包加载到工程内，第二步，把与jar包在一起的dll文件拷贝到你jdk安装目录下\jre\bin文件夹下”