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.

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
static void	agentmain(String agentArgs, Instrumentation inst)
static Transformer	get() Return the Transformer instance.
int	getLogLevel()
List<TransactionalMethodKey>	getTransactionProfilingKeys() Return the transaction profiling keys.
List<CommonSuperUnresolved>	getUnresolved() Return the list of unresolved common superclass issues.
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

Constructor Detail

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 Detail

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()

transform

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

Specified by:

transform in interface ClassFileTransformer

Throws:

IllegalClassFormatException

getTransactionProfilingKeys

public List<TransactionalMethodKey> getTransactionProfilingKeys()

Return the transaction profiling keys. We use these to decode a the transaction profile.

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.