Serializable
public final class StaticClass extends Object implements Serializable
StandardOperation.NEW
operation. In Dynalink, Class
objects
are not treated specially and act as ordinary Java objects; you can use e.g.
GET:PROPERTY:superclass
as a property getter to
invoke clazz.getSuperclass()
. On the other hand, you can not use
Class
objects to access static members of a class, nor to create new
instances of the class using NEW
. This is consistent with how
Class
objects behave in Java: in Java, you write e.g.
new BitSet()
instead of new BitSet.class()
. Similarly, you
write System.out
and not System.class.out
. It is this aspect
of using a class name as the constructor and a namespace for static members
that StaticClass
embodies.
Objects of this class are recognized by the BeansLinker
as being
special, and operations on them will be linked against the represented class'
static members. The "class"
synthetic property is additionally
recognized and returns the Java Class
object, just as in Java
System.class
evaluates to the Class
object for the
System class. Conversely, Class
objects exposed through
BeansLinker
expose the "static"
synthetic property which
returns their StaticClass
object (there is no equivalent to this in
Java).
In summary, instances of this class act as namespaces for static members and as constructors for classes, much the same way as specifying a class name in Java language does, except that in Java this is just a syntactic element, while in Dynalink they are expressed as actual objects.
StaticClass
objects representing Java array types will act as
constructors taking a single int argument and create an array of the
specified size.
If the class has several constructors, StandardOperation.NEW
on
StaticClass
will try to select the most specific applicable
constructor. You might want to expose a mechanism in your language for
selecting a constructor with an explicit signature through
BeansLinker.getConstructorMethod(Class, String)
.
Modifier and Type | Method | Description |
---|---|---|
static StaticClass |
forClass(Class<?> clazz) |
Retrieves the
StaticClass instance for the specified class. |
Class<?> |
getRepresentedClass() |
Returns the represented Java class.
|
String |
toString() |
Returns a string representation of the object.
|
public static StaticClass forClass(Class<?> clazz)
StaticClass
instance for the specified class.clazz
- the class for which the static facet is requested.StaticClass
instance representing the specified class.public Class<?> getRepresentedClass()
public String toString()
java.lang.Object
toString
method returns a string that
"textually represents" this object. The result should
be a concise but informative representation that is easy for a
person to read.
It is recommended that all subclasses override this method.
The toString
method for class Object
returns a string consisting of the name of the class of which the
object is an instance, the at-sign character `@
', and
the unsigned hexadecimal representation of the hash code of the
object. In other words, this method returns a string equal to the
value of:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Submit a bug or feature
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
Copyright © 2015, 2017, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.
DRAFT 9-Ubuntu+0-9b151-2