org.openimaj.aop.agent

Class AgentLoader

java.lang.Object

org.openimaj.aop.agent.AgentLoader

public class AgentLoader
extends Object

Dynamic agent loader. Provides methods to extract an agent jar with a specific agent class, and to attempt to dynamically load agents on Oracle JVMs (including OpenJDK). Dynamic loading won't work on all JVMs (i.e. IBMs), but the standard "-javaagent" commandline option can be used instead. If dynamic loading fails, instructions on using the command line flag will be printed to stderr.

Author:

Jonathon Hare (jsh2@ecs.soton.ac.uk)

Constructor Summary

Constructors

Constructor and Description
AgentLoader()

Method Summary

Modifier and Type	Method and Description
static void	createAgentJar(File file, Class<?> agentClass) Create an agent jar file with the required manifest entries.
static void	loadAgent(Class<?> agentClass) Attempt to dynamically load the given agent class

Methods inherited from class java.lang.Object

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

Constructor Detail

AgentLoader

public AgentLoader()

Method Detail

createAgentJar

public static void createAgentJar(File file,
                                  Class<?> agentClass)
                           throws IOException

Create an agent jar file with the required manifest entries.

Parameters:

file - the location to create the jar

agentClass - the agent class

Throws:

IOException - if an error occurs

loadAgent

public static void loadAgent(Class<?> agentClass)
                      throws IOException

Attempt to dynamically load the given agent class

Parameters:

agentClass - the agent class

Throws:

IOException - if an error occurs creating the agent jar