org.objectweb.asm.commons

Class Remapper

java.lang.Object

org.objectweb.asm.commons.Remapper

Direct Known Subclasses:

SimpleRemapper

public abstract class Remapper
extends java.lang.Object

A class responsible for remapping types and names.

Constructor Summary

Constructors

Constructor and Description
Remapper()

Method Summary

Modifier and Type	Method and Description
protected SignatureVisitor	createRemappingSignatureAdapter(SignatureVisitor signatureVisitor) Deprecated. use createSignatureRemapper(org.objectweb.asm.signature.SignatureVisitor) instead.
protected SignatureVisitor	createSignatureRemapper(SignatureVisitor signatureVisitor) Constructs a new remapper for signatures.
java.lang.String	map(java.lang.String internalName) Maps the internal name of a class to its new name.
java.lang.String	mapDesc(java.lang.String descriptor) Returns the given descriptor, remapped with map(String).
java.lang.String	mapFieldName(java.lang.String owner, java.lang.String name, java.lang.String descriptor) Maps a field name to its new name.
java.lang.String	mapInvokeDynamicMethodName(java.lang.String name, java.lang.String descriptor) Maps an invokedynamic method name to its new name.
java.lang.String	mapMethodDesc(java.lang.String methodDescriptor) Returns the given method descriptor, with its argument and return type descriptors remapped with mapDesc(String).
java.lang.String	mapMethodName(java.lang.String owner, java.lang.String name, java.lang.String descriptor) Maps a method name to its new name.
java.lang.String	mapModuleName(java.lang.String name) Maps a module name to its new name.
java.lang.String	mapPackageName(java.lang.String name) Maps a package name to its new name.
java.lang.String	mapSignature(java.lang.String signature, boolean typeSignature) Returns the given signature, remapped with the SignatureVisitor returned by createSignatureRemapper(SignatureVisitor).
java.lang.String	mapType(java.lang.String internalName) Returns the given internal name, remapped with map(String).
private Type	mapType(Type type) Returns the given Type, remapped with map(String) or mapMethodDesc(String).
java.lang.String[]	mapTypes(java.lang.String[] internalNames) Returns the given internal names, remapped with map(String).
java.lang.Object	mapValue(java.lang.Object value) Returns the given value, remapped with this remapper.

Methods inherited from class java.lang.Object

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

Constructor Detail

Remapper

public Remapper()

Method Detail

mapDesc

public java.lang.String mapDesc(java.lang.String descriptor)

Returns the given descriptor, remapped with map(String).

Parameters:

descriptor - a type descriptor.

Returns:

the given descriptor, with its [array element type] internal name remapped with map(String) (if the descriptor corresponds to an array or object type, otherwise the descriptor is returned as is).

mapType

private Type mapType(Type type)

Returns the given Type, remapped with map(String) or mapMethodDesc(String).

Parameters:

type - a type, which can be a method type.

Returns:

the given type, with its [array element type] internal name remapped with map(String) (if the type is an array or object type, otherwise the type is returned as is) or, of the type is a method type, with its descriptor remapped with mapMethodDesc(String).

mapType

public java.lang.String mapType(java.lang.String internalName)

Returns the given internal name, remapped with map(String).

Parameters:

internalName - the internal name (or array type descriptor) of some (array) class.

Returns:

the given internal name, remapped with map(String).

mapTypes

public java.lang.String[] mapTypes(java.lang.String[] internalNames)

Returns the given internal names, remapped with map(String).

Parameters:

internalNames - the internal names (or array type descriptors) of some (array) classes.

Returns:

the given internal name, remapped with map(String).

mapMethodDesc

public java.lang.String mapMethodDesc(java.lang.String methodDescriptor)

Returns the given method descriptor, with its argument and return type descriptors remapped with mapDesc(String).

Parameters:

methodDescriptor - a method descriptor.

Returns:

the given method descriptor, with its argument and return type descriptors remapped with mapDesc(String).

mapValue

public java.lang.Object mapValue(java.lang.Object value)

Returns the given value, remapped with this remapper.

Parameters:

value - an object. Only Type and Handle values are remapped.

Returns:

the given value, remapped with this remapper.

mapSignature

public java.lang.String mapSignature(java.lang.String signature,
                                     boolean typeSignature)

Returns the given signature, remapped with the SignatureVisitor returned by createSignatureRemapper(SignatureVisitor).

Parameters:

signature - a JavaTypeSignature, ClassSignature or MethodSignature.

typeSignature - whether the given signature is a JavaTypeSignature.

Returns:

signature the given signature, remapped with the SignatureVisitor returned by createSignatureRemapper(SignatureVisitor).

createRemappingSignatureAdapter

@Deprecated
protected SignatureVisitor createRemappingSignatureAdapter(SignatureVisitor signatureVisitor)

Deprecated. use createSignatureRemapper(org.objectweb.asm.signature.SignatureVisitor) instead.

Constructs a new remapper for signatures. The default implementation of this method returns a new SignatureRemapper.

Parameters:

signatureVisitor - the SignatureVisitor the remapper must delegate to.

Returns:

the newly created remapper.

createSignatureRemapper

protected SignatureVisitor createSignatureRemapper(SignatureVisitor signatureVisitor)

Constructs a new remapper for signatures. The default implementation of this method returns a new SignatureRemapper.

Parameters:

signatureVisitor - the SignatureVisitor the remapper must delegate to.

Returns:

the newly created remapper.

mapMethodName

public java.lang.String mapMethodName(java.lang.String owner,
                                      java.lang.String name,
                                      java.lang.String descriptor)

Maps a method name to its new name. The default implementation of this method returns the given name, unchanged. Subclasses can override.

Parameters:

owner - the internal name of the owner class of the method.

name - the name of the method.

descriptor - the descriptor of the method.

Returns:

the new name of the method.

mapInvokeDynamicMethodName

public java.lang.String mapInvokeDynamicMethodName(java.lang.String name,
                                                   java.lang.String descriptor)

Maps an invokedynamic method name to its new name. The default implementation of this method returns the given name, unchanged. Subclasses can override.

Parameters:

name - the name of the method.

descriptor - the descriptor of the method.

Returns:

the new name of the method.

mapFieldName

public java.lang.String mapFieldName(java.lang.String owner,
                                     java.lang.String name,
                                     java.lang.String descriptor)

Maps a field name to its new name. The default implementation of this method returns the given name, unchanged. Subclasses can override.

Parameters:

owner - the internal name of the owner class of the field.

name - the name of the field.

descriptor - the descriptor of the field.

Returns:

the new name of the field.

mapPackageName

public java.lang.String mapPackageName(java.lang.String name)

Maps a package name to its new name. The default implementation of this method returns the given name, unchanged. Subclasses can override.

Parameters:

name - the fully qualified name of the package (using dots).

Returns:

the new name of the package.

mapModuleName

public java.lang.String mapModuleName(java.lang.String name)

Maps a module name to its new name. The default implementation of this method returns the given name, unchanged. Subclasses can override.

Parameters:

name - the fully qualified name (using dots) of a module.

Returns:

the new name of the module.

map

public java.lang.String map(java.lang.String internalName)

Maps the internal name of a class to its new name. The default implementation of this method returns the given name, unchanged. Subclasses can override.

Parameters:

internalName - the internal name of a class.

Returns:

the new internal name.