getDeclaredConstructor()
是 Java 反射 API 中的一个方法,它属于 Class
类。这个方法用于获取类的单个构造器(Constructor),特别是指定参数类型的构造器。如果没有提供参数类型,它将返回类的默认构造器(无参构造器)。
以下是 getDeclaredConstructor()
方法的基本定义:
public Constructor<T> getDeclaredConstructor(Class<?>... parameterTypes)
这个方法接受一个可变参数 parameterTypes
,它是一个 Class
对象数组,代表构造器的参数类型。根据提供的参数类型,getDeclaredConstructor()
方法返回一个 Constructor
对象,该对象代表了类的相应构造器。
以下是一些使用 getDeclaredConstructor()
方法的基本示例:
获取无参构造器
Class<?> clazz = MyClass.class;
Constructor<?> constructor = clazz.getDeclaredConstructor();
在这个例子中,getDeclaredConstructor()
没有参数,因此它返回 MyClass
的无参构造器。
获取有参构造器
Class<?> clazz = MyClass.class;
Constructor<?> constructor = clazz.getDeclaredConstructor(String.class, int.class);
在这个例子中,getDeclaredConstructor()
接受两个参数,分别是 String.class
和 int.class
,表示我们正在寻找一个接受一个 String
和一个 int
作为参数的构造器。
getDeclaredConstructor()
方法有几个重要特点:
- 访问权限:它返回类声明的所有构造器,包括私有(private)、默认(package-private)、受保护(protected)和公共(public)构造器。
- 异常:如果没有匹配的构造器,或者类没有指定参数类型的构造器,它将抛出
NoSuchMethodException
。 - 反射异常:如果构造器是私有的,或者由于安全管理器的限制不能访问,它将抛出
IllegalAccessException
。
一旦你有了Constructor
对象,你可以使用它来创建类的新实例,或者获取关于构造器的更多信息,如参数类型、访问修饰符等。例如,使用newInstance()
方法来创建对象:
Object instance = constructor.newInstance("example", 42);
在这个例子中,我们使用之前获取的 Constructor
对象来创建一个新实例,并传递相应的参数。