org.cadixdev.lorenz.model

Interface ClassMapping<M extends ClassMapping,P>

Type Parameters:

M - The type of the mapping

P - The type of the parent

All Superinterfaces:

org.cadixdev.bombe.analysis.InheritanceCompletable, Mapping<M,P>, Reversible<M,P>

All Known Subinterfaces:

InnerClassMapping, TopLevelClassMapping

All Known Implementing Classes:

AbstractClassMappingImpl, InnerClassMappingImpl, TopLevelClassMappingImpl

public interface ClassMapping<M extends ClassMapping,P>
extends Mapping<M,P>, org.cadixdev.bombe.analysis.InheritanceCompletable

Represents a de-obfuscation mapping for classes.

Since:

0.1.0

Method Summary

Modifier and Type	Method and Description
Optional<FieldMapping>	computeFieldMapping(org.cadixdev.bombe.type.signature.FieldSignature signature) Attempts to locate a field mapping for the given obfuscated field signature.
default FieldMapping	createFieldMapping(org.cadixdev.bombe.type.signature.FieldSignature signature) Creates a new field mapping, attached to this class mapping, using the given obfuscated name.
FieldMapping	createFieldMapping(org.cadixdev.bombe.type.signature.FieldSignature signature, String deobfuscatedName) Creates a new field mapping, attached to this class mapping, using the given signature and de-obfuscated name.
default FieldMapping	createFieldMapping(String obfuscatedName) Creates a new field mapping, attached to this class mapping, using the given obfuscated name.
default FieldMapping	createFieldMapping(String obfuscatedName, String deobfuscatedName) Creates a new field mapping, attached to this class mapping, using the given obfuscated and de-obfuscated name.
default InnerClassMapping	createInnerClassMapping(String obfuscatedName) Creates a new inner class mapping, attached to this class mapping, using the given obfuscated class name.
InnerClassMapping	createInnerClassMapping(String obfuscatedName, String deobfuscatedName) Creates a new inner class mapping, attached to this class mapping, using the given obfuscated and de-obfuscated class name.
default MethodMapping	createMethodMapping(org.cadixdev.bombe.type.signature.MethodSignature signature) Creates a new method mapping, attached to this class mapping, using the given method signature.
MethodMapping	createMethodMapping(org.cadixdev.bombe.type.signature.MethodSignature signature, String deobfuscatedName) Creates a new method mapping, attached to this class mapping, using the given method signature and de-obfuscated name.
default MethodMapping	createMethodMapping(String obfuscatedName, org.cadixdev.bombe.type.MethodDescriptor obfuscatedDescriptor) Creates a new method mapping, attached to this class mapping, using the given obfuscated method name and descriptor.
default MethodMapping	createMethodMapping(String obfuscatedName, String obfuscatedDescriptor) Creates a new method mapping, attached to this class mapping, using the given obfuscated method name and descriptor.
String	getDeobfuscatedPackage() Gets the de-obfuscated package name of this class mapping.
Optional<FieldMapping>	getFieldMapping(org.cadixdev.bombe.type.signature.FieldSignature signature) Gets the field mapping of the given signature of the class mapping, should it exist.
Optional<FieldMapping>	getFieldMapping(String obfuscatedName) Gets a field mapping of the given obfuscated name of the class mapping, should it exist.
Collection<FieldMapping>	getFieldMappings() Gets an immutable collection of all of the field mappings of the class mapping.
Map<String,FieldMapping>	getFieldsByName() Gets an immutable map of all of the field mappings of the class mapping, by the field name.
Optional<InnerClassMapping>	getInnerClassMapping(String obfuscatedName) Gets the inner class mapping of the given obfuscated name of the class mapping, should it exist.
Collection<InnerClassMapping>	getInnerClassMappings() Gets an immutable collection of all of the inner class mappings of the class mapping.
Optional<MethodMapping>	getMethodMapping(org.cadixdev.bombe.type.signature.MethodSignature signature) Gets the method mapping of the given method signature of the class mapping, should it exist.
default Optional<MethodMapping>	getMethodMapping(String obfuscatedName, String obfuscatedDescriptor) Gets the method mapping of the given method signature of the class mapping, should it exist.
Collection<MethodMapping>	getMethodMappings() Gets an immutable collection of all of the method mappings of the class mapping.
String	getObfuscatedPackage() Gets the obfuscated package name of this class mapping.
default FieldMapping	getOrCreateFieldMapping(org.cadixdev.bombe.type.signature.FieldSignature signature) Gets, or creates should it not exist, a field mapping of the given signature.
default FieldMapping	getOrCreateFieldMapping(String obfuscatedName) Gets, or creates should it not exist, a field mapping of the given obfuscated name.
default FieldMapping	getOrCreateFieldMapping(String obfuscatedName, org.cadixdev.bombe.type.FieldType obfuscatedDescriptor) Gets, or creates should it not exist, a field mapping of the given signature.
default FieldMapping	getOrCreateFieldMapping(String obfuscatedName, String obfuscatedDescriptor) Gets, or creates should it not exist, a field mapping of the given signature.
default InnerClassMapping	getOrCreateInnerClassMapping(String obfuscatedName) Gets, or creates should it not exist, a inner class mapping of the given obfuscated name.
default MethodMapping	getOrCreateMethodMapping(org.cadixdev.bombe.type.signature.MethodSignature signature) Gets, or creates should it not exist, a method mapping of the given obfuscated signature.
default MethodMapping	getOrCreateMethodMapping(String obfuscatedName, org.cadixdev.bombe.type.MethodDescriptor obfuscatedDescriptor) Gets, or creates should it not exist, a method mapping of the given obfuscated name, and descriptor.
default MethodMapping	getOrCreateMethodMapping(String obfuscatedName, String obfuscatedDescriptor) Gets, or creates should it not exist, a method mapping of the given obfuscated name, and descriptor.
String	getSimpleDeobfuscatedName() Gets the unqualified ("simple") de-obfuscated name of the member.
String	getSimpleObfuscatedName() Gets the unqualified ("simple") obfuscated name of the member.
boolean	hasFieldMapping(org.cadixdev.bombe.type.signature.FieldSignature signature) Establishes whether the class mapping contains a field mapping of the given signature.
default boolean	hasFieldMapping(String obfuscatedName) Establishes whether the class mapping contains a field mapping of the given obfuscated name.
boolean	hasInnerClassMapping(String obfuscatedName) Establishes whether the class mapping contains a inner class mapping of the given obfuscated name.
default boolean	hasMappings() Establishes whether the class mapping has a de-obfuscation mapping, or has some mappings within it.
boolean	hasMethodMapping(org.cadixdev.bombe.type.signature.MethodSignature signature) Establishes whether the class mapping contains a method mapping of the given obfuscated name.
default Optional<org.cadixdev.bombe.analysis.InheritanceProvider.ClassInfo>	provideInheritance(org.cadixdev.bombe.analysis.InheritanceProvider provider, Object context)

Methods inherited from interface org.cadixdev.lorenz.model.Mapping

copy, get, getDeobfuscatedName, getFullDeobfuscatedName, getFullObfuscatedName, getMappings, getObfuscatedName, getOrCreate, hasDeobfuscatedName, merge, set, setDeobfuscatedName

Methods inherited from interface org.cadixdev.lorenz.util.Reversible

reverse

Methods inherited from interface org.cadixdev.bombe.analysis.InheritanceCompletable

complete, complete, complete, isComplete

Method Detail

getSimpleObfuscatedName

String getSimpleObfuscatedName()

Gets the unqualified ("simple") obfuscated name of the member.

Specified by:

getSimpleObfuscatedName in interface Mapping<M extends ClassMapping,P>

Returns:

The simple obfuscated name

See Also:

Class.getSimpleName(), Specification

getSimpleDeobfuscatedName

String getSimpleDeobfuscatedName()

Gets the unqualified ("simple") de-obfuscated name of the member.

Specified by:

getSimpleDeobfuscatedName in interface Mapping<M extends ClassMapping,P>

Returns:

The simple de-obfuscated name

See Also:

Class.getSimpleName(), Specification

getObfuscatedPackage

String getObfuscatedPackage()

Gets the obfuscated package name of this class mapping.

Default package is represented using an empty string.

Returns:

The obfuscated package name

Since:

0.4.0

getDeobfuscatedPackage

String getDeobfuscatedPackage()

Gets the de-obfuscated package name of this class mapping.

Default package is represented using an empty string.

Returns:

The de-obfuscated package name

Since:

0.4.0

getFieldMappings

Collection<FieldMapping> getFieldMappings()

Gets an immutable collection of all of the field mappings of the class mapping.

Returns:

The field mappings

getFieldsByName

Map<String,FieldMapping> getFieldsByName()

Gets an immutable map of all of the field mappings of the class mapping, by the field name.

Returns:

The field mappings by name

Since:

0.4.0

getFieldMapping

Optional<FieldMapping> getFieldMapping(org.cadixdev.bombe.type.signature.FieldSignature signature)

Gets the field mapping of the given signature of the class mapping, should it exist.

Note: The field signature is looked up as-is, so if the loaded mappings use field types, looking up a signature without type will fail. Consider using getFieldMapping(String) or computeFieldMapping(FieldSignature).

Parameters:

signature - The signature of the field

Returns:

The field mapping, wrapped in an Optional

Since:

0.4.0

See Also:

getFieldMapping(String), computeFieldMapping(FieldSignature)

getFieldMapping

Optional<FieldMapping> getFieldMapping(String obfuscatedName)

Gets a field mapping of the given obfuscated name of the class mapping, should it exist. If multiple fields mappings with the same name (but different types) exist, only one of them will be returned.

Note: This is not equivalent to calling getFieldMapping(FieldSignature) with a null field type. Use computeFieldMapping(FieldSignature) to flexibly lookup field signatures with or without type.

Parameters:

obfuscatedName - The obfuscated name of the field mapping

Returns:

The field mapping, wrapped in an Optional

See Also:

getFieldMapping(FieldSignature), computeFieldMapping(FieldSignature)

computeFieldMapping

Optional<FieldMapping> computeFieldMapping(org.cadixdev.bombe.type.signature.FieldSignature signature)

Attempts to locate a field mapping for the given obfuscated field signature. Unlike getFieldMapping(FieldSignature) this method will attempt to match the field signature with or without type:

If FieldSignature.getType() is empty, getFieldMapping(String) is returned. Otherwise, the signature is looked up with type. If that fails, the signature is looked up again without type. Note that it will insert a new FieldMapping with the specified type for caching purposes.

Parameters:

signature - The (obfuscated) signature of the field

Returns:

The field mapping, wrapped in an Optional

See Also:

getFieldMapping(FieldSignature), getFieldMapping(String)

createFieldMapping

FieldMapping createFieldMapping(org.cadixdev.bombe.type.signature.FieldSignature signature,
                                String deobfuscatedName)

Creates a new field mapping, attached to this class mapping, using the given signature and de-obfuscated name.

Parameters:

signature - The signature of the field

deobfuscatedName - The de-obfuscated name of the field

Returns:

The field mapping

Since:

0.4.0

createFieldMapping

default FieldMapping createFieldMapping(String obfuscatedName,
                                        String deobfuscatedName)

Creates a new field mapping, attached to this class mapping, using the given obfuscated and de-obfuscated name.

Parameters:

obfuscatedName - The obfuscated name of the field

deobfuscatedName - The de-obfuscated name of the field

Returns:

The field mapping

createFieldMapping

default FieldMapping createFieldMapping(org.cadixdev.bombe.type.signature.FieldSignature signature)

Creates a new field mapping, attached to this class mapping, using the given obfuscated name.

Parameters:

signature - The signature of the field

Returns:

The field mapping

Since:

0.4.0

createFieldMapping

default FieldMapping createFieldMapping(String obfuscatedName)

Creates a new field mapping, attached to this class mapping, using the given obfuscated name.

Parameters:

obfuscatedName - The obfuscated name of the field

Returns:

The field mapping

getOrCreateFieldMapping

default FieldMapping getOrCreateFieldMapping(org.cadixdev.bombe.type.signature.FieldSignature signature)

Gets, or creates should it not exist, a field mapping of the given signature.

Parameters:

signature - The signature of the field mapping

Returns:

The field mapping

Since:

0.4.0

getOrCreateFieldMapping

default FieldMapping getOrCreateFieldMapping(String obfuscatedName)

Gets, or creates should it not exist, a field mapping of the given obfuscated name.

Parameters:

obfuscatedName - The obfuscated name of the field mapping

Returns:

The field mapping

getOrCreateFieldMapping

default FieldMapping getOrCreateFieldMapping(String obfuscatedName,
                                             String obfuscatedDescriptor)

Gets, or creates should it not exist, a field mapping of the given signature.

Parameters:

obfuscatedName - The obfuscated name of the field mapping

obfuscatedDescriptor - The obfuscated descriptor of the field mapping

Returns:

The field mapping

Since:

0.4.0

getOrCreateFieldMapping

default FieldMapping getOrCreateFieldMapping(String obfuscatedName,
                                             org.cadixdev.bombe.type.FieldType obfuscatedDescriptor)

Gets, or creates should it not exist, a field mapping of the given signature.

Parameters:

obfuscatedName - The obfuscated name of the field mapping

obfuscatedDescriptor - The obfuscated descriptor of the field mapping

Returns:

The field mapping

Since:

0.5.1

hasFieldMapping

boolean hasFieldMapping(org.cadixdev.bombe.type.signature.FieldSignature signature)

Establishes whether the class mapping contains a field mapping of the given signature.

Parameters:

signature - The signature of the field mapping

Returns:

true should a field mapping of the given signature exists in the class mapping; false otherwise

Since:

0.4.0

hasFieldMapping

default boolean hasFieldMapping(String obfuscatedName)

Establishes whether the class mapping contains a field mapping of the given obfuscated name.

Parameters:

obfuscatedName - The obfuscated name of the field mapping

Returns:

true should a field mapping of the given obfuscated name exists in the class mapping; false otherwise

getMethodMappings

Collection<MethodMapping> getMethodMappings()

Gets an immutable collection of all of the method mappings of the class mapping.

Returns:

The method mappings

getMethodMapping

Optional<MethodMapping> getMethodMapping(org.cadixdev.bombe.type.signature.MethodSignature signature)

Gets the method mapping of the given method signature of the class mapping, should it exist.

Parameters:

signature - The signature of the method mapping

Returns:

The method mapping, wrapped in an Optional

getMethodMapping

default Optional<MethodMapping> getMethodMapping(String obfuscatedName,
                                                 String obfuscatedDescriptor)

Gets the method mapping of the given method signature of the class mapping, should it exist.

Parameters:

obfuscatedName - The obfuscated name of the method mapping

obfuscatedDescriptor - The obfuscated descriptor of the method mapping

Returns:

The method mapping, wrapped in an Optional

Since:

0.5.0

createMethodMapping

MethodMapping createMethodMapping(org.cadixdev.bombe.type.signature.MethodSignature signature,
                                  String deobfuscatedName)

Creates a new method mapping, attached to this class mapping, using the given method signature and de-obfuscated name.

Parameters:

signature - The method signature

deobfuscatedName - The de-obfuscated name of the method

Returns:

The method mapping

createMethodMapping

default MethodMapping createMethodMapping(org.cadixdev.bombe.type.signature.MethodSignature signature)

Creates a new method mapping, attached to this class mapping, using the given method signature.

Parameters:

signature - The method signature

Returns:

The method mapping

createMethodMapping

default MethodMapping createMethodMapping(String obfuscatedName,
                                          String obfuscatedDescriptor)

Creates a new method mapping, attached to this class mapping, using the given obfuscated method name and descriptor.

Parameters:

obfuscatedName - The obfuscated method name

obfuscatedDescriptor - The obfuscated method descriptor

Returns:

The method mapping

createMethodMapping

default MethodMapping createMethodMapping(String obfuscatedName,
                                          org.cadixdev.bombe.type.MethodDescriptor obfuscatedDescriptor)

Creates a new method mapping, attached to this class mapping, using the given obfuscated method name and descriptor.

Parameters:

obfuscatedName - The obfuscated method name

obfuscatedDescriptor - The obfuscated method descriptor

Returns:

The method mapping

Since:

0.5.1

getOrCreateMethodMapping

default MethodMapping getOrCreateMethodMapping(org.cadixdev.bombe.type.signature.MethodSignature signature)

Gets, or creates should it not exist, a method mapping of the given obfuscated signature.

Parameters:

signature - The signature of the method mapping

Returns:

The method mapping

getOrCreateMethodMapping

default MethodMapping getOrCreateMethodMapping(String obfuscatedName,
                                               String obfuscatedDescriptor)

Gets, or creates should it not exist, a method mapping of the given obfuscated name, and descriptor.

Parameters:

obfuscatedName - The obfuscated name of the method mapping

obfuscatedDescriptor - The obfuscated descriptor of the method mapping

Returns:

The method mapping

getOrCreateMethodMapping

default MethodMapping getOrCreateMethodMapping(String obfuscatedName,
                                               org.cadixdev.bombe.type.MethodDescriptor obfuscatedDescriptor)

Gets, or creates should it not exist, a method mapping of the given obfuscated name, and descriptor.

Parameters:

obfuscatedName - The obfuscated name of the method mapping

obfuscatedDescriptor - The obfuscated descriptor of the method mapping

Returns:

The method mapping

Since:

0.5.1

hasMethodMapping

boolean hasMethodMapping(org.cadixdev.bombe.type.signature.MethodSignature signature)

Establishes whether the class mapping contains a method mapping of the given obfuscated name.

Parameters:

signature - The signature of the method mapping

Returns:

true should a method mapping of the given obfuscated name exist in the class mapping; false otherwise

getInnerClassMappings

Collection<InnerClassMapping> getInnerClassMappings()

Gets an immutable collection of all of the inner class mappings of the class mapping.

Returns:

The inner class mappings

getInnerClassMapping

Optional<InnerClassMapping> getInnerClassMapping(String obfuscatedName)

Gets the inner class mapping of the given obfuscated name of the class mapping, should it exist.

Parameters:

obfuscatedName - The obfuscated name of the inner class mapping

Returns:

The inner class mapping, wrapped in an Optional

createInnerClassMapping

InnerClassMapping createInnerClassMapping(String obfuscatedName,
                                          String deobfuscatedName)

Creates a new inner class mapping, attached to this class mapping, using the given obfuscated and de-obfuscated class name.

Parameters:

obfuscatedName - The obfuscated class name

deobfuscatedName - The de-obfuscated class name

Returns:

The class mapping

createInnerClassMapping

default InnerClassMapping createInnerClassMapping(String obfuscatedName)

Creates a new inner class mapping, attached to this class mapping, using the given obfuscated class name.

Parameters:

obfuscatedName - The obfuscated class name

Returns:

The class mapping

getOrCreateInnerClassMapping

default InnerClassMapping getOrCreateInnerClassMapping(String obfuscatedName)

Gets, or creates should it not exist, a inner class mapping of the given obfuscated name.

Parameters:

obfuscatedName - The obfuscated name of the inner class mapping

Returns:

The inner class mapping

hasInnerClassMapping

boolean hasInnerClassMapping(String obfuscatedName)

Establishes whether the class mapping contains a inner class mapping of the given obfuscated name.

Parameters:

obfuscatedName - The obfuscated name of the inner class mapping

Returns:

true should a inner class mapping of the given obfuscated name exist in the class mapping; false otherwise

hasMappings

default boolean hasMappings()

Establishes whether the class mapping has a de-obfuscation mapping, or has some mappings within it.

Returns:

true if the class mappings has mappings; false otherwise

provideInheritance

default Optional<org.cadixdev.bombe.analysis.InheritanceProvider.ClassInfo> provideInheritance(org.cadixdev.bombe.analysis.InheritanceProvider provider,
                                                                                               Object context)

Specified by:

provideInheritance in interface org.cadixdev.bombe.analysis.InheritanceCompletable