org.springframework.cglib.core

Class AbstractClassGenerator<T>

java.lang.Object

org.springframework.cglib.core.AbstractClassGenerator<T>

All Implemented Interfaces:

org.springframework.cglib.core.ClassGenerator

Direct Known Subclasses:

Enhancer, KeyFactory.Generator

public abstract class AbstractClassGenerator<T>
extends Object
implements org.springframework.cglib.core.ClassGenerator

Abstract class for all code-generating CGLIB utilities. In addition to caching generated classes for performance, it provides hooks for customizing the ClassLoader, name of the generated class, and transformations applied before generation.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	AbstractClassGenerator.ClassLoaderData
protected static class	AbstractClassGenerator.Source

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractClassGenerator(AbstractClassGenerator.Source source)

Method Summary

Modifier and Type	Method and Description
protected Object	create(Object key)
protected abstract Object	firstInstance(Class type)
protected Class	generate(AbstractClassGenerator.ClassLoaderData data)
boolean	getAttemptLoad()
ClassLoader	getClassLoader()
protected String	getClassName()
static AbstractClassGenerator	getCurrent() Used internally by CGLIB.
protected abstract ClassLoader	getDefaultClassLoader()
org.springframework.cglib.core.NamingPolicy	getNamingPolicy()
protected ProtectionDomain	getProtectionDomain() Returns the protection domain to use when defining the class.
org.springframework.cglib.core.GeneratorStrategy	getStrategy()
boolean	getUseCache()
protected abstract Object	nextInstance(Object instance)
void	setAttemptLoad(boolean attemptLoad) If set, CGLIB will attempt to load classes from the specified ClassLoader before generating them.
void	setClassLoader(ClassLoader classLoader) Set the ClassLoader in which the class will be generated.
void	setContextClass(Class contextClass)
protected void	setNamePrefix(String namePrefix)
void	setNamingPolicy(org.springframework.cglib.core.NamingPolicy namingPolicy) Override the default naming policy.
void	setStrategy(org.springframework.cglib.core.GeneratorStrategy strategy) Set the strategy to use to create the bytecode from this generator.
void	setUseCache(boolean useCache) Whether use and update the static cache of generated classes for a class with the same properties.
protected Object	unwrapCachedValue(T cached)
protected T	wrapCachedClass(Class klass)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.springframework.cglib.core.ClassGenerator

generateClass

Constructor Detail

AbstractClassGenerator

protected AbstractClassGenerator(AbstractClassGenerator.Source source)

Method Detail

wrapCachedClass

protected T wrapCachedClass(Class klass)

unwrapCachedValue

protected Object unwrapCachedValue(T cached)

setNamePrefix

protected void setNamePrefix(String namePrefix)

getClassName

protected final String getClassName()

setClassLoader

public void setClassLoader(ClassLoader classLoader)

Set the ClassLoader in which the class will be generated. Concrete subclasses of AbstractClassGenerator (such as Enhancer) will try to choose an appropriate default if this is unset.

Classes are cached per-ClassLoader using a WeakHashMap, to allow the generated classes to be removed when the associated loader is garbage collected.

Parameters:

classLoader - the loader to generate the new class with, or null to use the default

setContextClass

public void setContextClass(Class contextClass)

setNamingPolicy

public void setNamingPolicy(org.springframework.cglib.core.NamingPolicy namingPolicy)

Override the default naming policy.

Parameters:

namingPolicy - the custom policy, or null to use the default

See Also:

DefaultNamingPolicy

getNamingPolicy

public org.springframework.cglib.core.NamingPolicy getNamingPolicy()

See Also:

setNamingPolicy(org.springframework.cglib.core.NamingPolicy)

setUseCache

public void setUseCache(boolean useCache)

Whether use and update the static cache of generated classes for a class with the same properties. Default is true.

getUseCache

public boolean getUseCache()

See Also:

setUseCache(boolean)

setAttemptLoad

public void setAttemptLoad(boolean attemptLoad)

If set, CGLIB will attempt to load classes from the specified ClassLoader before generating them. Because generated class names are not guaranteed to be unique, the default is false.

getAttemptLoad

public boolean getAttemptLoad()

setStrategy

public void setStrategy(org.springframework.cglib.core.GeneratorStrategy strategy)

Set the strategy to use to create the bytecode from this generator. By default an instance of DefaultGeneratorStrategy is used.

getStrategy

public org.springframework.cglib.core.GeneratorStrategy getStrategy()

See Also:

setStrategy(org.springframework.cglib.core.GeneratorStrategy)

getCurrent

public static AbstractClassGenerator getCurrent()

Used internally by CGLIB. Returns the AbstractClassGenerator that is being used to generate a class in the current thread.

getClassLoader

public ClassLoader getClassLoader()

getDefaultClassLoader

protected abstract ClassLoader getDefaultClassLoader()

getProtectionDomain

protected ProtectionDomain getProtectionDomain()

Returns the protection domain to use when defining the class.

Default implementation returns null for using a default protection domain. Sub-classes may override to use a more specific protection domain.

Returns:

the protection domain (null for using a default)

create

protected Object create(Object key)

generate

protected Class generate(AbstractClassGenerator.ClassLoaderData data)

firstInstance

protected abstract Object firstInstance(Class type)
                                 throws Exception

Throws:

Exception

nextInstance

protected abstract Object nextInstance(Object instance)
                                throws Exception

Throws:

Exception