The ASM framework is organized
around the ClassVisitor,
FieldVisitor,
MethodVisitor and
AnnotationVisitor abstract classes,
which allow one to visit the fields, methods and annotations of a class,
including the bytecode instructions of each method.
In addition to these main abstract classes, ASM provides a ClassReader class, that can parse an
existing class and make a given visitor visit it. ASM also provides
a ClassWriter class, which is
a visitor that generates Java class files.
In order to generate a class from scratch, only the ClassWriter class is necessary. Indeed,
in order to generate a class, one must just call its visitXxx
methods with the appropriate arguments to generate the desired fields
and methods.
In order to modify existing classes, one must use a ClassReader class to analyze
the original class, a class modifier, and a ClassWriter to construct the modified class. The class modifier
is just a ClassVisitor
that delegates most of the work to another ClassVisitor, but that sometimes changes some parameter values,
or call additional methods, in order to implement the desired
modification process. In order to make it easier to implement such
class modifiers, the ClassVisitor and MethodVisitor
classes delegate by default all the method calls they receive to an
optional visitor.
| Modifier and Type | Interface and Description |
|---|---|
| public interface | Opcodes
The JVM opcodes, access flags and array type codes. |
| Modifier and Type | Class and Description |
|---|---|
| public abstract class | AnnotationVisitor
A visitor to visit a Java annotation. |
| pack-priv class | AnnotationWriter
An |
| public class | Attribute
A non standard class, field, method or Code attribute, as defined in the Java Virtual Machine Specification (JVMS). |
| public class | ByteVector
A dynamically extensible vector of bytes. |
| public class | ClassReader
A parser to make a |
| public class | ClassTooLargeException
Exception thrown when the constant pool of a class produced by a |
| public abstract class | ClassVisitor
A visitor to visit a Java class. |
| public class | ClassWriter
A |
| public class | ConstantDynamic
A constant whose value is computed at runtime, with a bootstrap method. |
| pack-priv class | Constants
Defines additional JVM opcodes, access flags and constants which are not part of the ASM public API. |
| pack-priv class | Context
Information about a class being parsed in a |
| pack-priv class | CurrentFrame
Information about the input stack map frame at the "current" instruction of a method. |
| pack-priv class | Edge
An edge in the control flow graph of a method. |
| public abstract class | FieldVisitor
A visitor to visit a Java field. |
| pack-priv class | FieldWriter
A |
| pack-priv class | Frame
The input and output stack map frames of a basic block. |
| public class | Handle
A reference to a field or a method. |
| pack-priv class | Handler
Information about an exception handler. |
| public class | Label
A position in the bytecode of a method. |
| public class | MethodTooLargeException
Exception thrown when the Code attribute of a method produced by a |
| public abstract class | MethodVisitor
A visitor to visit a Java method. |
| pack-priv class | MethodWriter
A |
| public abstract class | ModuleVisitor
A visitor to visit a Java module. |
| pack-priv class | ModuleWriter
A |
| public abstract class | RecordComponentVisitor
A visitor to visit a record component. |
| pack-priv class | |
| pack-priv abstract class | Symbol
An entry of the constant pool, of the BootstrapMethods attribute, or of the (ASM specific) type table of a class. |
| pack-priv class | SymbolTable
The constant pool entries, the BootstrapMethods attribute entries and the (ASM specific) type table entries of a class. |
| public class | Type
A Java field or method type. |
| public class | TypePath
The path to a type argument, wildcard bound, array element type, or static inner type within an enclosing type. |
| public class | TypeReference
A reference to a type appearing in a class, field or method declaration, or on an instruction. |