From f2e59ad7786f9c80155e24f17e2c8bc63f8fb22c Mon Sep 17 00:00:00 2001
From: Elliott Hughes <enh@google.com>
Date: Thu, 11 Jul 2013 13:02:04 -0700
Subject: Fix Class.getMethod docs.
Bug: https://code.google.com/p/android/issues/detail?id=31485
Change-Id: Ic9693eced5d914663428375f7d4d893417ea09e6
---
libdvm/src/main/java/java/lang/Class.java | 21 +++++++++++++--------
1 file changed, 13 insertions(+), 8 deletions(-)
(limited to 'libdvm/src')
diff --git a/libdvm/src/main/java/java/lang/Class.java b/libdvm/src/main/java/java/lang/Class.java
index f618b66..47addea 100644
--- a/libdvm/src/main/java/java/lang/Class.java
+++ b/libdvm/src/main/java/java/lang/Class.java
@@ -388,9 +388,11 @@ public final class Class<T> implements Serializable, AnnotatedElement, GenericDe
* constructor matching the given parameter types.
* {@code (Class[]) null} is equivalent to the empty array.
*
+ * <p>See {@link #getMethod} for details of the search order.
+ * Use {@link #getDeclaredConstructor} if you don't want to search superclasses.
+ *
* @throws NoSuchMethodException
* if the constructor can not be found.
- * @see #getDeclaredConstructor(Class[])
*/
@SuppressWarnings("unchecked")
public Constructor<T> getConstructor(Class<?>... parameterTypes) throws NoSuchMethodException {
@@ -502,9 +504,10 @@ public final class Class<T> implements Serializable, AnnotatedElement, GenericDe
* represented by this {@code Class}.
* {@code (Class[]) null} is equivalent to the empty array.
*
+ * <p>Use {@link #getConstructor} if you want to search superclasses.
+ *
* @throws NoSuchMethodException
* if the requested constructor can not be found.
- * @see #getConstructor(Class[])
*/
@SuppressWarnings("unchecked")
public Constructor<T> getDeclaredConstructor(Class<?>... parameterTypes)
@@ -578,11 +581,12 @@ public final class Class<T> implements Serializable, AnnotatedElement, GenericDe
* represented by this {@code Class}.
* {@code (Class[]) null} is equivalent to the empty array.
*
+ * <p>See {@link #getMethod} if you want to search superclasses.
+ *
* @throws NoSuchMethodException
* if the requested method can not be found.
* @throws NullPointerException
* if {@code name} is {@code null}.
- * @see #getMethod(String, Class[])
*/
public Method getDeclaredMethod(String name, Class<?>... parameterTypes)
throws NoSuchMethodException {
@@ -774,14 +778,15 @@ public final class Class<T> implements Serializable, AnnotatedElement, GenericDe
* Returns a {@code Method} object which represents the public method with
* the given name and parameter types.
* {@code (Class[]) null} is equivalent to the empty array.
- * This method first searches the
- * class C represented by this {@code Class}, then the superclasses of C and
- * finally the interfaces implemented by C and finally the superclasses of C
- * for a method with matching name.
+ *
+ * <p>This method first searches the class C represented by this {@code Class},
+ * then the superclasses of C,
+ * and finally the interfaces implemented by C and its superclasses.
+ *
+ * <p>Use {@link #getDeclaredMethod} if you don't want to search superclasses.
*
* @throws NoSuchMethodException
* if the method can not be found.
- * @see #getDeclaredMethod(String, Class[])
*/
public Method getMethod(String name, Class<?>... parameterTypes) throws NoSuchMethodException {
Member member = getConstructorOrMethod(name, true, true, parameterTypes);
--
cgit v1.1