| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public final class Constructor extends AccessibleObject implements GenericDeclaration, Member
Constructor
provides information about, and access to, a single
constructor for a class.
Constructor
permits widening conversions to occur when matching the
actual parameters to newInstance() with the underlying
constructor's formal parameters, but throws an
IllegalArgumentException
if a narrowing conversion would occur.
Method Summary | |
---|---|
boolean |
Compares this Constructor against the specified object.
|
Annotation |
getAnnotation(Class annotationClass) |
Annotation[] |
|
Class |
Returns the Class object representing the class that declares
the constructor represented by this Constructor object.
|
Class[] |
Returns an array of Class objects that represent the types
of exceptions declared to be thrown by the underlying constructor
represented by this Constructor object.
|
Type[] |
Returns an array of Type objects that represent the exceptions declared to be thrown by this Constructor object. |
Type[] |
Returns an array of Type objects that represent the formal parameter types, in declaration order, of the method represented by this Constructor object. |
int |
Returns the Java language modifiers for the constructor represented by this Constructor object, as an integer.
|
String |
getName() Returns the name of this constructor, as a string. |
Annotation[][] |
Returns an array of arrays that represent the annotations on the formal parameters, in declaration order, of the method represented by this Constructor object. |
Class[] |
Returns an array of Class objects that represent the formal
parameter types, in declaration order, of the constructor
represented by this Constructor object.
|
TypeVariable[] |
Returns an array of TypeVariable objects that represent the type variables declared by the generic declaration represented by this GenericDeclaration object, in declaration order. |
int |
hashCode() Returns a hashcode for this Constructor .
|
boolean |
Returns true if this constructor is a synthetic constructor; returns false otherwise. |
boolean |
Returns true if this constructor was declared to take a variable number of arguments; returns false otherwise. |
Object |
newInstance(Object[] initargs) Uses the constructor represented by this Constructor object to
create and initialize a new instance of the constructor's
declaring class, with the specified initialization parameters.
|
String |
Returns a string describing this Constructor ,
including type parameters.
|
String |
toString() Returns a string describing this Constructor .
|
Methods inherited from class java.lang.reflect.AccessibleObject |
---|
getAnnotation, getAnnotations, getDeclaredAnnotations, isAccessible, isAnnotationPresent, setAccessible, setAccessible |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public boolean equals(Object obj)
Constructor
against the specified object.
Returns true if the objects are the same. Two Constructor
objects are
the same if they were declared by the same class and have the
same formal parameter types.
equals
in class Object
obj
public Annotation getAnnotation(Class annotationClass)
getAnnotation
in class AccessibleObject
annotationClass
public Annotation[] getDeclaredAnnotations()
getDeclaredAnnotations
in class AccessibleObject
public Class getDeclaringClass()
Class
object representing the class that declares
the constructor represented by this Constructor
object.
public Class[] getExceptionTypes()
Class
objects that represent the types
of exceptions declared to be thrown by the underlying constructor
represented by this Constructor
object. Returns an array of
length 0 if the constructor declares no exceptions in its throws
clause.
public Type[] getGenericExceptionTypes()
If an exception type is a parameterized type, the Type object returned for it must accurately reflect the actual type parameters used in the source code.
If an exception type is a type variable or a parameterized type, it is created. Otherwise, it is resolved.
public Type[] getGenericParameterTypes()
If a formal parameter type is a parameterized type, the Type object returned for it must accurately reflect the actual type parameters used in the source code.
If a formal parameter type is a type variable or a parameterized type, it is created. Otherwise, it is resolved.
public int getModifiers()
Constructor
object, as an integer. The
Modifier
class should be used to decode the modifiers.
public String getName()
public Annotation[][] getParameterAnnotations()
public Class[] getParameterTypes()
Class
objects that represent the formal
parameter types, in declaration order, of the constructor
represented by this Constructor
object. Returns an array of
length 0 if the underlying constructor takes no parameters.
public TypeVariable[] getTypeParameters()
public int hashCode()
Constructor
. The hashcode is
the same as the hashcode for the underlying constructor's
declaring class name.
hashCode
in class Object
public boolean isSynthetic()
public boolean isVarArgs()
public Object newInstance(Object[] initargs) throws InstantiationException, IllegalAccessException, IllegalArgumentException, InvocationTargetException
Constructor
object to
create and initialize a new instance of the constructor's
declaring class, with the specified initialization parameters.
Individual parameters are automatically unwrapped to match
primitive formal parameters, and both primitive and reference
parameters are subject to method invocation conversions as necessary.
If the number of formal parameters required by the underlying constructor
is 0, the supplied initargs
array may be of length 0 or null.
If the constructor's declaring class is an inner class in a non-static context, the first argument to the constructor needs to be the enclosing instance; see The Java Language Specification, section 15.9.3.
If the required access and argument checks succeed and the instantiation will proceed, the constructor's declaring class is initialized if it has not already been initialized.
If the constructor completes normally, returns the newly created and initialized instance.
initargs
- array of objects to be passed as arguments to
the constructor call; values of primitive types are wrapped in
a wrapper object of the appropriate type (e.g. a float
in a {@link java.lang.Float Float})InstantiationException
- if the class that declares the
underlying constructor represents an abstract class.IllegalAccessException
- if this Constructor
object
enforces Java language access control and the underlying
constructor is inaccessible.IllegalArgumentException
- if the number of actual
and formal parameters differ; if an unwrapping
conversion for primitive arguments fails; or if,
after possible unwrapping, a parameter value
cannot be converted to the corresponding formal
parameter type by a method invocation conversion; if
this constructor pertains to an enum type.InvocationTargetException
- if the underlying constructor
throws an exception.public String toGenericString()
Constructor
,
including type parameters. The string is formatted as the
constructor access modifiers, if any, followed by an
angle-bracketed comma separated list of the constructor's type
parameters, if any, followed by the fully-qualified name of the
declaring class, followed by a parenthesized, comma-separated
list of the constructor's generic formal parameter types. A
space is used to separate access modifiers from one another and
from the type parameters or return type. If there are no type
parameters, the type parameter list is elided; if the type
parameter list is present, a space separates the list from the
class name. If the constructor is declared to throw
exceptions, the parameter list is followed by a space, followed
by the word "throws" followed by a
comma-separated list of the thrown exception types.
The only possible modifiers for constructors are the access modifiers public, protected or private. Only one of these may appear, or none if the constructor has default (package) access.
Constructor
,
include type parameterspublic String toString()
Constructor
. The string is
formatted as the constructor access modifiers, if any,
followed by the fully-qualified name of the declaring class,
followed by a parenthesized, comma-separated list of the
constructor's formal parameter types. For example:
public java.util.Hashtable(int,float)
The only possible modifiers for constructors are the access modifiers public, protected or private. Only one of these may appear, or none if the constructor has default (package) access.
toString
in class Object
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |