参数选择 API

参数选择API和其它机制的比较

通常，参数和配置数据被存储在配置文件里面，这些文件可以通过java.util.PropertiesAPI访问。然而这些文件应该放在何处或者它们应该调用什么没有标准。使用这种机制，备份用户数据或者将它们从一个机器传递到另一个机器将异常的困难。随着应用程序的增加，文件名称冲突可能性就增加。而且，这种机制在没有本机磁盘的平台下是没有用的，或者需要将数据存储在外部的数据存储器上（例如企业范围的LDAP目录服务）。

在少数情况下，开发者通过JNDI（Java名字和目录接口）API访问目录服务存储用户参数和配置数据。（不像参数API,JNDI允许允许使用任何后备存储（后端中立）。虽然JNDI是异常的强大，但是它也很巨大，它由5个包和83各类组成。JNDI不提供参数数据应该存储在目录名字空间的什么地方的政策。

参数API和JNDI都没有提供一个简单的，普遍地，后端中立的参数管理工具。参数选择API提供了一个这样的工具，它结合了参数选择API的简单和JNDI的后端中立。它在难以达到的后备数据存储方面提供充分的内置政策防止名字冲突、鼓励一致性并且促进健壮性。

使用注意事项

在类里面获得Preferences 对象

注意static final 成员而不是它的字面上的字符串用来作为关键字的名字(NUM_ROWS 和 NUM_COLS)。这降低了由于关键字名的印刷上的错误引起的运行时错误的可能性。

        Preferences prefs = Preferences.systemNodeForPackage(this);

在静态方法中获取Preferences对象

    Static String ourNodeName = "/com/acme/widget";    static void foo() {        Preferences prefs = Preferences.userRoot().node(ourNodeName);        ...    }

    static Preferences prefs =  Preferences.systemRoot().node(ourNodeName);

原子化校正

    int x, y;    ...    prefs.put(POSITION, x + "," + y);

    static int X_DEFAULT = 50, Y_DEFAULT = 25;    void baz() {        String position = prefs.get(POSITION, X_DEFAULT + "," + Y_DEFAULT);        int x, y;        try {            int i = position.indexOf(',');            x = Integer.parseInt(coordinates.substring(0, i));            y = Integer.parseInt(position.substring(i + 1));        } catch(Exception e) {            // Value was corrupt, just use defaults            x = X_DEFAULT;            y = Y_DEFAULT;        }        ...    }

探测后备存储的状态

    private static final String BACKING_STORE_AVAIL = "BackingStoreAvail";    private static boolean backingStoreAvailable() {        Preferences prefs = Preferences.userRoot().node("");        try {            boolean oldValue = prefs.getBoolean(BACKING_STORE_AVAIL, false);            prefs.putBoolean(BACKING_STORE_AVAIL, !oldValue);            prefs.flush();        } catch(BackingStoreException e) {            return false;        }        return true;    }

设计 FAQ