Reflection

java.lang.Object
- net.algart.lib.Reflection

All Implemented Interfaces:

TrueStatic
```
public final class Reflection
extends java.lang.Object
implements TrueStatic
```
Dynamic Class Overloading system and miscellaneous reflection tools.

Since:

JDK1.4

Version:

1.1

Author:

Daniel Alievsky

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`Reflection.ClassLoaderFactory` ClassLoaderFactory interface should produce some ClassLoader for given ClassLoader identifier.
`static class`	`Reflection.DynamicClassOverloader`
`static interface`	`Reflection.WithClassPath` This interface should be implemented by a ClassLoader ineritor that allows to get list of all class paths where it searches the classes.

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`CLASSES_TEMPORARY_SUBDIRECTORY_PREFIX`
`static int`	`DEBUG_LEVEL`
`static java.util.Set`	`JAVA_CLASS_PATH` The result of `System.getProperty("java.class.path","")` call splitted into a set of String objects (one path in one String).
`static boolean`	`USE_SYSTEM_CLASS_LOADER_AT_FIRST` If true, then `loadClass(String)` call (without `loaderId`) will always use the system class loader (`Class.forName(className)` call) until first call of `invalidateClasses()`

Method Summary

Methods
Modifier and Type	Method and Description
`static java.util.Map`	`getAllClassesId()` getAllClassesId() returns an unmodifiable map containing `getClassesId(...)` values for all class loaders known to DCO system.
`static long`	`getClassesId(java.lang.Object loaderId)` getClassesId(loaderId) allows to check whether DCO class loader with given identifier has been invalidated.
`static java.io.File`	`getClassFile(java.lang.Class clazz)`
`static java.lang.ClassLoader`	`getClassLoader(java.lang.Object loaderId)` Returns DCO class loader used by loadClass(...,loaderId)
`static Reflection.ClassLoaderFactory`	`getClassLoaderFactory()`
`static java.lang.String`	`getClassName(java.lang.Class clazz, char nestedClassSeparator)`
`static java.net.URL`	`getClassURL(java.lang.Class clazz)`
`static java.lang.StackTraceElement[]`	`getCurrentStackTrace()`
`static java.lang.StackTraceElement[]`	`getCurrentStackTrace(int beginIndex, int len)`
`static java.util.Set`	`getFileSystemJavaClassPath()` Returns a part of the defaultJava CLASSPATH that corresponds to usual subdirectories, not ZIP or JAR.
`static long`	`getSummaryClassesId()` Allows to check whether class loading system has been invalidated It returns 0 after first loading `Reflection` class; it's result increments after each call of `invalidateClasses()` or `invalidateClasses(Object)`.
`static java.io.File`	`getTempClassesDirectory()` Returns the special "temp classes directory" that is added to CLASSPATH by all DCO class loaders.
`static void`	`invalidateClasses()` Invalidates all classes loaded by DCO system All class files will be reloaded by the next `loadClass()`
`static void`	`invalidateClasses(java.lang.Object loaderId)` Invalidates all classes loaded by the given DCO class loader All these class files will be reloaded by the next `loadClass()`
`static boolean`	`isTempClassesDirectoryPropertySet()` Returns true if "net.algart.lib.Reflection.TEMP_CLASSES_DIRECTORY" system property (more precisely, the result of `GlobalProperties.getClassProperty(Reflection.class,"TEMP_CLASSES_DIRECTORY")` call) is not null.
`static boolean`	`isTrueStatic(java.lang.Class clazz)`
`static boolean`	`isTrueStaticImplemented(java.lang.Class clazz)` Returns true if the given class (or some ot it's ancestors) implements an interface called "`<some_package>.TrueStatic`".
`static java.lang.Class`	`loadClass(java.lang.String name, boolean initialize, java.lang.Object loaderId)` Loads a .class file by DCO system; allows to specify whether static initializing is required.
`static void`	`setClassLoaderFactory(Reflection.ClassLoaderFactory classLoaderFactory)`
`static java.util.Set`	`splitClassPath(java.lang.String classPath)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DEBUG_LEVEL
```
public static final int DEBUG_LEVEL
```
  - USE_SYSTEM_CLASS_LOADER_AT_FIRST
```
public static final boolean USE_SYSTEM_CLASS_LOADER_AT_FIRST
```
    If true, then loadClass(String) call (without loaderId) will always use the system class loader (Class.forName(className) call) until first call of invalidateClasses()
  - JAVA_CLASS_PATH
```
public static final java.util.Set JAVA_CLASS_PATH
```
    The result of System.getProperty("java.class.path","") call splitted into a set of String objects (one path in one String). If Java CLASSPATH cannot be got due to security reasons, this constant contains an empty set.
  - CLASSES_TEMPORARY_SUBDIRECTORY_PREFIX
```
public static final java.lang.String CLASSES_TEMPORARY_SUBDIRECTORY_PREFIX
```
    See Also:
    Constant Field Values
- Method Detail
  - splitClassPath
```
public static java.util.Set splitClassPath(java.lang.String classPath)
```
  - getTempClassesDirectory
```
public static java.io.File getTempClassesDirectory()
                                            throws java.io.IOException
```
    Returns the special "temp classes directory" that is added to CLASSPATH by all DCO class loaders. This directory is:
    - the result of GlobalProperties.getClassProperty(Reflection.class,"TEMP_CLASSES_DIRECTORY") call if it is not null;
    - the result of Directory.createTempDirectory(CLASSES_TEMPORARY_SUBDIRECTORY_PREFIX, "").getPath()} call in other case.
    In the first case this directory must be included in the standard Java CLASSPATH. In other case, Reflection class will produce an assertion exception while static initialization.
    In the second case this directory is automatically created, as a secondary effect of calling this method, and will be automatically deleted on the program shutdown. I/O exception can occur while creating temp directory. If it is occurred while creating an instance of Reflection.DynamicClassOverloader, then the exception is ignored, but the created class loader will not include "temp classes directory" into it's CLASSPATH.
    Throws:
    
    java.io.IOException
  - isTempClassesDirectoryPropertySet
```
public static boolean isTempClassesDirectoryPropertySet()
```
    Returns true if "net.algart.lib.Reflection.TEMP_CLASSES_DIRECTORY" system property (more precisely, the result of GlobalProperties.getClassProperty(Reflection.class,"TEMP_CLASSES_DIRECTORY") call) is not null. In this case, you can get it's value by getTempClassesDirectory() method.
    
    Returns:
    true if "net.algart.lib.Reflection.TEMP_CLASSES_DIRECTORY" system property is set
    See Also:
    getTempClassesDirectory()
  - getSummaryClassesId
```
public static long getSummaryClassesId()
```
    Allows to check whether class loading system has been invalidated It returns 0 after first loading Reflection class; it's result increments after each call of invalidateClasses() or invalidateClasses(Object).
    
    Returns:
    an integer value that is incremented every time when DCO is invalidated
  - getClassesId
```
public static long getClassesId(java.lang.Object loaderId)
```
    getClassesId(loaderId) allows to check whether DCO class loader with given identifier has been invalidated. It returns 0 if this class loader has never used
  - getAllClassesId
```
public static java.util.Map getAllClassesId()
```
    getAllClassesId() returns an unmodifiable map containing getClassesId(...) values for all class loaders known to DCO system. This map contains instances of ClassesId class, that contains only 1 field: "long value"
  - invalidateClasses
```
public static void invalidateClasses()
```
    Invalidates all classes loaded by DCO system All class files will be reloaded by the next loadClass()
  - invalidateClasses
```
public static void invalidateClasses(java.lang.Object loaderId)
```
    Invalidates all classes loaded by the given DCO class loader All these class files will be reloaded by the next loadClass()
    
    Parameters:
    loaderId - Identifier of class loader that should be invalidated. Can be null; it is not equivalent to invalidateClasses()
  - loadClass
```
public static java.lang.Class loadClass(java.lang.String name,
                        boolean initialize,
                        java.lang.Object loaderId)
                                 throws java.lang.ClassNotFoundException
```
    Loads a .class file by DCO system; allows to specify whether static initializing is required.
    Do not use this method for true-static classes!
    
    Parameters:
    name - Full class name (with package)
    initialize - whether the class must be initialized
    loaderId - Identifier of class loader that should be used
    
    Throws:
    
    java.lang.ClassNotFoundException
  - getClassLoader
```
public static java.lang.ClassLoader getClassLoader(java.lang.Object loaderId)
```
    Returns DCO class loader used by loadClass(...,loaderId)
  - getFileSystemJavaClassPath
```
public static java.util.Set getFileSystemJavaClassPath()
```
    Returns a part of the defaultJava CLASSPATH that corresponds to usual subdirectories, not ZIP or JAR. Result is a set of String objects.
  - isTrueStaticImplemented
```
public static boolean isTrueStaticImplemented(java.lang.Class clazz)
```
    Returns true if the given class (or some ot it's ancestors) implements an interface called "<some_package>.TrueStatic". See TrueStatic interface.
    
    Parameters:
    clazz - Some checked class is true-static: DCO system will not overload it.
    
    Returns:
    true, if the given class implements some interface named "TrueStatic"
  - isTrueStatic
```
public static boolean isTrueStatic(java.lang.Class clazz)
```
  - setClassLoaderFactory
```
public static void setClassLoaderFactory(Reflection.ClassLoaderFactory classLoaderFactory)
```
  - getClassLoaderFactory
```
public static Reflection.ClassLoaderFactory getClassLoaderFactory()
```
  - getClassURL
```
public static java.net.URL getClassURL(java.lang.Class clazz)
```
  - getClassFile
```
public static java.io.File getClassFile(java.lang.Class clazz)
```
  - getClassName
```
public static java.lang.String getClassName(java.lang.Class clazz,
                            char nestedClassSeparator)
```
  - getCurrentStackTrace
```
public static java.lang.StackTraceElement[] getCurrentStackTrace()
```
  - getCurrentStackTrace
```
public static java.lang.StackTraceElement[] getCurrentStackTrace(int beginIndex,
                                                 int len)
```

Class Reflection

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEBUG_LEVEL

USE_SYSTEM_CLASS_LOADER_AT_FIRST

JAVA_CLASS_PATH

CLASSES_TEMPORARY_SUBDIRECTORY_PREFIX

Method Detail

splitClassPath

getTempClassesDirectory

isTempClassesDirectoryPropertySet

getSummaryClassesId

getClassesId

getAllClassesId

invalidateClasses

invalidateClasses

loadClass

getClassLoader

getFileSystemJavaClassPath

isTrueStaticImplemented

isTrueStatic

setClassLoaderFactory

getClassLoaderFactory

getClassURL

getClassFile

getClassName

getCurrentStackTrace

getCurrentStackTrace