com.android.dx.rop.type

Class Prototype

java.lang.Object

com.android.dx.rop.type.Prototype

All Implemented Interfaces:

java.lang.Comparable<Prototype>

public final class Prototype
extends java.lang.Object
implements java.lang.Comparable<Prototype>

Representation of a method descriptor. Instances of this class are generally interned and may be usefully compared with each other using ==.

Method Summary

Modifier and Type	Method and Description
static void	clearInternTable()
int	compareTo(Prototype other)
boolean	equals(java.lang.Object other)
static Prototype	fromDescriptor(java.lang.String descriptor) Returns a prototype for a method descriptor.
java.lang.String	getDescriptor() Gets the descriptor string.
StdTypeList	getParameterFrameTypes() Gets the list of frame types corresponding to the list of parameter types.
StdTypeList	getParameterTypes() Gets the list of parameter types.
Type	getReturnType() Gets the return type.
int	hashCode()
static Prototype	intern(java.lang.String descriptor) Returns the unique instance corresponding to the given method descriptor.
static Prototype	intern(java.lang.String descriptor, Type definer, boolean isStatic, boolean isInit) Interns an instance, adding to the descriptor as necessary based on the given definer, name, and flags.
static Prototype	internInts(Type returnType, int count) Interns an instance which consists of the given number of ints along with the given return type
java.lang.String	toString()
Prototype	withFirstParameter(Type param) Returns a new interned instance, which is the same as this instance, except that it has an additional parameter prepended to the original's argument list.

Methods inherited from class java.lang.Object

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

Method Detail

intern

public static Prototype intern(java.lang.String descriptor)

Returns the unique instance corresponding to the given method descriptor. See vmspec-2 sec4.3.3 for details on the field descriptor syntax.

Parameters:

descriptor - non-null; the descriptor

Returns:

non-null; the corresponding instance

Throws:

java.lang.IllegalArgumentException - thrown if the descriptor has invalid syntax

fromDescriptor

public static Prototype fromDescriptor(java.lang.String descriptor)

Returns a prototype for a method descriptor. The Prototype returned will be the interned value if present, or a new instance otherwise. If a new instance is created, it is not placed in the intern table.

Parameters:

descriptor - non-null; the descriptor

Returns:

non-null; the corresponding instance

Throws:

java.lang.IllegalArgumentException - thrown if the descriptor has invalid syntax

clearInternTable

public static void clearInternTable()

intern

public static Prototype intern(java.lang.String descriptor,
                               Type definer,
                               boolean isStatic,
                               boolean isInit)

Interns an instance, adding to the descriptor as necessary based on the given definer, name, and flags. For example, an init method has an uninitialized object of type definer as its first argument.

Parameters:

descriptor - non-null; the descriptor string

definer - non-null; class the method is defined on

isStatic - whether this is a static method

isInit - whether this is an init method

Returns:

non-null; the interned instance

internInts

public static Prototype internInts(Type returnType,
                                   int count)

Interns an instance which consists of the given number of ints along with the given return type

Parameters:

returnType - non-null; the return type

count - > 0; the number of elements in the prototype

Returns:

non-null; the interned instance

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

compareTo

public int compareTo(Prototype other)

Specified by:

compareTo in interface java.lang.Comparable<Prototype>

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getDescriptor

public java.lang.String getDescriptor()

Gets the descriptor string.

Returns:

non-null; the descriptor

getReturnType

public Type getReturnType()

Gets the return type.

Returns:

non-null; the return type

getParameterTypes

public StdTypeList getParameterTypes()

Gets the list of parameter types.

Returns:

non-null; the list of parameter types

getParameterFrameTypes

public StdTypeList getParameterFrameTypes()

Gets the list of frame types corresponding to the list of parameter types. The difference between the two lists (if any) is that all "intlike" types (see Type.isIntlike()) are replaced by Type.INT.

Returns:

non-null; the list of parameter frame types

withFirstParameter

public Prototype withFirstParameter(Type param)

Returns a new interned instance, which is the same as this instance, except that it has an additional parameter prepended to the original's argument list.

Parameters:

param - non-null; the new first parameter

Returns:

non-null; an appropriately-constructed instance