Finding Constructors

构造函数声明包括名称,修饰符,参数和可抛出异常的列表。 java.lang.reflect.Constructor类提供了一种获取此信息的方法。

ConstructorSift示例说明了如何在类的声明的构造函数中搜索具有给定类型参数的构造函数。

import java.lang.reflect.Constructor;
import java.lang.reflect.Type;
import static java.lang.System.out;

public class ConstructorSift {
    public static void main(String... args) {
	try {
	    Class<?> cArg = Class.forName(args[1]);

	    Class<?> c = Class.forName(args[0]);
	    Constructor[] allConstructors = c.getDeclaredConstructors();
	    for (Constructor ctor : allConstructors) {
		Class<?>[] pType  = ctor.getParameterTypes();
		for (int i = 0; i < pType.length; i++) {
		    if (pType[i].equals(cArg)) {
			out.format("%s%n", ctor.toGenericString());

			Type[] gpType = ctor.getGenericParameterTypes();
			for (int j = 0; j < gpType.length; j++) {
			    char ch = (pType[j].equals(cArg) ? '*' : ' ');
			    out.format("%7c%s[%d]: %s%n", ch,
				       "GenericParameterType", j, gpType[j]);
			}
			break;
		    }
		}
	    }

        // production code should handle this exception more gracefully
	} catch (ClassNotFoundException x) {
	    x.printStackTrace();
	}
    }
}

Method.getGenericParameterTypes()将查询类文件中的 Signature 属性(如果存在)。如果该属性不可用,它会退回到Method.getParameterType(),而引入泛型并没有改变该属性。对于反射中* Foo *的某个值,名称为getGenericFoo()的其他方法也以类似的方式实现。 Class.getName()中描述了返回值Method.get*Types()的语法。

这是java.util.Formatter中所有带有Locale参数的构造函数的输出。

$ java ConstructorSift java.util.Formatter java.util.Locale
public
java.util.Formatter(java.io.OutputStream,java.lang.String,java.util.Locale)
throws java.io.UnsupportedEncodingException
       GenericParameterType[0]: class java.io.OutputStream
       GenericParameterType[1]: class java.lang.String
      *GenericParameterType[2]: class java.util.Locale
public java.util.Formatter(java.lang.String,java.lang.String,java.util.Locale)
throws java.io.FileNotFoundException,java.io.UnsupportedEncodingException
       GenericParameterType[0]: class java.lang.String
       GenericParameterType[1]: class java.lang.String
      *GenericParameterType[2]: class java.util.Locale
public java.util.Formatter(java.lang.Appendable,java.util.Locale)
       GenericParameterType[0]: interface java.lang.Appendable
      *GenericParameterType[1]: class java.util.Locale
public java.util.Formatter(java.util.Locale)
      *GenericParameterType[0]: class java.util.Locale
public java.util.Formatter(java.io.File,java.lang.String,java.util.Locale)
throws java.io.FileNotFoundException,java.io.UnsupportedEncodingException
       GenericParameterType[0]: class java.io.File
       GenericParameterType[1]: class java.lang.String
      *GenericParameterType[2]: class java.util.Locale

下一个示例输出说明了如何在String中搜索类型char[]的参数。

$ java ConstructorSift java.lang.String "[C"
java.lang.String(int,int,char[])
       GenericParameterType[0]: int
       GenericParameterType[1]: int
      *GenericParameterType[2]: class [C
public java.lang.String(char[],int,int)
      *GenericParameterType[0]: class [C
       GenericParameterType[1]: int
       GenericParameterType[2]: int
public java.lang.String(char[])
      *GenericParameterType[0]: class [C

Class.getName()中描述了表示Class.forName()可接受的引用和原始类型数组的语法。请注意,第一个列出的构造函数是package-private,而不是public。因为示例代码使用Class.getDeclaredConstructors()而不是Class.getConstructors()(仅返回public构造函数),所以将其返回。

此示例显示,搜索可变 arity 的参数(具有可变数量的参数)需要使用数组语法:

$ java ConstructorSift java.lang.ProcessBuilder "[Ljava.lang.String;"
public java.lang.ProcessBuilder(java.lang.String[])
      *GenericParameterType[0]: class [Ljava.lang.String;

这是源代码中ProcessBuilder构造函数的实际声明:

public ProcessBuilder(String... command)

该参数表示为java.lang.String类型的一维数组。通过调用Constructor.isVarArgs(),可以将其与显式为java.lang.String数组的参数区分开。

最后一个示例报告已使用通用参数类型声明的构造函数的输出:

$ java ConstructorSift java.util.HashMap java.util.Map
public java.util.HashMap(java.util.Map<? extends K, ? extends V>)
      *GenericParameterType[0]: java.util.Map<? extends K, ? extends V>

可以通过与方法类似的方式为构造函数检索异常类型。有关更多详细信息,请参见获取方法类型信息部分中描述的MethodSpy示例。