preferences.html

来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 1,010 行 · 第 1/5 页

<p>如果此实现支持<i>存储的默认值</i>，并且指定的首选项存在这样的默认值，则此调用将&ldquo;公开&rdquo;存储的默认值，这表示对 <tt>get</tt> 的后续调用将返回它。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>key</CODE> - 从首选项节点中移除其映射关系的键。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果 <tt>key</tt> 为 <tt>null</tt>。
<DD><CODE><A HREF="../../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果已经使用 <A HREF="Preferences.html#removeNode()"><CODE>removeNode()</CODE></A> 方法移除了此节点（或其祖先）。</DL>
</DD>
</DL>
<HR>

<A NAME="clear()"><!-- --></A><H3>
clear</H3>
<PRE>
public abstract void <B>clear</B>()
                    throws <A HREF="BackingStoreException.html" title="java.util.prefs 中的类">BackingStoreException</A></PRE>
<DL>
<DD>移除此首选项节点中的所有首选项（键-值关联）。此调用对此节点的所有子节点均没有影响。

<p>如果此实现支持<i>存储的默认值</i>，并且首选项层次结构中的这一节点包含这样的默认值，则此调用将&ldquo;公开&rdquo;存储的默认值，这表示对 <tt>get</tt> 的后续调用将返回它。
<P>
<DD><DL>

<DT><B>抛出：</B>
<DD><CODE><A HREF="BackingStoreException.html" title="java.util.prefs 中的类">BackingStoreException</A></CODE> - 如果由于内部存储的故障或未能通信而无法完成此操作。
<DD><CODE><A HREF="../../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果已经使用 <A HREF="Preferences.html#removeNode()"><CODE>removeNode()</CODE></A> 方法移除了此节点（或其祖先）。<DT><B>另请参见：</B><DD><A HREF="Preferences.html#removeNode()"><CODE>removeNode()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="putInt(java.lang.String, int)"><!-- --></A><H3>
putInt</H3>
<PRE>
public abstract void <B>putInt</B>(<A HREF="../../lang/String.html" title="java.lang 中的类">String</A>&nbsp;key,
                            int&nbsp;value)</PRE>
<DL>
<DD>将表示指定 int 值的字符串与此首选项节点中的指定键相关联。关联字符串是将 int 值传递给 <A HREF="../../lang/Integer.html#toString(int)"><CODE>Integer.toString(int)</CODE></A> 时将返回的字符串。此方法与 <A HREF="Preferences.html#getInt(java.lang.String, int)"><CODE>getInt(java.lang.String, int)</CODE></A> 一起使用。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>key</CODE> - 要与字符串形式的 value 相关联的键。<DD><CODE>value</CODE> - 要与 key 相关联的字符串形式的值。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果 <tt>key</tt> 为 <tt>null</tt>。
<DD><CODE><A HREF="../../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>key.length()</tt> 超过 <tt>MAX_KEY_LENGTH</tt>。
<DD><CODE><A HREF="../../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果已经使用 <A HREF="Preferences.html#removeNode()"><CODE>removeNode()</CODE></A> 方法移除了此节点（或其祖先）。<DT><B>另请参见：</B><DD><A HREF="Preferences.html#getInt(java.lang.String, int)"><CODE>getInt(String,int)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getInt(java.lang.String, int)"><!-- --></A><H3>
getInt</H3>
<PRE>
public abstract int <B>getInt</B>(<A HREF="../../lang/String.html" title="java.lang 中的类">String</A>&nbsp;key,
                           int&nbsp;def)</PRE>
<DL>
<DD>返回与此首选项节点中与指定键相关联的、由字符串表示的 int 值。该字符串由 <A HREF="../../lang/Integer.html#parseInt(java.lang.String)"><CODE>Integer.parseInt(String)</CODE></A> 转换为整数。如果不存在与该键相关联的值，内部存储不可用，或者传递关联值时 <tt>Integer.parseInt(String)</tt> 抛出 <A HREF="../../lang/NumberFormatException.html" title="java.lang 中的类"><CODE>NumberFormatException</CODE></A>，则返回指定的默认值。此方法与 <A HREF="Preferences.html#putInt(java.lang.String, int)"><CODE>putInt(java.lang.String, int)</CODE></A> 一起使用。

<p>如果该实现支持<i>存储的默认值</i>，并且这样的默认值存在且可访问，而且可以使用 <tt>Integer.parseInt</tt> 将其转换为 int，则优先返回此 int（而不是指定默认值）。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>key</CODE> - 要作为 int 返回其关联值的键。<DD><CODE>def</CODE> - 此首选项节点不具有与 <tt>key</tt> 相关联的值或者无法将该关联值解释为 int 或者内部存储不可访问时要返回的值。
<DT><B>返回：</B><DD>与此首选项节点的 <tt>key</tt> 相关联的字符串所表示的 int 值；或者如果该关联值不存在或无法被解释为 int，则返回 <tt>def</tt>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果已经使用 <A HREF="Preferences.html#removeNode()"><CODE>removeNode()</CODE></A> 方法移除了此节点（或其祖先）。
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果 <tt>key</tt> 为 <tt>null</tt>。<DT><B>另请参见：</B><DD><A HREF="Preferences.html#putInt(java.lang.String, int)"><CODE>putInt(String,int)</CODE></A>, 
<A HREF="Preferences.html#get(java.lang.String, java.lang.String)"><CODE>get(String,String)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="putLong(java.lang.String, long)"><!-- --></A><H3>
putLong</H3>
<PRE>
public abstract void <B>putLong</B>(<A HREF="../../lang/String.html" title="java.lang 中的类">String</A>&nbsp;key,
                             long&nbsp;value)</PRE>
<DL>
<DD>将表示指定 long 值的字符串与此首选项节点中的指定键相关联。关联字符串是将 long 值传递给 <A HREF="../../lang/Long.html#toString(long)"><CODE>Long.toString(long)</CODE></A> 时将返回的字符串。此方法与 <A HREF="Preferences.html#getLong(java.lang.String, long)"><CODE>getLong(java.lang.String, long)</CODE></A> 一起使用。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>key</CODE> - 要与字符串形式的 value 相关联的键。<DD><CODE>value</CODE> - 要与 key 相关联的字符串形式的值。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果 <tt>key</tt> 为 <tt>null</tt>。
<DD><CODE><A HREF="../../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>key.length()</tt> 超过 <tt>MAX_KEY_LENGTH</tt>。
<DD><CODE><A HREF="../../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果已经使用 <A HREF="Preferences.html#removeNode()"><CODE>removeNode()</CODE></A> 方法移除了此节点（或其祖先）。<DT><B>另请参见：</B><DD><A HREF="Preferences.html#getLong(java.lang.String, long)"><CODE>getLong(String,long)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getLong(java.lang.String, long)"><!-- --></A><H3>
getLong</H3>
<PRE>
public abstract long <B>getLong</B>(<A HREF="../../lang/String.html" title="java.lang 中的类">String</A>&nbsp;key,
                             long&nbsp;def)</PRE>
<DL>
<DD>返回与此首选项节点中指定的键相关联的、由字符串表示的 long 值。该字符串由 <A HREF="../../lang/Long.html#parseLong(java.lang.String)"><CODE>Long.parseLong(String)</CODE></A> 转换为 long。如果不存在与该键相关联的值，内部存储不可用，或者传递关联值时 <tt>Long.parseLong(String)</tt> 抛出 <A HREF="../../lang/NumberFormatException.html" title="java.lang 中的类"><CODE>NumberFormatException</CODE></A>，则返回指定的默认值。此方法与 <A HREF="Preferences.html#putLong(java.lang.String, long)"><CODE>putLong(java.lang.String, long)</CODE></A> 一起使用。

<p>如果该实现支持<i>存储的默认值</i>，这样的默认值存在且可访问，并且可以使用 <tt>Long.parseLong</tt> 转换为 long，则优先返回此 long（而不是指定默认值）。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>key</CODE> - 要作为 long 返回其关联值的键。<DD><CODE>def</CODE> - 此首选项节点不具有与 <tt>key</tt> 相关联的值或者无法将该关联值解释为 long 或者内部存储不可访问时要返回的值。
<DT><B>返回：</B><DD>返回与此首选项节点的 <tt>key</tt> 相关联的字符串所表示的 long 值；如果关联值不存在或者无法将其解释为 long，则返回 <tt>def</tt>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果已经使用 <A HREF="Preferences.html#removeNode()"><CODE>removeNode()</CODE></A> 方法移除了此节点（或其祖先）。
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果 <tt>key</tt> 为 <tt>null</tt>。<DT><B>另请参见：</B><DD><A HREF="Preferences.html#putLong(java.lang.String, long)"><CODE>putLong(String,long)</CODE></A>, 
<A HREF="Preferences.html#get(java.lang.String, java.lang.String)"><CODE>get(String,String)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="putBoolean(java.lang.String, boolean)"><!-- --></A><H3>
putBoolean</H3>
<PRE>
public abstract void <B>putBoolean</B>(<A HREF="../../lang/String.html" title="java.lang 中的类">String</A>&nbsp;key,
                                boolean&nbsp;value)</PRE>
<DL>
<DD>将表示指定 boolean 值的字符串与此首选项节点中的指定键相关联。如果该值为 true，则关联字符串为 <tt>&quot;true&quot;</tt>；如果其为 false，则关联字符串为 <tt>&quot;false&quot;</tt>。此方法与 <A HREF="Preferences.html#getBoolean(java.lang.String, boolean)"><CODE>getBoolean(java.lang.String, boolean)</CODE></A> 一起使用。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>key</CODE> - 要与字符串形式的 value 相关联的键。<DD><CODE>value</CODE> - 要与 key 相关联的字符串形式的值。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果 <tt>key</tt> 为 <tt>null</tt>。
<DD><CODE><A HREF="../../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>key.length()</tt> 超过 <tt>MAX_KEY_LENGTH</tt>。
<DD><CODE><A HREF="../../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果已经使用 <A HREF="Preferences.html#removeNode()"><CODE>removeNode()</CODE></A> 方法移除了此节点（或其祖先）。<DT><B>另请参见：</B><DD><A HREF="Preferences.html#getBoolean(java.lang.String, boolean)"><CODE>getBoolean(String,boolean)</CODE></A>, 
<A HREF="Preferences.html#get(java.lang.String, java.lang.String)"><CODE>get(String,String)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getBoolean(java.lang.String, boolean)"><!-- --></A><H3>
getBoolean</H3>
<PRE>
public abstract boolean <B>getBoolean</B>(<A HREF="../../lang/String.html" title="java.lang 中的类">String</A>&nbsp;key,
                                   boolean&nbsp;def)</PRE>
<DL>
<DD>返回与此首选项节点中指定的键相关联的、由字符串表示的 boolean 值。有效字符串是 <tt>&quot;true&quot;</tt>（表示真）和 <tt>&quot;false&quot;</tt>（表示假）。不区分大小写，例如，<tt>&quot;TRUE&quot;</tt> 和 <tt>&quot;False&quot;</tt> 也是有效的。此方法与 <A HREF="Preferences.html#putBoolean(java.lang.String, boolean)"><CODE>putBoolean(java.lang.String, boolean)</CODE></A> 一起使用。

<p>如果不存在与该键相关联的值或者内部存储不可访问或者关联值是 <tt>&quot;true&quot;</tt> 或 <tt>&quot;false&quot;</tt>（不区分大小写）之外的其他值，则返回指定默认值。

<p>如果该实现支持<i>存储的默认值</i>，这样的默认值存在且可访问，则优先使用存储的默认值（而不是指定默认值）；但如果存储的默认值是 <tt>&quot;true&quot;</tt> 或 <tt>&quot;false&quot;</tt>（不区分大小写）之外的其他值，在这种情况下，则使用指定默认值。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>key</CODE> - 要作为 boolean 返回其关联值的键。<DD><CODE>def</CODE> - 此首选项节点不具有与 <tt>key</tt> 相关联的值或者无法将该关联值解释为 boolean 或者内部存储不可访问时要返回的值。
<DT><B>返回：</B><DD>与此首选项节点的 <tt>key</tt> 相关联的字符串所表示的 boolean 值；或者如果该关联值不存在或无法被解释为 boolean，则返回 <tt>def</tt>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果已经使用 <A HREF="Preferences.html#removeNode()"><CODE>removeNode()</CODE></A> 方法移除了此节点（或其祖先）。
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果 <tt>key</tt> 为 <tt>null</tt>。<DT><B>另请参见：</B><DD><A HREF="Preferences.html#get(java.lang.String, java.lang.String)"><CODE>get(String,String)</CODE></A>, 
<A HREF="Preferences.html#putBoolean(java.lang.String, boolean)"><CODE>putBoolean(String,boolean)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="putFloat(java.lang.String, float)"><!-- --></A><H3>
putFloat</H3>
<PRE>
public abstract void <B>putFloat</B>(<A HREF="../../lang/String.html" title="java.lang 中的类">String</A>&nbsp;key,
                              float&nbsp;value)</PRE>
<DL>
<DD>将表示指定 float 值的字符串与此首选项节点中的指定键相关联。关联字符串是将 float 值传递给 <A HREF="../../lang/Float.html#toString(float)"><CODE>Float.toString(float)</CODE></A> 时将返回的字符串。此方法与 <A HREF="Preferences.html#getFloat(java.lang.String, float)"><CODE>getFloat(java.lang.String, float)</CODE></A> 一起使用。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>key</CODE> - 要与字符串形式的 value 相关联的键。<DD><CODE>value</CODE> - 要与 key 相关联的字符串形式的值。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果 <tt>key</tt> 为 <tt>null</tt>。
<DD><CODE><A HREF="../../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>key.length()</tt> 超过 <tt>MAX_KEY_LENGTH</tt>。
<DD><CODE><A HREF="../../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果已经使用 <A HREF="Preferences.html#removeNode()"><CODE>removeNode()</CODE></A> 方法移除了此节点（或其祖先）。<DT><B>另请参见：</B><DD><A HREF="Preferences.html#getFloat(java.lang.String, float)"><CODE>getFloat(String,float)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getFloat(java.lang.String, float)"><!-- --></A><H3>
getFloat</H3>
<PRE>
public abstract float <B>getFloat</B>(<A HREF="../../lang/String.html" title="java.lang 中的类">String</A>&nbsp;key,
                               float&nbsp;def)</PRE>
<DL>
<DD>返回与此首选项节点中指定的键相关联的、由字符串表示的 float 值。该字符串由 <A HREF="../../lang/Float.html#parseFloat(java.lang.String)"><CODE>Float.parseFloat(String)</CODE></A> 转换为整数。如果不存在与该键相关联的值，内部存储不可用，或者传递关联值时 <tt>Float.parseFloat(String)</tt> 抛出 <A HREF="../../lang/NumberFormatException.html" title="java.lang 中的类"><CODE>NumberFormatException</CODE></A>，则返回指定的默认值。此方法与 <A HREF="Preferences.html#putFloat(java.lang.String, float)"><CODE>putFloat(java.lang.String, float)</CODE></A> 一起使用。

<p>如果该实现支持<i>存储的默认值</i>，这样的默认值存在且可访问，并且可以使用 <tt>Float.parseFloat</tt> 转换为 float，则优先返回此 float（而不是指定默认值）。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>key</CODE> - 要作为 float 返回其关联值的键。<DD><CODE>def</CODE> - 此首选项节点不具有与 <tt>key</tt> 相关联的值或者无法将该关联值解释为 float 或者内部存储不可访问时要返回的值。
<DT><B>返回：</B><DD>与此首选项节点的 <tt>key</tt> 相关联的字符串所表示的 float 值；或者如果该关联值不存在或无法被解释为 float，则返回 <tt>def</tt>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果已经使用 <A HREF="Preferences.html#removeNode()"><CODE>removeNode()</CODE></A> 方法移除了此节点（或其祖先）。
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果 <tt>key</tt> 为 <tt>null</tt>。<DT><B>另请参见：</B><DD><A HREF="Preferences.html#putFloat(java.lang.String, float)"><CODE>putFloat(String,float)</CODE></A>, 
<A HREF="Preferences.html#get(java.lang.String, java.lang.String)"><CODE>get(String,String)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="putDouble(java.lang.String, double)"><!-- --></A><H3>
putDouble</H3>
<PRE>
public abstract void <B>putDouble</B>(<A HREF="../../lang/String.html" title="java.lang 中的类">String</A>&nbsp;key,
                               double&nbsp;value)</PRE>
<DL>
<DD>将表示指定 double 值的字符串与此首选项节点中的指定键相关联。关联字符串是将 double 值传递给 <A HREF="../../lang/Double.html#toString(double)"><CODE>Double.toString(double)</CODE></A> 时将返回的字符串。此方法与 <A HREF="Preferences.html#getDouble(java.lang.String, double)"><CODE>getDouble(java.lang.String, double)</CODE></A> 一起使用。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>key</CODE> - 要与字符串形式的 value 相关联的键。<DD><CODE>value</CODE> - 要与 key 相关联的字符串形式的值。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果 <tt>key</tt> 为 <tt>null</tt>。
<DD><CODE><A HREF="../../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgument