preferences.html
来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 1,010 行 · 第 1/5 页
HTML
1,010 行
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><!--NewPage--><HTML><HEAD><!-- Generated by javadoc (build 1.5.0_03) on Wed Nov 02 09:52:15 CST 2005 --><META http-equiv="Content-Type" content="text/html; charset=gb2312"><TITLE>Preferences (Java 2 Platform SE 5.0)</TITLE><META NAME="keywords" CONTENT="java.util.prefs.Preferences class"><LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style"><SCRIPT type="text/javascript">function windowTitle(){ parent.document.title="Preferences (Java 2 Platform SE 5.0)";}</SCRIPT><NOSCRIPT></NOSCRIPT></HEAD><BODY BGCOLOR="white" onload="windowTitle();"><!-- ========= START OF TOP NAVBAR ======= --><A NAME="navbar_top"><!-- --></A><A HREF="#skip-navbar_top" title="跳过导航链接"></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""><TR><TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A NAME="navbar_top_firstrow"><!-- --></A><TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>概述</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>类</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/Preferences.html"><FONT CLASS="NavBarFont1"><B>使用</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>已过时</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A> </TD> </TR></TABLE></TD><TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM><b>Java<sup><font size=-2>TM</font></sup> 2 Platform<br>Standard Ed. 5.0</b></EM></TD></TR><TR><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="PreferenceChangeListener.html" title="java.util.prefs 中的接口"><B>上一个类</B></A> <A HREF="PreferencesFactory.html" title="java.util.prefs 中的接口"><B>下一个类</B></A></FONT></TD><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html@java_2Futil_2Fprefs_2FPreferences.html" target="_top"><B>框架</B></A> <A HREF="Preferences.html" target="_top"><B>无框架</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html"><B>所有类</B></A>'); } //--></SCRIPT><NOSCRIPT> <A HREF="../../../allclasses-noframe.html"><B>所有类</B></A></NOSCRIPT></FONT></TD></TR><TR><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 摘要： 嵌套 | <A HREF="#field_summary">字段</A> | <A HREF="#constructor_summary">构造方法</A> | <A HREF="#method_summary">方法</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">详细信息： <A HREF="#field_detail">字段</A> | <A HREF="#constructor_detail">构造方法</A> | <A HREF="#method_detail">方法</A></FONT></TD></TR></TABLE><A NAME="skip-navbar_top"></A><!-- ========= END OF TOP NAVBAR ========= --><HR><!-- ======== START OF CLASS DATA ======== --><H2><FONT SIZE="-1">java.util.prefs</FONT><BR>类 Preferences</H2><PRE><A HREF="../../lang/Object.html" title="java.lang 中的类">java.lang.Object</A> <IMG SRC="../../../resources/inherit.gif" ALT="继承者 "><B>java.util.prefs.Preferences</B></PRE><DL><DT><B>直接已知子类：</B> <DD><A HREF="AbstractPreferences.html" title="java.util.prefs 中的类">AbstractPreferences</A></DD></DL><HR><DL><DT><PRE>public abstract class <B>Preferences</B><DT>extends <A HREF="../../lang/Object.html" title="java.lang 中的类">Object</A></DL></PRE><P>首选项数据的层次结构 collection 中的节点。此类允许应用程序存储和检索用户和系统首选项以及配置数据。此数据持久存储在依赖于实现的内部存储中。典型实现包括纯文本文件、特定于操作系统的注册表、目录服务器和 SQL 数据库。此类的用户无需关注内部存储的细节。 <p>有两个独立的首选项节点树，一个用于用户首选项，一个用于系统首选项。每个用户都有一个单独的用户首选项树，而在给定系统中，所有用户都共享同一系统首选项树。对“用户”和“系统”的精确描述因实现而异。用户首选项树中存储的典型信息可能包括特定应用程序的字体选择、颜色选择和首选窗口的位置及大小。系统首选项树中存储的典型信息可能包括应用程序的安装配置数据。<p>使用类似的方式将首选项树中的节点命名为层次结构文件系统中的目录。首选项树的每个节点都具有一个<i>节点名</i>（不必是惟一的）、一个惟一的<i>绝对路径名</i> 和一个<i>相对于</i> 每个祖先（包括它自己）的路径名。<p>根节点的节点名为空字符串 ("")。每个其他节点的节点名可以在创建时任意指定。此名称的惟一限制是，它不能是空字符串，也不能包含斜杠字符 ('/')。<p>根节点的绝对路径名为 <tt>"/"</tt>。根节点的子节点的绝对路径名是 <tt>"/" + </tt><i><节点名></i>。所有其他节点的绝对路径名是<i><父节点的绝对路径名></i><tt> + "/" + </tt><i><节点名></i>。注意，所有绝对路径名的第一个字符都是斜杠。<p>节点 <i>n</i> 相对于其祖先 <i>a</i> 的路径名只是为了形成 <i>n</i> 的绝对路径名，而必须追加到 <i>a</i> 的绝对路径名的字符串，同时移除开头的斜杠字符（如果存在）。注意： <ul><li>任何相对路径名的第一个字符都不能是斜杠。<li>每个节点相对于自身的路径名都是空字符串。<li>每个节点相对于父节点的路径名就是其节点名（根节点除外，因为它没有父节点）。<li>每个节点相对于根的路径名都是其移除开头斜杠的绝对路径名。 </ul><p>最后注意： <ul><li>任何路径名均不能包含多个连续的斜杠字符。<li>任何路径名均不能以斜杠字符结尾，根的绝对路径名除外。<li>所有符合这两条规则的字符串都是有效的路径名。 </ul><p>修改首选项数据的所有方法都允许进行异步操作；它们可能立即返回，但是更改最终将传播到持久内部存储中，其延迟取决于实现。可以使用 <tt>flush</tt> 方法同步地将更新强制同步到内部存储中。Java 虚拟机的正常终止<i>不会</i> 导致挂起更新的丢失，即在终止时<i>不</i> 需要进行显式 <tt>flush</tt> 调用来使挂起更新变得持久。 <p>从 <tt>Preferences</tt> 对象读取首选项的所有方法都要求调用方提供一个默认值。如果以前没有设置任何值<i>或者内部存储不可用</i>，则会返回默认值。此默认值的目的是，即使内部存储不可用，应用程序也可以运行，只是功能稍微下降一点。在内部存储不可用的情况下，多个方法（如 <tt>flush</tt>）均包含阻止应用程序操作的语义。普通应用程序不必调用这些方法中的任何一个，它们可能以抛出 <A HREF="BackingStoreException.html" title="java.util.prefs 中的类"><CODE>BackingStoreException</CODE></A> 而告终。<p>单个 JVM 中的多个线程可以同时调用此类中的方法，无需进行外部同步，其结果等效于某些顺序执行。如果在同一个内部存储中存储其首选项数据的<i>多个 JVM</i> 同时使用此类，则数据存储也不会遭到破坏，但首选项数据的一致性难以得到保证。<p>此类包含导出/导入设施，允许将首选项“导出”到 XML 文档，将表示首选项的 XML 文档再“导入”回系统。可以使用此设施备份全部或部分首选项树，并在以后从备份中还原。<p>XML 文档具有以下 DOCTYPE 声明： <pre> <!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd"> </pre>注意，导入或导出首选项时<i>不</i> 访问系统 URI (http://java.sun.com/dtd/preferences.dtd)；该系统 URI 仅作为一个惟一标识 DTD 的字符串： <pre> <?xml version="1.0" encoding="UTF-8"?> <!-- DTD for a Preferences tree. --> <!-- The preferences element is at the root of an XML document representing a Preferences tree. --> <!ELEMENT preferences (root)> <!-- The preferences element contains an optional version attribute, which specifies version of DTD. --> <!ATTLIST preferences EXTERNAL_XML_VERSION CDATA "0.0" > <!-- The root element has a map representing the root's preferences (if any), and one node for each child of the root (if any). --> <!ELEMENT root (map, node*) > <!-- Additionally, the root contains a type attribute, which specifies whether it's the system or user root. --> <!ATTLIST root type (system|user) #REQUIRED > <!-- Each node has a map representing its preferences (if any), and one node for each child (if any). --> <!ELEMENT node (map, node*) > <!-- Additionally, each node has a name attribute --> <!ATTLIST node name CDATA #REQUIRED > <!-- A map represents the preferences stored at a node (if any). --> <!ELEMENT map (entry*) > <!-- An entry represents a single preference, which is simply a key-value pair. --> <!ELEMENT entry EMPTY > <!ATTLIST entry key CDATA #REQUIRED value CDATA #REQUIRED > </pre>每个 <tt>Preferences</tt> 实现都必须具有一个关联的 <A HREF="PreferencesFactory.html" title="java.util.prefs 中的接口"><CODE>PreferencesFactory</CODE></A> 实现。每个 J2SE 实现都必须提供一些方式，来指定将哪个 <tt>PreferencesFactory</tt> 实现用于生成根首选项节点。这允许管理员使用替代实现替换默认首选项实现。<p>实现注意事项：在 Sun 的 JRE 中，<tt>PreferencesFactory</tt> 实现的位置如下： <ol><li><p>如果定义了系统属性 <tt>java.util.prefs.PreferencesFactory</tt>，则该属性名就会用作实现 <tt>PreferencesFactory</tt> 接口的类的完全限定名。加载并实例化该类；如果此进程失败，则抛出未指定的错误。</p></li><li><p>如果在对<A HREF="../../lang/ClassLoader.html#getSystemClassLoader()"><CODE>系统类加载器</CODE></A>可见的 jar 文件中安装了 <tt>PreferencesFactory</tt> 实现类文件，并且该 jar 文件在资源目录 <tt>META-INF/services</tt> 中包含名为 <tt>java.util.prefs.PreferencesFactory</tt> 的提供程序配置文件，则采用在该文件中指定的第一个类名称。如果提供了一个以上这样的 jar 文件，则使用找到的第一个文件。加载并实例化该类；如果此进程失败，则抛出未指定的错误。</p></li><li><p>最后，如果既没有提供上述系统属性也没有提供扩展 jar 文件，则加载和实例化基础平台的系统级默认 <tt>PreferencesFactory</tt> 实现。</p></li> </ol><P><P><DL><DT><B>从以下版本开始：</B></DT> <DD>1.4</DD>⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?