public class ClassWriter
extends org.springframework.asm.ClassVisitor
ClassVisitor
that generates classes in bytecode form. More
precisely this visitor generates a byte array conforming to the Java class
file format. It can be used alone, to generate a Java class "from scratch",
or with one or more ClassReader
and adapter class visitor
to generate a modified class from one or more existing Java classes.Modifier and Type | Field and Description |
---|---|
static int |
COMPUTE_FRAMES
Flag to automatically compute the stack map frames of methods from
scratch.
|
static int |
COMPUTE_MAXS
Flag to automatically compute the maximum stack size and the maximum
number of local variables of methods.
|
Constructor and Description |
---|
ClassWriter(org.springframework.asm.ClassReader classReader,
int flags)
Constructs a new
ClassWriter object and enables optimizations for
"mostly add" bytecode transformations. |
ClassWriter(int flags)
Constructs a new
ClassWriter object. |
Modifier and Type | Method and Description |
---|---|
protected ClassLoader |
getClassLoader() |
protected String |
getCommonSuperClass(String type1,
String type2)
Returns the common super type of the two given types.
|
int |
newClass(String value)
Adds a class reference to the constant pool of the class being build.
|
int |
newConst(Object cst)
Adds a number or string constant to the constant pool of the class being
build.
|
int |
newField(String owner,
String name,
String desc)
Adds a field reference to the constant pool of the class being build.
|
int |
newHandle(int tag,
String owner,
String name,
String desc)
Adds a handle to the constant pool of the class being build.
|
int |
newInvokeDynamic(String name,
String desc,
org.springframework.asm.Handle bsm,
Object... bsmArgs)
Adds an invokedynamic reference to the constant pool of the class being
build.
|
int |
newMethod(String owner,
String name,
String desc,
boolean itf)
Adds a method reference to the constant pool of the class being build.
|
int |
newMethodType(String methodDesc)
Adds a method type reference to the constant pool of the class being
build.
|
int |
newNameType(String name,
String desc)
Adds a name and type to the constant pool of the class being build.
|
int |
newUTF8(String value)
Adds an UTF8 string to the constant pool of the class being build.
|
byte[] |
toByteArray()
Returns the bytecode of the class that was build with this class writer.
|
void |
visit(int version,
int access,
String name,
String signature,
String superName,
String[] interfaces) |
org.springframework.asm.AnnotationVisitor |
visitAnnotation(String desc,
boolean visible) |
void |
visitAttribute(org.springframework.asm.Attribute attr) |
void |
visitEnd() |
org.springframework.asm.FieldVisitor |
visitField(int access,
String name,
String desc,
String signature,
Object value) |
void |
visitInnerClass(String name,
String outerName,
String innerName,
int access) |
org.springframework.asm.MethodVisitor |
visitMethod(int access,
String name,
String desc,
String signature,
String[] exceptions) |
void |
visitOuterClass(String owner,
String name,
String desc) |
void |
visitSource(String file,
String debug) |
org.springframework.asm.AnnotationVisitor |
visitTypeAnnotation(int typeRef,
org.springframework.asm.TypePath typePath,
String desc,
boolean visible) |
public static final int COMPUTE_MAXS
visitMaxs
method of the
MethodVisitor
returned by the visitMethod
method will be ignored, and computed automatically from the signature and
the bytecode of each method.ClassWriter(int)
,
Constant Field Valuespublic static final int COMPUTE_FRAMES
MethodVisitor.visitFrame(int, int, java.lang.Object[], int, java.lang.Object[])
method are ignored, and the stack map
frames are recomputed from the methods bytecode. The arguments of the
visitMaxs
method are also ignored and
recomputed from the bytecode. In other words, computeFrames implies
computeMaxs.ClassWriter(int)
,
Constant Field Valuespublic ClassWriter(int flags)
ClassWriter
object.flags
- option flags that can be used to modify the default behavior
of this class. See COMPUTE_MAXS
,
COMPUTE_FRAMES
.public ClassWriter(org.springframework.asm.ClassReader classReader, int flags)
ClassWriter
object and enables optimizations for
"mostly add" bytecode transformations. These optimizations are the
following:
ClassReader
receives MethodVisitor
objects that come from
a ClassWriter
(and not from any other ClassVisitor
instance).classReader
- the ClassReader
used to read the original class. It
will be used to copy the entire constant pool from the
original class and also to copy other fragments of original
bytecode where applicable.flags
- option flags that can be used to modify the default behavior
of this class. These option flags do not affect methods
that are copied as is in the new class. This means that the
maximum stack size nor the stack frames will be computed for
these methods. See COMPUTE_MAXS
,
COMPUTE_FRAMES
.public final void visit(int version, int access, String name, String signature, String superName, String[] interfaces)
visit
in class org.springframework.asm.ClassVisitor
public final void visitSource(String file, String debug)
visitSource
in class org.springframework.asm.ClassVisitor
public final void visitOuterClass(String owner, String name, String desc)
visitOuterClass
in class org.springframework.asm.ClassVisitor
public final org.springframework.asm.AnnotationVisitor visitAnnotation(String desc, boolean visible)
visitAnnotation
in class org.springframework.asm.ClassVisitor
public final org.springframework.asm.AnnotationVisitor visitTypeAnnotation(int typeRef, org.springframework.asm.TypePath typePath, String desc, boolean visible)
visitTypeAnnotation
in class org.springframework.asm.ClassVisitor
public final void visitAttribute(org.springframework.asm.Attribute attr)
visitAttribute
in class org.springframework.asm.ClassVisitor
public final void visitInnerClass(String name, String outerName, String innerName, int access)
visitInnerClass
in class org.springframework.asm.ClassVisitor
public final org.springframework.asm.FieldVisitor visitField(int access, String name, String desc, String signature, Object value)
visitField
in class org.springframework.asm.ClassVisitor
public final org.springframework.asm.MethodVisitor visitMethod(int access, String name, String desc, String signature, String[] exceptions)
visitMethod
in class org.springframework.asm.ClassVisitor
public final void visitEnd()
visitEnd
in class org.springframework.asm.ClassVisitor
public byte[] toByteArray()
public int newConst(Object cst)
Attribute
sub classes, and is
normally not needed by class generators or adapters.public int newUTF8(String value)
Attribute
sub classes, and is normally not
needed by class generators or adapters.value
- the String value.public int newClass(String value)
Attribute
sub classes, and is
normally not needed by class generators or adapters.value
- the internal name of the class.public int newMethodType(String methodDesc)
Attribute
sub classes, and is
normally not needed by class generators or adapters.methodDesc
- method descriptor of the method type.public int newHandle(int tag, String owner, String name, String desc)
Attribute
sub classes, and is normally not needed by
class generators or adapters.tag
- the kind of this handle. Must be Opcodes.H_GETFIELD
,
Opcodes.H_GETSTATIC
, Opcodes.H_PUTFIELD
,
Opcodes.H_PUTSTATIC
, Opcodes.H_INVOKEVIRTUAL
,
Opcodes.H_INVOKESTATIC
,
Opcodes.H_INVOKESPECIAL
,
Opcodes.H_NEWINVOKESPECIAL
or
Opcodes.H_INVOKEINTERFACE
.owner
- the internal name of the field or method owner class.name
- the name of the field or method.desc
- the descriptor of the field or method.public int newInvokeDynamic(String name, String desc, org.springframework.asm.Handle bsm, Object... bsmArgs)
Attribute
sub classes, and is
normally not needed by class generators or adapters.name
- name of the invoked method.desc
- descriptor of the invoke method.bsm
- the bootstrap method.bsmArgs
- the bootstrap method constant arguments.public int newField(String owner, String name, String desc)
Attribute
sub classes, and is
normally not needed by class generators or adapters.owner
- the internal name of the field's owner class.name
- the field's name.desc
- the field's descriptor.public int newMethod(String owner, String name, String desc, boolean itf)
Attribute
sub classes, and is
normally not needed by class generators or adapters.owner
- the internal name of the method's owner class.name
- the method's name.desc
- the method's descriptor.itf
- true if owner is an interface.public int newNameType(String name, String desc)
Attribute
sub classes, and is normally not
needed by class generators or adapters.name
- a name.desc
- a type descriptor.protected String getCommonSuperClass(String type1, String type2)
type1
- the internal name of a class.type2
- the internal name of another class.protected ClassLoader getClassLoader()
Copyright © 2003–2018 MuleSoft, Inc.. All rights reserved.