com.videobug.agent.weaver

Class RuntimeWeaver

java.lang.Object

com.videobug.agent.weaver.RuntimeWeaver

All Implemented Interfaces:

AgentCommandExecutor, ClassFileTransformer

public class RuntimeWeaver
extends Object
implements ClassFileTransformer, AgentCommandExecutor

This class is the main program of SELogger as a javaagent.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RuntimeWeaver.Mode

Field Summary

Fields

Modifier and Type	Field and Description
static int	AGENT_SERVER_PORT

Constructor Summary

Constructors

Constructor and Description
RuntimeWeaver(String args, Instrumentation instrumentation) Process command line arguments and prepare an output directory

Method Summary

Modifier and Type	Method and Description
void	close() Close data streams if necessary
AgentCommandResponse	executeCommand(AgentCommandRequest agentCommandRequest)
boolean	isExcludedFromLogging(String className) This method checks whether a given class is a logging target or not.
boolean	isExcludedLocation(String location) This method checks whether a given class is a logging target or not.
boolean	isValid()
static void	premain(String agentArgs, Instrumentation instrumentation) The entry point of the agent.
byte[]	transform(ClassLoader loader, String className, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer) This method is called from JVM when loading a class.

Methods inherited from class java.lang.Object

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

Field Detail

AGENT_SERVER_PORT

public static final int AGENT_SERVER_PORT

See Also:

Constant Field Values

Constructor Detail

RuntimeWeaver

public RuntimeWeaver(String args,
                     Instrumentation instrumentation)

Process command line arguments and prepare an output directory

Parameters:

args - string arguments for weaver

instrumentation - object provided to the java agent for hooking up the class loader

Method Detail

premain

public static void premain(String agentArgs,
                           Instrumentation instrumentation)

The entry point of the agent. This method initializes the Weaver instance and setup a shutdown hook for releasing resources on the termination of a target program.

Parameters:

agentArgs - comes from command line.

instrumentation - is provided by the jvm

isValid

public boolean isValid()

Returns:

true if the logging is executable

close

public void close()

Close data streams if necessary

isExcludedFromLogging

public boolean isExcludedFromLogging(String className)

This method checks whether a given class is a logging target or not.

Parameters:

className - specifies a class. A package separator is "/".

Returns:

true if it is excluded from logging.

isExcludedLocation

public boolean isExcludedLocation(String location)

This method checks whether a given class is a logging target or not.

Parameters:

location - is a loaded location (e.g. JAR or file path).

Returns:

true if it is excluded from logging.

transform

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

This method is called from JVM when loading a class. This agent injects logging instructions here.

Specified by:

transform in interface ClassFileTransformer

Throws:

IllegalClassFormatException

executeCommand

public AgentCommandResponse executeCommand(AgentCommandRequest agentCommandRequest)
                                    throws Exception

Specified by:

executeCommand in interface AgentCommandExecutor

Throws:

Exception