| java.lang.Object java.lang.reflect.AccessibleObject java.lang.reflect.Constructor
Constructor Summary | |
| Constructor(Class<T> declaringClass, Class[] parameterTypes, Class[] checkedExceptions, int modifiers, int slot, String signature, byte[] annotations, byte[] parameterAnnotations) Package-private constructor used by ReflectAccess to enable
instantiation of these objects in Java code from the java.lang
package via sun.reflect.LangReflectAccess. |
Method Summary | |
Constructor<T> | copy() Package-private routine (exposed to java.lang.Class via
ReflectAccess) which returns a copy of this Constructor. | public boolean | equals(Object obj) Compares this
Constructor against the specified object.
Returns true if the objects are the same. | public T | getAnnotation(Class<T> annotationClass) | ConstructorAccessor | getConstructorAccessor() | public Annotation[] | getDeclaredAnnotations() | public Class<T> | getDeclaringClass() Returns the
Class object representing the class that declares
the constructor represented by this
Constructor object. | public Class>[] | getExceptionTypes() 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. | public Type[] | getGenericExceptionTypes() Returns an array of
Type objects that represent the
exceptions declared to be thrown by this
Constructor object. | public Type[] | getGenericParameterTypes() Returns an array of
Type objects that represent the formal
parameter types, in declaration order, of the method represented by
this
Constructor object. | public int | getModifiers() Returns the Java language modifiers for the constructor
represented by this
Constructor object, as an integer. | public String | getName() Returns the name of this constructor, as a string. | public Annotation[][] | getParameterAnnotations() Returns an array of arrays that represent the annotations on the formal
parameters, in declaration order, of the method represented by
this
Constructor object. | public Class>[] | getParameterTypes() Returns an array of
Class objects that represent the formal
parameter types, in declaration order, of the constructor
represented by this
Constructor object. | byte[] | getRawAnnotations() | byte[] | getRawParameterAnnotations() | String | getSignature() | int | getSlot() | public TypeVariable<Constructor<T>>[] | getTypeParameters() Returns an array of
TypeVariable objects that represent the
type variables declared by the generic declaration represented by this
GenericDeclaration object, in declaration order. | public int | hashCode() Returns a hashcode for this
Constructor . | public boolean | isSynthetic() Returns
true if this constructor is a synthetic
constructor; returns
false otherwise. | public boolean | isVarArgs() Returns
true if this constructor was declared to take
a variable number of arguments; returns
false otherwise. | public T | 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.
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.
Parameters: initargs - array of objects to be passed as arguments tothe constructor call; values of primitive types are wrapped ina wrapper object of the appropriate type (e.g. | void | setConstructorAccessor(ConstructorAccessor accessor) | public String | toGenericString() Returns a string describing this
Constructor ,
including type parameters. | public String | toString() Returns a string describing this
Constructor . |
Constructor | Constructor(Class<T> declaringClass, Class[] parameterTypes, Class[] checkedExceptions, int modifiers, int slot, String signature, byte[] annotations, byte[] parameterAnnotations)(Code) | | Package-private constructor used by ReflectAccess to enable
instantiation of these objects in Java code from the java.lang
package via sun.reflect.LangReflectAccess.
|
copy | Constructor<T> copy()(Code) | | Package-private routine (exposed to java.lang.Class via
ReflectAccess) which returns a copy of this Constructor. The copy's
"root" field points to this Constructor.
|
equals | public boolean equals(Object obj)(Code) | | Compares this
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.
|
getConstructorAccessor | ConstructorAccessor getConstructorAccessor()(Code) | | |
getDeclaredAnnotations | public Annotation[] getDeclaredAnnotations()(Code) | | since: 1.5 |
getDeclaringClass | public Class<T> getDeclaringClass()(Code) | | Returns the
Class object representing the class that declares
the constructor represented by this
Constructor object.
|
getExceptionTypes | public Class>[] getExceptionTypes()(Code) | | 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. Returns an array of
length 0 if the constructor declares no exceptions in its
throws clause.
the exception types declared as being thrown by theconstructor this object represents |
getGenericExceptionTypes | public Type[] getGenericExceptionTypes()(Code) | | Returns an array of
Type objects that represent the
exceptions declared to be thrown by this
Constructor object.
Returns an array of length 0 if the underlying method declares
no exceptions in its
throws clause.
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.
an array of Types that represent the exception typesthrown by the underlying method throws: GenericSignatureFormatError - if the generic method signature does not conform to the formatspecified in the Java Virtual Machine Specification, 3rd edition throws: TypeNotPresentException - if the underlying method's throws clause refers to a non-existent type declaration throws: MalformedParameterizedTypeException - ifthe underlying method's throws clause refers to aparameterized type that cannot be instantiated for any reason since: 1.5 |
getGenericParameterTypes | public Type[] getGenericParameterTypes()(Code) | | Returns an array of
Type objects that represent the formal
parameter types, in declaration order, of the method represented by
this
Constructor object. Returns an array of length 0 if the
underlying method takes no parameters.
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.
an array of Type s that represent the formalparameter types of the underlying method, in declaration order throws: GenericSignatureFormatError - if the generic method signature does not conform to the formatspecified in the Java Virtual Machine Specification, 3rd edition throws: TypeNotPresentException - if any of the parametertypes of the underlying method refers to a non-existent typedeclaration throws: MalformedParameterizedTypeException - if any ofthe underlying method's parameter types refer to a parameterizedtype that cannot be instantiated for any reason since: 1.5 |
getModifiers | public int getModifiers()(Code) | | Returns the Java language modifiers for the constructor
represented by this
Constructor object, as an integer. The
Modifier class should be used to decode the modifiers.
See Also: Modifier |
getName | public String getName()(Code) | | Returns the name of this constructor, as a string. This is
always the same as the simple name of the constructor's declaring
class.
|
getParameterAnnotations | public Annotation[][] getParameterAnnotations()(Code) | | Returns an array of arrays that represent the annotations on the formal
parameters, in declaration order, of the method represented by
this
Constructor object. (Returns an array of length zero if the
underlying method is parameterless. If the method has one or more
parameters, a nested array of length zero is returned for each parameter
with no annotations.) The annotation objects contained in the returned
arrays are serializable. The caller of this method is free to modify
the returned arrays; it will have no effect on the arrays returned to
other callers.
an array of arrays that represent the annotations on the formalparameters, in declaration order, of the method represented by thisConstructor object since: 1.5 |
getParameterTypes | public Class>[] getParameterTypes()(Code) | | Returns an array of
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.
the parameter types for the constructor this objectrepresents |
getRawAnnotations | byte[] getRawAnnotations()(Code) | | |
getRawParameterAnnotations | byte[] getRawParameterAnnotations()(Code) | | |
getTypeParameters | public TypeVariable<Constructor<T>>[] getTypeParameters()(Code) | | Returns an array of
TypeVariable objects that represent the
type variables declared by the generic declaration represented by this
GenericDeclaration object, in declaration order. Returns an
array of length 0 if the underlying generic declaration declares no type
variables.
an array of TypeVariable objects that representthe type variables declared by this generic declaration throws: GenericSignatureFormatError - if the genericsignature of this generic declaration does not conform tothe format specified in the Java Virtual Machine Specification,3rd edition since: 1.5 |
hashCode | public int hashCode()(Code) | | Returns a hashcode for this
Constructor . The hashcode is
the same as the hashcode for the underlying constructor's
declaring class name.
|
isSynthetic | public boolean isSynthetic()(Code) | | Returns
true if this constructor is a synthetic
constructor; returns
false otherwise.
true if and only if this constructor is a syntheticconstructor as defined by the Java Language Specification. since: 1.5 |
isVarArgs | public boolean isVarArgs()(Code) | | Returns
true if this constructor was declared to take
a variable number of arguments; returns
false otherwise.
true if an only if this constructor was declared totake a variable number of arguments. since: 1.5 |
newInstance | public T newInstance(Object... initargs) throws InstantiationException, IllegalAccessException, IllegalArgumentException, InvocationTargetException(Code) | | 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.
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.
Parameters: initargs - array of objects to be passed as arguments tothe constructor call; values of primitive types are wrapped ina wrapper object of the appropriate type (e.g. a float in a java.lang.Float Float) a new object created by calling the constructorthis object represents exception: IllegalAccessException - if this Constructor objectenforces Java language access control and the underlyingconstructor is inaccessible. exception: IllegalArgumentException - if the number of actualand formal parameters differ; if an unwrappingconversion for primitive arguments fails; or if,after possible unwrapping, a parameter valuecannot be converted to the corresponding formalparameter type by a method invocation conversion; ifthis constructor pertains to an enum type. exception: InstantiationException - if the class that declares theunderlying constructor represents an abstract class. exception: InvocationTargetException - if the underlying constructorthrows an exception. exception: ExceptionInInitializerError - if the initialization provokedby this method fails. |
setConstructorAccessor | void setConstructorAccessor(ConstructorAccessor accessor)(Code) | | |
toGenericString | public String toGenericString()(Code) | | Returns a string describing this
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.
If this constructor was declared to take a variable number of
arguments, instead of denoting the last parameter as
"Type[]", it is denoted as
"Type...".
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.
a string describing this Constructor ,include type parameters since: 1.5 |
toString | public String toString()(Code) | | Returns a string describing this
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.
|
|
|