class.html

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

<HR>

<A NAME="getClassLoader()"><!-- --></A><H3>
getClassLoader</H3>
<PRE>
public <A HREF="ClassLoader.html" title="java.lang 中的类">ClassLoader</A> <B>getClassLoader</B>()</PRE>
<DL>
<DD>返回该类的类加载器。有些实现可能使用 null 来表示引导类加载器。如果该类由引导类加载器加载，则此方法在这类实现中将返回 null。

<p> 如果有安全管理器，并且调用方的类加载器不是 null，也不同于或是请求的类加载器的祖先，则此方法通过 <code>RuntimePermission("getClassLoader")</code> 权限调用此安全管理器的 <code>checkPermission</code> 方法，以确保可以访问该类的类加载器。
 
<p>如果此对象表示一个基本类型或 void，则返回 null。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>加载此对象所表示的类或接口的类加载器。
<DT><B>抛出：</B>
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果有安全管理器，并且 <code>checkPermission</code> 方法拒绝对该类类加载器的访问。<DT><B>另请参见：</B><DD><A HREF="ClassLoader.html" title="java.lang 中的类"><CODE>ClassLoader</CODE></A>, 
<A HREF="SecurityManager.html#checkPermission(java.security.Permission)"><CODE>SecurityManager.checkPermission(java.security.Permission)</CODE></A>, 
<A HREF="RuntimePermission.html" title="java.lang 中的类"><CODE>RuntimePermission</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getTypeParameters()"><!-- --></A><H3>
getTypeParameters</H3>
<PRE>
public <A HREF="reflect/TypeVariable.html" title="java.lang.reflect 中的接口">TypeVariable</A>&lt;<A HREF="Class.html" title="java.lang 中的类">Class</A>&lt;<A HREF="Class.html" title="Class 中的类型参数">T</A>&gt;&gt;[] <B>getTypeParameters</B>()</PRE>
<DL>
<DD>按声明顺序返回 <tt>TypeVariable</tt> 对象的一个数组，这些对象表示用此 <tt>GenericDeclaration</tt> 对象所表示的常规声明来声明的类型变量。如果基础的常规声明不声明类型变量，则返回长度为 0 的数组。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="reflect/GenericDeclaration.html" title="java.lang.reflect 中的接口">GenericDeclaration</A></CODE> 中的 <CODE><A HREF="reflect/GenericDeclaration.html#getTypeParameters()">getTypeParameters</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>表示该常规声明所声明的类型变量的 <tt>TypeVariable</tt> 对象的一个数组
<DT><B>抛出：</B>
<DD><CODE>GenericSignatureFormatError</CODE> - 如果常规声明的常规签名不符合《Java Virtual Machine Specification, 3rd edition》规定的格式<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getSuperclass()"><!-- --></A><H3>
getSuperclass</H3>
<PRE>
public <A HREF="Class.html" title="java.lang 中的类">Class</A>&lt;? super <A HREF="Class.html" title="Class 中的类型参数">T</A>&gt; <B>getSuperclass</B>()</PRE>
<DL>
<DD>返回表示此 <code>Class</code> 所表示的实体（类、接口、基本类型或 void）的超类的 <code>Class</code>。如果此 <code>Class</code> 表示 <code>Object</code> 类、一个接口、一个基本类型或 void，则返回 null。如果此对象表示一个数组类，则返回表示该 <code>Object</code> 类的 <code>Class</code> 对象。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此对象所表示的类的超类。</DL>
</DD>
</DL>
<HR>

<A NAME="getGenericSuperclass()"><!-- --></A><H3>
getGenericSuperclass</H3>
<PRE>
public <A HREF="reflect/Type.html" title="java.lang.reflect 中的接口">Type</A> <B>getGenericSuperclass</B>()</PRE>
<DL>
<DD>返回表示此 <tt>Class</tt> 所表示的实体（类、接口、基本类型或 void）的直接超类的 <tt>Type</tt>。
 
<p>如果超类是参数化类型，则返回的 <tt>Type</tt> 
对象必须准确反映源代码中所使用的实际类型参数。如果以前未曾创建表示超类的参数化类型，则创建之。请参阅 <A HREF="reflect/ParameterizedType.html" title="java.lang.reflect 中的接口"><CODE>ParameterizedType</CODE></A> 声明，了解参数化类型创建过程的语义。如果此 <tt>Class</tt> 表示 <tt>Object</tt>
 类、接口、基本类型或 void，则返回 null。如果此对象表示一个数组类，则返回表示 <tt>Object</tt> 类的 <tt>Class</tt> 对象。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此对象所表示的类的超类
<DT><B>抛出：</B>
<DD><CODE>GenericSignatureFormatError</CODE> - 如果常规类签名不符合《Java Virtual Machine Specification, 3rd edition》规定的格式
<DD><CODE><A HREF="TypeNotPresentException.html" title="java.lang 中的类">TypeNotPresentException</A></CODE> - 如果常规超类引用不存在的类型声明
<DD><CODE>MalformedParameterizedTypeException</CODE> - 如果常规超类引用的参数化类型由于某种原因无法实例化<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getPackage()"><!-- --></A><H3>
getPackage</H3>
<PRE>
public <A HREF="Package.html" title="java.lang 中的类">Package</A> <B>getPackage</B>()</PRE>
<DL>
<DD>获取此类的包。此类的类加载器用于查找该包。如果该类是通过引导类加载器加载的，则搜索从 CLASSPATH 加载的包的集合，以查找该类的包。如果所有包对象都不是用该类的类加载器加载的，则返回 null。

 <p> 只有该类的附属清单中定义了信息，并且类加载器使用该清单中的属性创建了包实例，包才具有版本和规范属性。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>该类的包，如果存档或基本代码中没有可用的包信息，则返回 null。</DL>
</DD>
</DL>
<HR>

<A NAME="getInterfaces()"><!-- --></A><H3>
getInterfaces</H3>
<PRE>
public <A HREF="Class.html" title="java.lang 中的类">Class</A>[] <B>getInterfaces</B>()</PRE>
<DL>
<DD>确定此对象所表示的类或接口实现的接口。

<p> 如果此对象表示一个类，则返回值是一个数组，它包含了表示该类所实现的所有接口的对象。数组中接口对象的顺序与此对象所表示的类的声明的 <code>implements</code> 子句中的接口名顺序一致。例如，给定声明：
 <blockquote><pre>
 class Shimmer implements FloorWax, DessertTopping { ... }
</pre></blockquote>
 设 <code>s</code> 的值为 <code>Shimmer</code> 的一个实例；表达式：
 <blockquote><pre>
 s.getClass().getInterfaces()[0]
 </pre></blockquote>
 的值为表示<code>FloorWax</code> 接口的 <code>Class</code> 对象；
 <blockquote><pre>
 s.getClass().getInterfaces()[1]
 </pre></blockquote>
 的值为表示 <code>DessertTopping</code> 接口的 <code>Class</code> 对象。

<p> 如果此对象表示一个接口，则该数组包含表示该接口扩展的所有接口的对象。数组中接口对象的顺序与此对象所表示的接口的声明的 <code>extends</code> 子句中的接口名顺序一致。

<p>如果此对象表示一个不实现任何接口的类或接口，则此方法返回一个长度为 0 的数组。

<p> 如果此对象表示一个基本类型或 void，则此方法返回一个长度为 0 的数组。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>该类所实现的接口的一个数组。</DL>
</DD>
</DL>
<HR>

<A NAME="getGenericInterfaces()"><!-- --></A><H3>
getGenericInterfaces</H3>
<PRE>
public <A HREF="reflect/Type.html" title="java.lang.reflect 中的接口">Type</A>[] <B>getGenericInterfaces</B>()</PRE>
<DL>
<DD>返回表示某些接口的 <tt>Type</tt>，这些接口由此对象所表示的类或接口直接实现。

<p>如果超接口是参数化类型，则返回的 <tt>Type</tt> 对象必须准确反映源代码中所使用的实际类型参数。如果以前未曾创建表示超类的参数化类型，则创建之。请参阅 <A HREF="reflect/ParameterizedType.html" title="java.lang.reflect 中的接口"><CODE>ParameterizedType</CODE></A> 声明，了解参数化类型创建过程的语义。

<p> 如果此对象表示一个类，则返回一个包含这样一些对象的数组，这些对象表示该类实现的所有接口。数组中接口对象的顺序与此对象所表示的类的声明的 <tt>implements</tt> 子句中的接口名顺序一致。对于数组类，接口 <tt>Cloneable</tt> 和 <tt>Serializable</tt> 以该顺序返回。

<p>如果此对象表示一个接口，则该数组包含表示该接口直接扩展的所有接口的对象。数组中接口对象的顺序与此对象所表示的接口的声明的 <code>extends</code> 子句中的接口名顺序一致。

<p>如果此对象表示一个不实现任何接口的类或接口，则此方法返回一个长度为 0 的数组。

<p>如果此对象表示一个基本类型或 void，则此方法返回一个长度为 0 的数组。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此类所实现的接口的一个数组
<DT><B>抛出：</B>
<DD><CODE>GenericSignatureFormatError</CODE> - 如果常规类签名不符合《Java Virtual Machine Specification, 3rd edition》规定的格式
<DD><CODE><A HREF="TypeNotPresentException.html" title="java.lang 中的类">TypeNotPresentException</A></CODE> - 如果任意常规超接口引用不存在的类型声明
<DD><CODE>MalformedParameterizedTypeException</CODE> - 如果任意常规超接口引用的参数化类型由于某种原因无法实例化<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getComponentType()"><!-- --></A><H3>
getComponentType</H3>
<PRE>
public <A HREF="Class.html" title="java.lang 中的类">Class</A>&lt;?&gt; <B>getComponentType</B>()</PRE>
<DL>
<DD>返回表示数组组件类型的 <code>Class</code>。如果此类不表示数组类，则此方法返回 null。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>如果该类是数组，则返回表示该类组件类型的 <code>Class</code><DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.1</DD>
<DT><B>另请参见：</B><DD><A HREF="reflect/Array.html" title="java.lang.reflect 中的类"><CODE>Array</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getModifiers()"><!-- --></A><H3>
getModifiers</H3>
<PRE>
public int <B>getModifiers</B>()</PRE>
<DL>
<DD>返回此类或接口以整数编码的 Java 语言修饰符。修饰符由 Java 虚拟机的 <code>public</code>、<code>protected</code>、<code>private</code>、<code>final</code>、<code>static</code>、<code>abstract</code> 和 <code>interface</code> 对应的常量组成；它们应当通过 <code>Modifier</code> 类的方法来解码。

<p> 如果基础类是数组类，则其 <code>public</code>、<code>private</code> 和 <code>protected</code> 修饰符与其组件类型的修饰符相同。如果此 <code>Class</code> 表示一个基本类型或 void，则其 <code>public</code> 修饰符始终为 <code>true</code>，<code>protected</code> 和 <code>private</code> 修饰符始终为 <code>false</code>。如果此对象表示一个数组类、一个基本类型或 void，则其 <code>final</code> 修饰符始终为 <code>true</code>，其接口修饰符始终为 <code>false</code>。该规范没有给定其他修饰符的值。

 <p><em>《Java Virtual Machine Specification》</em>中的表 4.1 对修饰符编码进行了详细说明。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>表示该类修饰符的 <code>int</code><DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.1</DD>
<DT><B>另请参见：</B><DD><A HREF="reflect/Modifier.html" title="java.lang.reflect 中的类"><CODE>Modifier</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getSigners()"><!-- --></A><H3>
getSigners</H3>
<PRE>
public <A HREF="Object.html" title="java.lang 中的类">Object</A>[] <B>getSigners</B>()</PRE>
<DL>
<DD>获取此类的标记。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此类的标记，若无标记则返回 null。特别地，如果此对象表示一个基本类型或 void，则此方法返回 null。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.1</DD>
</DL>
</DD>
</DL>
<HR>

<A NA