method.html

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

<DL>
<DD>返回一个 <code>Class</code> 对象，该对象描述了此 <code>Method</code> 对象所表示的方法的正式返回类型。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此对象所表示的方法的返回类型</DL>
</DD>
</DL>
<HR>

<A NAME="getGenericReturnType()"><!-- --></A><H3>
getGenericReturnType</H3>
<PRE>
public <A HREF="Type.html" title="java.lang.reflect 中的接口">Type</A> <B>getGenericReturnType</B>()</PRE>
<DL>
<DD>返回表示由此 <tt>Method</tt> 对象所表示方法的正式返回类型的 <tt>Type</tt> 对象。
 
<p>如果返回类型是参数化类型，则返回的 <tt>Type</tt> 对象必须实际反映源代码中所用参数的实际类型。
 
<p>如果返回类型是类型变量或参数化类型，则创建它。否则将分析它。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>表示基础方法的正式返回类型的 <tt>Type</tt> 对象
<DT><B>抛出：</B>
<DD><CODE><A HREF="GenericSignatureFormatError.html" title="java.lang.reflect 中的类">GenericSignatureFormatError</A></CODE> - 如果一般方法签名不符合 Java Virtual Machine Specification, 3rd edition 中指定的格式
<DD><CODE><A HREF="../TypeNotPresentException.html" title="java.lang 中的类">TypeNotPresentException</A></CODE> - 如果基础方法的返回类型引用不存在的类型声明
<DD><CODE><A HREF="MalformedParameterizedTypeException.html" title="java.lang.reflect 中的类">MalformedParameterizedTypeException</A></CODE> - 如果基础方法的返回类型引用无论如何都无法实例化的参数化类型<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getParameterTypes()"><!-- --></A><H3>
getParameterTypes</H3>
<PRE>
public <A HREF="../Class.html" title="java.lang 中的类">Class</A>&lt;?&gt;[] <B>getParameterTypes</B>()</PRE>
<DL>
<DD>按照声明顺序返回 <code>Class</code> 对象的数组，这些对象描述了此 <code>Method</code> 对象所表示的方法的形参类型。如果基础方法不带参数，则返回长度为 0 的数组。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此对象所表示的方法的参数类型</DL>
</DD>
</DL>
<HR>

<A NAME="getGenericParameterTypes()"><!-- --></A><H3>
getGenericParameterTypes</H3>
<PRE>
public <A HREF="Type.html" title="java.lang.reflect 中的接口">Type</A>[] <B>getGenericParameterTypes</B>()</PRE>
<DL>
<DD>按照声明顺序返回 <tt>Type</tt> 对象的数组，这些对象描述了此 <tt>Method</tt> 对象所表示的方法的形参类型的。如果基础方法不带参数，则返回长度为 0 的数组。
 
<p>如果形参类型是参数化类型，则为其返回的 <tt>Type</tt> 对象必须实际反映源代码中使用的实际类型参数。

<p>如果形参类型是类型变量或参数化类型，则创建它。否则将分析它。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>按照声明顺序返回表示基础方法的形参类型的 Type 对象数组
<DT><B>抛出：</B>
<DD><CODE><A HREF="GenericSignatureFormatError.html" title="java.lang.reflect 中的类">GenericSignatureFormatError</A></CODE> - 如果一般方法签名不符合 Java Virtual Machine Specification, 3rd edition 中指定的格式
<DD><CODE><A HREF="../TypeNotPresentException.html" title="java.lang 中的类">TypeNotPresentException</A></CODE> - 如果基础方法的所有参数类型都引用不存在的类型声明
<DD><CODE><A HREF="MalformedParameterizedTypeException.html" title="java.lang.reflect 中的类">MalformedParameterizedTypeException</A></CODE> - 如果所有基础方法的参数类型引用无论如何都无法实例化的参数化类型<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getExceptionTypes()"><!-- --></A><H3>
getExceptionTypes</H3>
<PRE>
public <A HREF="../Class.html" title="java.lang 中的类">Class</A>&lt;?&gt;[] <B>getExceptionTypes</B>()</PRE>
<DL>
<DD>返回  <code>Class</code> 对象的数组，这些对象描述了声明将此 <code>Method</code> 对象表示的基础方法抛出的异常类型。如果此方法没有在其 <code>throws</code> 子句中声明异常，则返回长度为 0 的数组。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>声明由此对象表示的方法抛出的异常类型</DL>
</DD>
</DL>
<HR>

<A NAME="getGenericExceptionTypes()"><!-- --></A><H3>
getGenericExceptionTypes</H3>
<PRE>
public <A HREF="Type.html" title="java.lang.reflect 中的接口">Type</A>[] <B>getGenericExceptionTypes</B>()</PRE>
<DL>
<DD>返回 <tt>Type</tt> 对象数组，这些对象描述了声明由此 <tt>Method</tt> 对象抛出的异常。如果基础方法没有在其 <tt>throws</tt> 子句中声明异常，则返回长度为 0 的数组。  
 
<p>如果异常类型是参数化的类型，那么为它返回的 <tt>Type</tt> 对象必须实际反映源代码中所用参数的实际类型。

<p>如果异常类型是类型变量或参数化类型，则创建它。否则将分析它。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>表示由基础方法抛出的异常类型的 Type 数组
<DT><B>抛出：</B>
<DD><CODE><A HREF="GenericSignatureFormatError.html" title="java.lang.reflect 中的类">GenericSignatureFormatError</A></CODE> - 如果一般方法签名不符合 Java Virtual Machine Specification, 3rd edition 中指定的格式
<DD><CODE><A HREF="../TypeNotPresentException.html" title="java.lang 中的类">TypeNotPresentException</A></CODE> - 如果基础方法的 <tt>throws</tt> 子句引用不存在的类型声明
<DD><CODE><A HREF="MalformedParameterizedTypeException.html" title="java.lang.reflect 中的类">MalformedParameterizedTypeException</A></CODE> - 如果基础方法的 <tt>throws</tt> 子句引用无论如何都无法实例化的参数化类型<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="equals(java.lang.Object)"><!-- --></A><H3>
equals</H3>
<PRE>
public boolean <B>equals</B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;obj)</PRE>
<DL>
<DD>将此 <code>Method</code> 与指定对象进行比较。如果对象相同，则返回 true。如果它们由相同的类声明，具有相同的名称、形参类型和返回类型，则两个 <code>Methods</code> 相同。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="../Object.html" title="java.lang 中的类">Object</A></CODE> 中的 <CODE><A HREF="../Object.html#equals(java.lang.Object)">equals</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 要与之比较的引用对象。
<DT><B>返回：</B><DD>如果此对象与 obj 参数相同，则返回 <code>true</code>；否则返回 <code>false</code>。<DT><B>另请参见：</B><DD><A HREF="../Object.html#hashCode()"><CODE>Object.hashCode()</CODE></A>, 
<A HREF="../../util/Hashtable.html" title="java.util 中的类"><CODE>Hashtable</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="hashCode()"><!-- --></A><H3>
hashCode</H3>
<PRE>
public int <B>hashCode</B>()</PRE>
<DL>
<DD>返回此 <code>Method</code> 的哈希代码。哈希代码按基础方法的声明类名称和方法名称的哈希代码的异或计算。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="../Object.html" title="java.lang 中的类">Object</A></CODE> 中的 <CODE><A HREF="../Object.html#hashCode()">hashCode</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此对象的一个哈希代码值。<DT><B>另请参见：</B><DD><A HREF="../Object.html#equals(java.lang.Object)"><CODE>Object.equals(java.lang.Object)</CODE></A>, 
<A HREF="../../util/Hashtable.html" title="java.util 中的类"><CODE>Hashtable</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="toString()"><!-- --></A><H3>
toString</H3>
<PRE>
public <A HREF="../String.html" title="java.lang 中的类">String</A> <B>toString</B>()</PRE>
<DL>
<DD>返回描述此 <code>Method</code> 的字符串。该字符串被格式化为方法访问修饰符（如果有），后面依次跟着方法返回类型、空格、声明方法的类、句点、方法名、括号以及由逗号分隔的方法的形参类型列表。如果方法抛出检查异常，则参数列表后跟着空格、单词 throws 以及由逗号分隔的抛出异常类型的列表。例如：
 <pre>
    public boolean java.lang.Object.equals(java.lang.Object)
 </pre>

<p>访问修饰符按照由 "The Java Language Specification" 指定的规范化顺序放置。首先是 <tt>public</tt>，<tt>protected</tt> 或 <tt>private</tt>，接着是按以下顺序的其他修饰符：<tt>abstract</tt>、<tt>static</tt>、<tt>final</tt>、<tt>synchronized</tt> <tt>native</tt>。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="../Object.html" title="java.lang 中的类">Object</A></CODE> 中的 <CODE><A HREF="../Object.html#toString()">toString</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>该对象的字符串表示形式。</DL>
</DD>
</DL>
<HR>

<A NAME="toGenericString()"><!-- --></A><H3>
toGenericString</H3>
<PRE>
public <A HREF="../String.html" title="java.lang 中的类">String</A> <B>toGenericString</B>()</PRE>
<DL>
<DD>返回描述此 <code>Method</code> 的字符串，包括类型参数。该字符串被格式化为方法访问修饰符（如果有），依次后跟用尖括号括起来的由逗号分隔的方法类型参数列表（如果有）、方法的一般返回类型、空格、声明方法的类、句点、方法名、括号以及由逗号分隔的方法的一般形参类型列表。空格用于将访问修饰符和类型参数或返回类型互相分隔开。如果不存在类型参数，则类型参数列表会被省略；如果类型参数列表存在，则用空格将列表与类名分隔开。如果声明方法以抛出异常，则参数列表后跟空格、单词 throws 以及由逗号分隔开的抛出一般异常类型的列表。如果不存在类型参数，则类型参数列表会被省略。

<p>访问修饰符按照 "The Java Language Specification" 指定的规范化顺序放置。首先是 <tt>public</tt>，<tt>protected</tt> 或 <tt>private</tt>，接着是按以下顺序的其他修饰符：<tt>abstract</tt>、<tt>static</tt>、<tt>final</tt>、<tt>synchronized</tt> <tt>native</tt>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>描述此 <code>Method</code> 方法的字符串，包括类型参数<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="invoke(java.lang.Object, java.lang.Object...)"><!-- --></A><H3>
invoke</H3>
<PRE>
public <A HREF="../Object.html" title="java.lang 中的类">Object</A> <B>invoke</B>(<A HREF="../Object.html" title="java.lang 中的类">Object</A>&nbsp;obj,
                     <A HREF="../Object.html" title="java.lang 中的类">Object</A>...&nbsp;args)
              throws <A HREF="../IllegalAccessException.html" title="java.lang 中的类">IllegalAccessException</A>,
                     <A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A>,
                     <A HREF="InvocationTargetException.html" title="java.lang.reflect 中的类">InvocationTargetException</A></PRE>
<DL>
<DD>对带有指定参数的指定对象调用由此 <code>Method</code> 对象表示的基础方法。个别参数被自动解包，以便与基本形参相匹配，基本参数和引用参数都随需服从方法调用转换。

<p>如果基础方法是静态的，那么可以忽略指定的 <code>obj</code> 参数。该参数可以为 null。

<p>如果基础方法所需的形参数为 0，则所提供的 <code>args</code> 数组长度可以为 0 或 null。