|
JavaTM 2 Platform Std. Ed. v1.4.2 |
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Objectjava.lang.reflect.AccessibleObject
java.lang.reflect.Constructor
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.
Member,
Class,
Class.getConstructors(),
Class.getConstructor(Class[]),
Class.getDeclaredConstructors()| Field Summary |
| Fields inherited from interface java.lang.reflect.Member |
DECLARED, PUBLIC |
| Method Summary | |
boolean |
equals(Object obj)
Compares this Constructor against the specified object. |
Class |
getDeclaringClass()
Returns the Class object representing the class that declares
the constructor represented by this Constructor object. |
Class[] |
getExceptionTypes()
Returns an array of Class objects that represent the types of
of exceptions declared to be thrown by the underlying constructor
represented by this Constructor object. |
int |
getModifiers()
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. |
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. |
int |
hashCode()
Returns a hashcode for this Constructor. |
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 |
toString()
Returns a string describing this Constructor. |
| Methods inherited from class java.lang.reflect.AccessibleObject |
isAccessible, setAccessible, setAccessible |
| Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
| Method Detail |
public Class getDeclaringClass()
Class object representing the class that declares
the constructor represented by this Constructor object.
getDeclaringClass in interface Memberpublic String getName()
getName in interface Memberpublic int getModifiers()
Constructor object, as an integer. The
Modifier class should be used to decode the modifiers.
getModifiers in interface MemberModifierpublic 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 Class[] getExceptionTypes()
Class objects that represent the types of
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 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 Objectobj - the reference object with which to compare.
true if this object is the same as the obj
argument; false otherwise.Object.hashCode(),
Hashtablepublic int hashCode()
Constructor. The hashcode is
the same as the hashcode for the underlying constructor's
declaring class name.
hashCode in class ObjectObject.equals(java.lang.Object),
Hashtablepublic 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
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 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 Float)
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.
InstantiationException - if the class that declares the
underlying constructor represents an abstract class.
InvocationTargetException - if the underlying constructor
throws an exception.
ExceptionInInitializerError - if the initialization provoked
by this method fails.
|
JavaTM 2 Platform Std. Ed. v1.4.2 |
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.