net.lenni0451.classtransform.utils

Class ASMUtils

java.lang.Object

net.lenni0451.classtransform.utils.ASMUtils

public class ASMUtils
extends java.lang.Object

General utils for using ASM.

Constructor Summary

Constructors

Constructor and Description
ASMUtils()

Method Summary

Modifier and Type	Method and Description
static org.objectweb.asm.tree.ClassNode	cloneClass(org.objectweb.asm.tree.ClassNode classNode) Clone a class node with all its methods and fields.
static org.objectweb.asm.tree.InsnList	cloneInsnList(org.objectweb.asm.tree.InsnList insnList) Clone an insn list with all its instructions.
static org.objectweb.asm.tree.MethodNode	cloneMethod(org.objectweb.asm.tree.MethodNode methodNode) Clone a method node with all its instructions.
static java.lang.String	combiToRegex(java.lang.String combi) Convert a field or method search pattern to a regex pattern.
static boolean	compareType(org.objectweb.asm.Type type, org.objectweb.asm.Type targetType) Compare a single type with a target type This supports the usage of object instead of the actual type but does not check for other inheritance.
static boolean	compareTypes(org.objectweb.asm.Type[] types, org.objectweb.asm.Type[] targetTypes) Compare an array of types with a target array of types.
static boolean	compareTypes(org.objectweb.asm.Type[] types, org.objectweb.asm.Type[] targetTypes, boolean prepend, org.objectweb.asm.Type... additionalNeededTypes) Compare an array of types with a target array of types.
static org.objectweb.asm.tree.ClassNode	createEmptyClass(java.lang.String name) Create an empty class with a default constructor.
static java.lang.String	dot(java.lang.String s) Replace all slashes with dots in the given class/package name.
static org.objectweb.asm.tree.ClassNode	fromBytes(byte[] bytecode) Get a class node from the raw bytecode of a class.
static org.objectweb.asm.tree.InsnList	getCast(org.objectweb.asm.Type wantedType) Get the byte code to cast an object to a given type.
static org.objectweb.asm.tree.FieldNode	getField(org.objectweb.asm.tree.ClassNode classNode, java.lang.String name, java.lang.String desc) Get a field node from a class node using the name.
static java.util.List<org.objectweb.asm.tree.FieldNode>	getFieldsFromCombi(org.objectweb.asm.tree.ClassNode classNode, java.lang.String combi) Get a list of method nodes from a class node using the combined name and descriptor.
static org.objectweb.asm.tree.AbstractInsnNode	getFirstConstructorInstruction(java.lang.String superClass, org.objectweb.asm.tree.MethodNode methodNode) Get the first instruction of a constructor skipping the super init call.
static int	getFreeVarIndex(org.objectweb.asm.tree.MethodNode methodNode) Get the last empty local variable index.
static int	getLoadOpcode(org.objectweb.asm.Type type) Get the needed load opcode for the given type.
static org.objectweb.asm.tree.MethodNode	getMethod(org.objectweb.asm.tree.ClassNode classNode, java.lang.String name, java.lang.String desc) Get a method node from a class node using the name and descriptor.
static java.util.List<org.objectweb.asm.tree.MethodNode>	getMethodsFromCombi(org.objectweb.asm.tree.ClassNode classNode, java.lang.String combi) Get a list of method nodes from a class node using the combined name and descriptor.
static java.lang.Number	getNumber(org.objectweb.asm.tree.AbstractInsnNode instruction) Get a number from an insn node if it represents one.
static org.objectweb.asm.tree.AbstractInsnNode	getPrimitiveToObject(org.objectweb.asm.Type primitive) Get the byte code to wrap a primitive to its wrapper type (e.g. int to Integer).
static int	getReturnOpcode(org.objectweb.asm.Type returnType) Get the needed return opcode for the given type.
static int	getStoreOpcode(org.objectweb.asm.Type type) Get the needed store opcode for the given type.
static org.objectweb.asm.tree.AbstractInsnNode	intPush(int i) Create a new insn node representing the given int.
static boolean	isAccessLower(int toCheck, int checkAgainst) Check if the given access is lower than another.
static int	setAccess(int currentAccess, int newAccess) Set the wanted access to a given access mask.
static java.lang.String	slash(java.lang.String s) Replace all dots with slashes in the given class/package name.
static MemberDeclaration	splitMemberDeclaration(java.lang.String injectDeclaration) Split an injection declaration into owner, name and descriptor.
static byte[]	toBytes(org.objectweb.asm.tree.ClassNode node, ClassTree classTree, IClassProvider classProvider) Get the bytecode from a class node
static byte[]	toStacklessBytes(org.objectweb.asm.tree.ClassNode node) Get the bytecode from a class node without calculating stack map frames

Methods inherited from class java.lang.Object

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

Constructor Detail

ASMUtils

public ASMUtils()

Method Detail

fromBytes

public static org.objectweb.asm.tree.ClassNode fromBytes(byte[] bytecode)

Get a class node from the raw bytecode of a class.

Parameters:

bytecode - The bytecode of the class

Returns:

The parsed class node

toBytes

public static byte[] toBytes(org.objectweb.asm.tree.ClassNode node,
                             ClassTree classTree,
                             IClassProvider classProvider)

Get the bytecode from a class node

Parameters:

node - The class node

classTree - The class tree used to get the super classes

classProvider - The class provider used for stack frame calculation

Returns:

The bytecode of the class

toStacklessBytes

public static byte[] toStacklessBytes(org.objectweb.asm.tree.ClassNode node)

Get the bytecode from a class node without calculating stack map frames

Parameters:

node - The class node

Returns:

The bytecode of the class

getMethod

public static org.objectweb.asm.tree.MethodNode getMethod(org.objectweb.asm.tree.ClassNode classNode,
                                                          java.lang.String name,
                                                          java.lang.String desc)

Get a method node from a class node using the name and descriptor.

Parameters:

classNode - The class node to search in

name - The name of the method

desc - The descriptor of the method

Returns:

The method node or null if no method was found

getField

public static org.objectweb.asm.tree.FieldNode getField(org.objectweb.asm.tree.ClassNode classNode,
                                                        java.lang.String name,
                                                        java.lang.String desc)

Get a field node from a class node using the name.
The descriptor is passed as a parameter but is not used for the search.

Parameters:

classNode - The class node to search in

name - The name of the field

desc - The descriptor of the field

Returns:

The field node or null if no field was found

getMethodsFromCombi

public static java.util.List<org.objectweb.asm.tree.MethodNode> getMethodsFromCombi(org.objectweb.asm.tree.ClassNode classNode,
                                                                                    java.lang.String combi)

Get a list of method nodes from a class node using the combined name and descriptor.
Use * for a wildcard search.
e.g. print(Ljava/lang/String;)V

Parameters:

classNode - The class node to search in

combi - The combined name and descriptor

Returns:

The list of method nodes

Throws:

java.lang.IllegalArgumentException - If the combined name and descriptor is empty

getFieldsFromCombi

public static java.util.List<org.objectweb.asm.tree.FieldNode> getFieldsFromCombi(org.objectweb.asm.tree.ClassNode classNode,
                                                                                  java.lang.String combi)

Get a list of method nodes from a class node using the combined name and descriptor.
Use * for a wildcard search.
e.g. print(Ljava/lang/String;)V

Parameters:

classNode - The class node to search in

combi - The combined name and descriptor

Returns:

The list of method nodes

combiToRegex

public static java.lang.String combiToRegex(java.lang.String combi)

Convert a field or method search pattern to a regex pattern.
Use * for a wildcard search.
e.g. get* -> ^\Qget\E.*$

Parameters:

combi - The search pattern

Returns:

The converted regex pattern

isAccessLower

public static boolean isAccessLower(int toCheck,
                                    int checkAgainst)

Check if the given access is lower than another.
private < package private < protected < public

Parameters:

toCheck - The access to check

checkAgainst - The access to check against

Returns:

If the access is lower than the other

setAccess

public static int setAccess(int currentAccess,
                            int newAccess)

Set the wanted access to a given access mask.
Other access flags will be removed.

Parameters:

currentAccess - The current access mask

newAccess - The wanted access

Returns:

The new access mask

getReturnOpcode

public static int getReturnOpcode(org.objectweb.asm.Type returnType)

Get the needed return opcode for the given type.

Parameters:

returnType - The return type of a method

Returns:

The needed return opcode

getLoadOpcode

public static int getLoadOpcode(org.objectweb.asm.Type type)

Get the needed load opcode for the given type.

Parameters:

type - The type to get the load opcode for

Returns:

The needed load opcode

getStoreOpcode

public static int getStoreOpcode(org.objectweb.asm.Type type)

Get the needed store opcode for the given type.

Parameters:

type - The type to get the store opcode for

Returns:

The needed store opcode

getFreeVarIndex

public static int getFreeVarIndex(org.objectweb.asm.tree.MethodNode methodNode)

Get the last empty local variable index.
You can simply count the index up from there.

Parameters:

methodNode - The method to get the last empty local variable index for

Returns:

The last empty local variable index

getCast

public static org.objectweb.asm.tree.InsnList getCast(org.objectweb.asm.Type wantedType)

Get the byte code to cast an object to a given type.
Converts primitive wrapper to their primitive types (e.g. Integer to int).

Parameters:

wantedType - The wanted type

Returns:

The byte code for the cast

getPrimitiveToObject

public static org.objectweb.asm.tree.AbstractInsnNode getPrimitiveToObject(org.objectweb.asm.Type primitive)

Get the byte code to wrap a primitive to its wrapper type (e.g. int to Integer).

Parameters:

primitive - The primitive type to wrap

Returns:

The byte code for the wrapper or null if the given type is not a primitive

splitMemberDeclaration

public static MemberDeclaration splitMemberDeclaration(java.lang.String injectDeclaration)

Split an injection declaration into owner, name and descriptor.
e.g. java/lang/String.length()I
e.g. java/lang/System.out:Ljava/io/PrintStream;

Parameters:

injectDeclaration - The injection declaration

Returns:

The split member declaration

getFirstConstructorInstruction

public static org.objectweb.asm.tree.AbstractInsnNode getFirstConstructorInstruction(java.lang.String superClass,
                                                                                     org.objectweb.asm.tree.MethodNode methodNode)

Get the first instruction of a constructor skipping the super init call.

Parameters:

superClass - The name of the super class

methodNode - The constructor method node

Returns:

The first actual instruction of the constructor

getNumber

public static java.lang.Number getNumber(org.objectweb.asm.tree.AbstractInsnNode instruction)

Get a number from an insn node if it represents one.
This also works for constants (e.g. Opcodes.ICONST_0)

Parameters:

instruction - The insn node

Returns:

The number or null if it's not a number

compareTypes

public static boolean compareTypes(org.objectweb.asm.Type[] types,
                                   org.objectweb.asm.Type[] targetTypes)

Compare an array of types with a target array of types.
This supports the usage of object instead of the actual type but does not check for other inheritance.
Object can not be used as a replacement for primitives.

Parameters:

types - The source array of types

targetTypes - The target array of types

Returns:

If the arrays match

compareTypes

public static boolean compareTypes(org.objectweb.asm.Type[] types,
                                   org.objectweb.asm.Type[] targetTypes,
                                   boolean prepend,
                                   org.objectweb.asm.Type... additionalNeededTypes)

Compare an array of types with a target array of types.
This supports the usage of object instead of the actual type but does not check for other inheritance.
Object can not be used as a replacement for primitives.

Parameters:

types - The source array of types

targetTypes - The target array of types

prepend - If the additional types array should be prepended or appended

additionalNeededTypes - The additional types to append/prepend to the source

Returns:

If the arrays match

compareType

public static boolean compareType(org.objectweb.asm.Type type,
                                  org.objectweb.asm.Type targetType)

Compare a single type with a target type
This supports the usage of object instead of the actual type but does not check for other inheritance.
Object can not be used as a replacement for primitives.

Parameters:

type - The source type

targetType - The target type

Returns:

If the types match

cloneClass

public static org.objectweb.asm.tree.ClassNode cloneClass(org.objectweb.asm.tree.ClassNode classNode)

Clone a class node with all its methods and fields.

Parameters:

classNode - The class node to clone

Returns:

The cloned class node

cloneMethod

public static org.objectweb.asm.tree.MethodNode cloneMethod(org.objectweb.asm.tree.MethodNode methodNode)

Clone a method node with all its instructions.

Parameters:

methodNode - The method node to clone

Returns:

The cloned method node

cloneInsnList

public static org.objectweb.asm.tree.InsnList cloneInsnList(org.objectweb.asm.tree.InsnList insnList)

Clone an insn list with all its instructions.

Parameters:

insnList - The insn list to clone

Returns:

The cloned insn list

createEmptyClass

public static org.objectweb.asm.tree.ClassNode createEmptyClass(java.lang.String name)

Create an empty class with a default constructor.

Parameters:

name - The name of the class

Returns:

The generated class node

intPush

public static org.objectweb.asm.tree.AbstractInsnNode intPush(int i)

Create a new insn node representing the given int.
This uses the most efficient opcode for the given int.

Parameters:

i - The int

Returns:

The insn node

dot

public static java.lang.String dot(java.lang.String s)

Replace all slashes with dots in the given class/package name.

Parameters:

s - The class/package name

Returns:

The class/package name with dots

slash

public static java.lang.String slash(java.lang.String s)

Replace all dots with slashes in the given class/package name.

Parameters:

s - The class/package name

Returns:

The class/package name with slashes