com.avaje.ebean.enhance.agent

Class Transformer

java.lang.Object

com.avaje.ebean.enhance.agent.Transformer

All Implemented Interfaces:

ClassFileTransformer

public class Transformer
extends Object
implements ClassFileTransformer

A Class file Transformer that enhances entity beans.

This is used as both a javaagent or via an ANT task (or other off line approach).

Constructor Summary

Constructors

Constructor and Description
Transformer(ClassBytesReader bytesReader, String agentArgs, Set<String> packages) Create a transformer for entity bean enhancement and transactional method enhancement.
Transformer(String extraClassPath, String agentArgs)
Transformer(URL[] extraClassPath, String agentArgs) Create a transformer for entity bean enhancement and transactional method enhancement.

Method Summary

Modifier and Type	Method and Description
static void	agentmain(String agentArgs, Instrumentation inst)
int	getLogLevel()
Map<String,List<Throwable>>	getUnexpectedExceptions() Return a map of exceptions keyed by className.
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	setLogout(MessageOutput logout) Change the logout to something other than system out.
byte[]	transform(ClassLoader loader, String className, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer)

Methods inherited from class java.lang.Object

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

Constructor Detail

Transformer

public Transformer(String extraClassPath,
                   String agentArgs)

Transformer

public Transformer(URL[] extraClassPath,
                   String agentArgs)

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

Transformer

public Transformer(ClassBytesReader bytesReader,
                   String agentArgs,
                   Set<String> packages)

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

packages - limit enhancement to specified packages

Method Detail

premain

public static void premain(String agentArgs,
                           Instrumentation inst)

agentmain

public static void agentmain(String agentArgs,
                             Instrumentation inst)
                      throws Exception

Throws:

Exception

getUnexpectedExceptions

public Map<String,List<Throwable>> getUnexpectedExceptions()

Return a map of exceptions keyed by className.

These exceptions were thrown/caught as part of the transformation process.

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

parseClassPaths

public static URL[] parseClassPaths(String extraClassPath)

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