Package java.lang.instrument

Provides services that allow Java programming language agents to instrument programs running on the JVM.

See: Description

Interface Description
ClassFileTransformer

An agent provides an implementation of this interface in order to transform class files.
Instrumentation

This class provides services needed to instrument Java programming language code.
Class Description
ClassDefinition

This class serves as a parameter block to the Instrumentation.redefineClasses method.
Exception Description
IllegalClassFormatException

Thrown by an implementation of ClassFileTransformer.transform when its input parameters are invalid.
UnmodifiableClassException

Thrown by an implementation of Instrumentation.redefineClasses when one of the specified classes cannot be modified.

Package java.lang.instrument Description

Provides services that allow Java programming language agents to instrument programs running on the JVM. The mechanism for instrumentation is modification of the byte-codes of methods.

Note: developers/admininstrators are responsible for verifying the trustworthiness of content and structure of the Java Agents they deploy, since those are able to arbitrarily transform the bytecode from other JAR files. Since that happens after the Jars containing the bytecode have been verified as trusted, the trustworthiness of a Java Agent can determine the trust towards the entire program.

Since:
JDK1.5

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/javase/8/docs/api/java/lang/instrument/package-summary.html