agent

Dynamically load a Java Agent or acquire java.lang.instrument.Instrumentation via SPI

• Load a Java Agent - dynamically, without prerequisite JAR file or JVM arguments
• Get hold of an Instrumentation instance with SPI (using only this module as a runtime dependency)

For use in JUnit tests, please see the other module instrumental.agent.junit which already has JUnit 4 Rules and JUnit 5 Extensions.

Dependency Graph

Examples

Instrumentation via SPI

	Instrumentation instrumentation = ServiceLoader.load(Instrumentation.class)
			.iterator().next();

Dynamically Load an Agent Class

	String agentArguments = "arbitrary.arguments=go.here";
	Path stubJar = DynamicAgent.loadAgent(StubAgent.class, agentArguments);

• agent
• /ˈeɪdʒ(ə)nt/  
• noun:
  1. a person who acts on behalf of another person or group.
     synonyms: spokeswoman, emissary, envoy, frontman, mouthpiece
  2. a person or company that provides a particular service, typically one that involves organising transactions between two other parties.
     synonyms: agency, concern
  3. a person who works secretly to obtain information for a government or other official body.
     synonyms: spy, operative, fifth columnist
  4. a person or thing that takes an active role or produces a specified effect.
     synonyms: medium, means, vehicle, instrument