Package io.ebean.enhance

Class Transformer

java.lang.Object

io.ebean.enhance.Transformer

All Implemented Interfaces:

ClassFileTransformer

public class Transformer
extends Object
implements ClassFileTransformer

A Class file Transformer that performs Ebean enhancement of entity beans, transactional methods and query bean enhancement.

This is used as both a java agent or via Maven and Gradle plugins etc.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	EBEAN_ASM_VERSION

Constructor Summary

Constructors

Constructor	Description
Transformer(ClassBytesReader bytesReader, String agentArgs, AgentManifest manifest)	Create a transformer for entity bean enhancement and transactional method enhancement.
Transformer(EnhanceContext enhanceContext)	Create with an EnhancementContext (for IDE Plugins mainly)
Transformer(ClassLoader classLoader, String agentArgs)

Method Summary

Modifier and Type	Method	Description
static void	agentmain(String agentArgs, Instrumentation inst)
static Transformer	get()	Return the Transformer instance.
EnhanceContext	getEnhanceContext()
int	getLogLevel()
List<CommonSuperUnresolved>	getUnresolved()	Return the list of unresolved common superclass issues.
static String	getVersion()	Return the version of the ebean-agent or "unknown" if the version can not be determined.
static Instrumentation	instrumentation()	Return the Instrumentation instance.
void	log(int level, String msg)
static URL[]	parseClassPaths(String extraClassPath)	Helper method to split semi-colon separated class paths into a URL array.
static void	premain(String agentArgs, Instrumentation inst)
void	setKeepUnresolved()	Set this to keep and report unresolved explicitly.
void	setLogout(MessageOutput logout)	Change the logout to something other than system out.
byte[]	transform(ClassLoader loader, String className, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer)
static void	verifyInitialization()	Use agent loader if necessary to initialise the transformer.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.instrument.ClassFileTransformer

transform

Field Details

EBEAN_ASM_VERSION

public static final int EBEAN_ASM_VERSION

See Also:

• Constant Field Values

Constructor Details

Transformer

public Transformer(ClassLoader classLoader,
 String agentArgs)

Transformer

public Transformer(EnhanceContext enhanceContext)

Create with an EnhancementContext (for IDE Plugins mainly)

Transformer

public Transformer(ClassBytesReader bytesReader,
 String agentArgs,
 AgentManifest manifest)

Create a transformer for entity bean enhancement and transactional method enhancement.

Parameters:

bytesReader - reads resources from class path for related inheritance and interfaces

agentArgs - command line arguments for debug level etc

Method Details

getVersion

public static String getVersion()

Return the version of the ebean-agent or "unknown" if the version can not be determined.

agentmain

public static void agentmain(String agentArgs,
 Instrumentation inst)

premain

public static void premain(String agentArgs,
 Instrumentation inst)

instrumentation

public static Instrumentation instrumentation()

Return the Instrumentation instance.

get

public static Transformer get()

Return the Transformer instance.

verifyInitialization

public static void verifyInitialization()

Use agent loader if necessary to initialise the transformer.

setKeepUnresolved

public void setKeepUnresolved()

Set this to keep and report unresolved explicitly.

setLogout

public void setLogout(MessageOutput logout)

Change the logout to something other than system out.

log

public void log(int level,
 String msg)

getLogLevel

public int getLogLevel()

getEnhanceContext

public EnhanceContext getEnhanceContext()

transform

public byte[] transform(ClassLoader loader,
 String className,
 Class<?> classBeingRedefined,
 ProtectionDomain protectionDomain,
 byte[] classfileBuffer)
                 throws IllegalClassFormatException

Specified by:

transform in interface ClassFileTransformer

Throws:

IllegalClassFormatException

getUnresolved

public List<CommonSuperUnresolved> getUnresolved()

Return the list of unresolved common superclass issues. This should be cleared after each use and can only be used with setKeepUnresolved().

parseClassPaths

public static URL[] parseClassPaths(String extraClassPath)

Helper method to split semi-colon separated class paths into a URL array.