field.html

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

<DD>返回指定对象上此 <code>Field</code> 表示的字段的值。如果该值是一个基本类型值，则自动将其包装在一个对象中。

<p>基础字段的值是按以下方式获得的：

<p>如果基础字段是一个静态字段，则忽略 <code>obj</code> 变量；它可能为 null。

<p>否则，基础字段是一个实例字段。如果指定的 <code>obj</code> 变量为 null，则该方法将抛出一个 <code>NullPointerException</code>。如果指定对象不是声明基础字段的类或接口的实例，则该方法将抛出一个 <code>IllegalArgumentException</code>。

<p>如果此 <code>Field</code> 对象强制实施 Java 语言访问控制，并且基础字段是不可访问的，则该方法将抛出一个 <code>IllegalAccessException</code>。如果基础字段是静态的，并且声明该字段的类尚未初始化，则初始化这个类。

<p>否则，从基础实例字段或静态字段中检索该值。如果该字段是一个基本类型字段，则在返回前将该值包装在一个对象中，否则照原样返回。

<p>如果字段隐藏在 <code>obj</code> 的类型中，则根据前面的规则获得字段的值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 从中提取所表示字段的值的对象
<DT><B>返回：</B><DD>对象 <tt>obj</tt> 中的所表示字段的值；在返回之前，基值包装在一个适当的对象中
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></CODE> - 如果基础字段是不可访问的。
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果指定对象不是声明基础字段（或者其子类或实现者）的类或接口的实例。
<DD><CODE><A HREF="../NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定对象为 null 并且字段是一个实例字段。
<DD><CODE><A HREF="../ExceptionInInitializerError.html" title="java.lang 中的类">ExceptionInInitializerError</A></CODE> - 如果此方法引起的初始化失败。</DL>
</DD>
</DL>
<HR>

<A NAME="getBoolean(java.lang.Object)"><!-- --></A><H3>
getBoolean</H3>
<PRE>
public boolean <B>getBoolean</B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;obj)
                   throws <A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A>,
                          <A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></PRE>
<DL>
<DD>获得一个静态或实例 <code>boolean</code> 字段的值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 从中提取 <code>boolean</code> 值的对象
<DT><B>返回：</B><DD><code>boolean</code> 字段的值
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></CODE> - 如果基础字段是不可访问的。
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果指定对象不是声明基础字段（或者其子类或实现者）的类或接口的实例，或者如果无法通过扩展转换将字段值转换为 <code>boolean</code> 类型。
<DD><CODE><A HREF="../NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定对象为 null 并且字段是一个实例字段。
<DD><CODE><A HREF="../ExceptionInInitializerError.html" title="java.lang 中的类">ExceptionInInitializerError</A></CODE> - 如果此方法引起的初始化失败。<DT><B>另请参见：</B><DD><A HREF="Field.html#get(java.lang.Object)"><CODE>get(java.lang.Object)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getByte(java.lang.Object)"><!-- --></A><H3>
getByte</H3>
<PRE>
public byte <B>getByte</B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;obj)
             throws <A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A>,
                    <A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></PRE>
<DL>
<DD>获得一个静态或实例 <code>byte</code> 字段的值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 从中提取 <code>byte</code> 值的对象
<DT><B>返回：</B><DD><code>byte</code> 字段的值
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></CODE> - 如果基础字段是不可访问的。
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果指定对象不是声明基础字段（或者其子类或实现者）的类或接口的实例，或者如果无法通过扩展转换将字段值转换为 <code>byte</code> 类型。
<DD><CODE><A HREF="../NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定对象为 null 并且字段是一个实例字段。
<DD><CODE><A HREF="../ExceptionInInitializerError.html" title="java.lang 中的类">ExceptionInInitializerError</A></CODE> - 如果此方法引起的初始化失败。<DT><B>另请参见：</B><DD><A HREF="Field.html#get(java.lang.Object)"><CODE>get(java.lang.Object)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getChar(java.lang.Object)"><!-- --></A><H3>
getChar</H3>
<PRE>
public char <B>getChar</B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;obj)
             throws <A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A>,
                    <A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></PRE>
<DL>
<DD>获得 <code>char</code> 类型或另一个通过扩展转换可以转换为 <code>char</code> 类型的基本类型的静态或实例字段的值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 从中提取 <code>char</code> 值的对象
<DT><B>返回：</B><DD>转换为 <code>char</code> 类型的字段的值
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></CODE> - 如果基础字段是不可访问的。
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果指定对象不是声明基础字段（或者其子类或实现者）的类或接口的实例，或者如果无法通过扩展转换将字段值转换为 <code>char</code> 类型。
<DD><CODE><A HREF="../NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定对象为 null 并且字段是一个实例字段。
<DD><CODE><A HREF="../ExceptionInInitializerError.html" title="java.lang 中的类">ExceptionInInitializerError</A></CODE> - 如果此方法引起的初始化失败。<DT><B>另请参见：</B><DD><A HREF="Field.html#get(java.lang.Object)"><CODE>get(java.lang.Object)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getShort(java.lang.Object)"><!-- --></A><H3>
getShort</H3>
<PRE>
public short <B>getShort</B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;obj)
               throws <A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A>,
                      <A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></PRE>
<DL>
<DD>获得 <code>short</code> 类型或另一个通过扩展转换可以转换为 <code>short</code> 类型的基本类型的静态或实例字段的值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 从中提取 <code>short</code> 值的对象
<DT><B>返回：</B><DD>转换为 <code>short</code> 类型的字段的值
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></CODE> - 如果基础字段是不可访问的。
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果指定对象不是声明基础字段（或者其子类或实现者）的类或接口的实例，或者如果无法通过扩展转换将字段值转换为 <code>short</code> 类型。
<DD><CODE><A HREF="../NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定对象为 null 并且字段是一个实例字段。
<DD><CODE><A HREF="../ExceptionInInitializerError.html" title="java.lang 中的类">ExceptionInInitializerError</A></CODE> - 如果此方法引起的初始化失败。<DT><B>另请参见：</B><DD><A HREF="Field.html#get(java.lang.Object)"><CODE>get(java.lang.Object)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getInt(java.lang.Object)"><!-- --></A><H3>
getInt</H3>
<PRE>
public int <B>getInt</B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;obj)
           throws <A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A>,
                  <A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></PRE>
<DL>
<DD>获得 <code>int</code> 类型或另一个通过扩展转换可以转换为 <code>int</code> 类型的基本类型的静态或实例字段的值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 从中提取 <code>int</code> 值的对象
<DT><B>返回：</B><DD>转换为 <code>int</code> 类型的字段的值
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></CODE> - 如果基础字段是不可访问的。
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果指定对象不是声明基础字段（或者其子类或实现者）的类或接口的实例，或者如果无法通过扩展转换将字段值转换为 <code>int</code> 类型。
<DD><CODE><A HREF="../NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定对象为 null 并且字段是一个实例字段。
<DD><CODE><A HREF="../ExceptionInInitializerError.html" title="java.lang 中的类">ExceptionInInitializerError</A></CODE> - 如果此方法引起的初始化失败。<DT><B>另请参见：</B><DD><A HREF="Field.html#get(java.lang.Object)"><CODE>get(java.lang.Object)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getLong(java.lang.Object)"><!-- --></A><H3>
getLong</H3>
<PRE>
public long <B>getLong</B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;obj)
             throws <A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A>,
                    <A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></PRE>
<DL>
<DD>获得 <code>long</code> 类型或另一个通过扩展转换可以转换为 <code>long</code> 类型的基本类型的静态或实例字段的值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 从中提取 <code>long</code> 值的对象
<DT><B>返回：</B><DD>转换为 <code>long</code> 类型的字段的值
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></CODE> - 如果基础字段是不可访问的。
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果指定对象不是声明基础字段（或者其子类或实现者）的类或接口的实例，或者如果无法通过扩展转换将字段值转换为 <code>long</code> 类型。
<DD><CODE><A HREF="../NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定对象为 null 并且字段是一个实例字段。
<DD><CODE><A HREF="../ExceptionInInitializerError.html" title="java.lang 中的类">ExceptionInInitializerError</A></CODE> - 如果此方法引起的初始化失败。<DT><B>另请参见：</B><DD><A HREF="Field.html#get(java.lang.Object)"><CODE>get(java.lang.Object)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getFloat(java.lang.Object)"><!-- --></A><H3>
getFloat</H3>
<PRE>
public float <B>getFloat</B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;obj)
               throws <A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A>,
                      <A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></PRE>
<DL>
<DD>获得 <code>float</code> 类型或另一个通过扩展转换可以转换为 <code>float</code> 类型的基本类型的静态或实例字段的值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 从中提取 <code>float</code> 值的对象
<DT><B>返回：</B><DD>转换为 <code>float</code> 类型的字段的值
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></CODE> - 如果基础字段是不可访问的。
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果指定对象不是声明基础字段（或者其子类或实现者）的类或接口的实例，或者如果无法通过扩展转换将字段值转换为 <code>float</code> 类型。
<DD><CODE><A HREF="../NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定对象为 null 并且字段是一个实例字段。
<DD><CODE><A HREF="../ExceptionInInitializerError.html" title="java.lang 中的类">ExceptionInInitializerError</A></CODE> - 如果此方法引起的初始化失败。<DT><B>另请参见：</B><DD><A HREF="Field.html#get(java.lang.Object)"><CODE>get(java.lang.Object)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getDouble(java.lang.Object)"><!-- --></A><H3>
getDouble</H3>
<PRE>
public double <B>getDouble</B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;obj)
                 throws <A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A>,
                        <A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></PRE>
<DL>
<DD>获得 <code>double</code> 类型或另一个通过扩展转换可以转换为 <code>double</code> 类型的基本类型的静态或实例字段的值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 从中提取 <code>double</code> 值的对象
<DT><B>返回：</B><DD>转换为 <code>double</code> 类型的字段的值
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A></CODE> - 如果基础字段是不可访问的。
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果指定对象不是声明基础字段（或者其子类或实现者）的类或接口的实例，或者如果无法通过扩展转换将字段值转换为 <code>double</code> 类型。
<DD><CODE><A HREF="../NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定对象为 null 并且字段是一个实例字段。
<DD><CODE><A HREF="../ExceptionInInitializerError.html" title="java.lang 中的类">ExceptionInInitializerError</A></CODE> - 如果此方法引起的初始化失败。<DT><B>另请参见：</B><DD><A HREF="Field.html#get(java.lang.Object)"><CODE>get(java.lang.Object)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="set(java.lang.Object, java.lang.Object)"><!-- --></A><H3>