Class ClassInfo
- java.lang.Object
-
- org.codehaus.groovy.reflection.ClassInfo
-
- All Implemented Interfaces:
Finalizable
public class ClassInfo extends Object implements Finalizable
Handle for all information we want to keep about the classThis class handles caching internally and its advisable to not store references directly to objects of this class. The static factory method
getClassInfo(Class)
should be used to retrieve an instance from the cache. Internally theClass
associated with aClassInfo
instance is kept asWeakReference
, so it not safe to reference and instance without the Class being either strongly or softly reachable.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interface
ClassInfo.ClassInfoAction
-
Field Summary
Fields Modifier and Type Field Description int
hash
-
Method Summary
-
-
-
Field Detail
-
hash
public final int hash
- See Also:
- Constant Field Values
-
-
Method Detail
-
getVersion
public int getVersion()
-
incVersion
public void incVersion()
-
getModifiedExpando
public ExpandoMetaClass getModifiedExpando()
-
clearModifiedExpandos
public static void clearModifiedExpandos()
-
getTheClass
public final Class<?> getTheClass()
Returns theClass
associated with thisClassInfo
.This method can return
null
if theClass
is no longer reachable through any strong or soft references. A non-null return value indicates that thisClassInfo
is valid.- Returns:
- the
Class
associated with thisClassInfo
, elsenull
-
getCachedClass
public CachedClass getCachedClass()
-
getArtifactClassLoader
public ClassLoaderForClassArtifacts getArtifactClassLoader()
-
remove
public static void remove(Class<?> cls)
Removes aClassInfo
from the cache. This is useful in cases where the Class is parsed from a script, such as when using GroovyClassLoader#parseClass, and is executed for its result but the Class is not retained or cached. Removing theClassInfo
associated with the Class will make the Class and its ClassLoader eligible for garbage collection sooner that it would otherwise.- Parameters:
cls
- the Class associated with the ClassInfo to remove from cache
-
getAllClassInfo
public static Collection<ClassInfo> getAllClassInfo()
-
onAllClassInfo
public static void onAllClassInfo(ClassInfo.ClassInfoAction action)
-
getStrongMetaClass
public MetaClass getStrongMetaClass()
-
setStrongMetaClass
public void setStrongMetaClass(MetaClass answer)
-
getWeakMetaClass
public MetaClass getWeakMetaClass()
-
setWeakMetaClass
public void setWeakMetaClass(MetaClass answer)
-
getMetaClassForClass
public MetaClass getMetaClassForClass()
-
getMetaClass
public final MetaClass getMetaClass()
Returns theMetaClass
for theClass
associated with thisClassInfo
. If noMetaClass
exists one will be created.It is not safe to call this method without a
Class
associated with thisClassInfo
. It is advisable to aways retrieve a ClassInfo instance from the cache by using the static factory methodgetClassInfo(Class)
to ensure the referenced Class is strongly reachable.- Returns:
- a
MetaClass
instance
-
size
public static int size()
-
fullSize
public static int fullSize()
-
lock
public void lock()
-
unlock
public void unlock()
-
hasPerInstanceMetaClasses
public boolean hasPerInstanceMetaClasses()
-
finalizeReference
public void finalizeReference()
- Specified by:
finalizeReference
in interfaceFinalizable
-
-