proguard.classfile

Class MethodSignature

java.lang.Object

proguard.classfile.Signature

proguard.classfile.MethodSignature

All Implemented Interfaces:

java.lang.Comparable<Signature>

public class MethodSignature
extends Signature

Represents a Method signature containing a class, method and a descriptor.

In order to avoid a huge blow-up in memory consumption for analyses that rely heavily on method signatures, e.g. the creation of a call graph, this class provides the ability to cache signatures belonging to concrete Method objects. By using the corresponding computeIfAbsent(Clazz, Method) method, the amount of strings that need to be retained during runtime is reduced.

Field Summary

Fields

Modifier and Type	Field and Description
MethodDescriptor	descriptor
java.lang.String	method

Fields inherited from class proguard.classfile.Signature

className, fqn, packageName, prettyFqn

Constructor Summary

Constructors

Constructor and Description
MethodSignature(Clazz clazz, Method method)
MethodSignature(java.lang.String clazz, java.lang.String method, MethodDescriptor descriptor)
MethodSignature(java.lang.String clazz, java.lang.String method, java.lang.String descriptor)

Method Summary

Modifier and Type	Method and Description
protected java.lang.String	calculateFqn()
protected java.lang.String	calculatePrettyFqn()
static void	clearCache() Remove all currently cached MethodSignature objects from the cache, allowing them to be removed by the garbage collector.
static MethodSignature	computeIfAbsent(Clazz clazz, Method method) Get the singleton MethodSignature object for this specific Method.
boolean	equals(java.lang.Object o)
int	hashCode()
boolean	matchesIgnoreNull(MethodSignature other) Fuzzy check if two MethodSignature objects are equal.
boolean	matchesIgnoreNullAndDollar(MethodSignature other) Fuzzy check like matchesIgnoreNull(MethodSignature) but allows dollar signs in type strings.

Methods inherited from class proguard.classfile.Signature

compareTo, computeIfAbsent, getClassName, getFqn, getPackageName, getPrettyFqn, of, setCacheEnabled, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

method

public final java.lang.String method

descriptor

public final MethodDescriptor descriptor

Constructor Detail

MethodSignature

public MethodSignature(java.lang.String clazz,
                       java.lang.String method,
                       MethodDescriptor descriptor)

MethodSignature

public MethodSignature(java.lang.String clazz,
                       java.lang.String method,
                       java.lang.String descriptor)

MethodSignature

public MethodSignature(Clazz clazz,
                       Method method)

Method Detail

computeIfAbsent

public static MethodSignature computeIfAbsent(Clazz clazz,
                                              Method method)

Get the singleton MethodSignature object for this specific Method. If it is not yet available in the cache, it will be newly instantiated.

Parameters:

clazz - The class containing the target method

method - The method whose signature is to be generated

Returns:

The cached or newly generated MethodSignature object

calculateFqn

protected java.lang.String calculateFqn()

Specified by:

calculateFqn in class Signature

calculatePrettyFqn

protected java.lang.String calculatePrettyFqn()

Specified by:

calculatePrettyFqn in class Signature

clearCache

public static void clearCache()

Remove all currently cached MethodSignature objects from the cache, allowing them to be removed by the garbage collector.

matchesIgnoreNull

public boolean matchesIgnoreNull(MethodSignature other)

Fuzzy check if two MethodSignature objects are equal. If any field is null, its value in the other object does not influence the check result, providing a way to create a wildcard MethodSignature that e.g. matches several methods of a class that have the same name but a different MethodDescriptor.

Parameters:

other - The MethodSignature to compare with this one

Returns:

true if the two objects match

matchesIgnoreNullAndDollar

public boolean matchesIgnoreNullAndDollar(MethodSignature other)

Fuzzy check like matchesIgnoreNull(MethodSignature) but allows dollar signs in type strings. Usually the notation for inner classes is com/example/Foo$Bar, but sometimes external systems call this class com/example/Foo/Bar. These two names correspond to the same class and thus should be treated as the same if they appear in a MethodSignature. If it is to be expected that this situation may occur, this method should be preferred over matchesIgnoreNull(MethodSignature) to avoid false negatives.

Parameters:

other - The MethodSignature to compare with this one

Returns:

true if the two objects match

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class Signature

hashCode

public int hashCode()

Overrides:

hashCode in class Signature