org.jikesrvm.classloader

Class MethodReference

java.lang.Object

org.jikesrvm.classloader.MemberReference

org.jikesrvm.classloader.MethodReference

public final class MethodReference
extends MemberReference

A class to represent the reference in a class file to a method of that class or interface.

Field Summary

Fields

Modifier and Type	Field and Description
private TypeReference[]	parameterTypes types of parameters (not including "this", if virtual)
private RVMMethod	resolvedMember The RVMMethod that this method reference resolved to (null if not yet resolved).
private TypeReference	returnType type of return value

Fields inherited from class org.jikesrvm.classloader.MemberReference

descriptor, id, name, type

Constructor Summary

Constructors

Constructor and Description
MethodReference(TypeReference tr, Atom mn, Atom d, int id)

Method Summary

Modifier and Type	Method and Description
boolean	definitelyDifferent(MethodReference that) Do this and that definitely refer to different methods?
boolean	definitelySame(MethodReference that) Do this and that definitely refer to the same method?
static MethodReference	findOrCreate(TypeReference tRef, Atom mn, Atom md) Find or create a method reference
TypeReference[]	getParameterTypes()
int	getParameterWords()
RVMMethod	getResolvedMember() Get the member this reference has been resolved to, if it has already been resolved.
TypeReference	getReturnType()
boolean	isMagic() Is the method reference to a magic method?
boolean	isMiranda() Return true iff this member reference refers to a method which is declared as part of an abstract class but actually is an interface method, known formally as a "miranda method".
boolean	isResolved()
boolean	isSpecializedInvoke() Is the method reference to a specialized invoke?
boolean	isSysCall() Is the method reference to a magic method?
RVMMethod	peekInterfaceMethod() Find the RVMMethod that this member reference refers to using the search order specified in JVM spec 5.4.3.4.
RVMMethod	peekResolvedMethod() Find the RVMMethod that this method reference refers to using the search order specified in JVM spec 5.4.3.3.
RVMMethod	resolve() Find the RVMMethod that this field reference refers to using the search order specified in JVM specification 5.4.3.3.
RVMMethod	resolveInterfaceMethod() Find the RVMMethod that this member reference refers to using the search order specified in JVM spec 5.4.3.4.
private RVMMethod	resolveInterfaceMethodInternal(RVMClass declaringClass) Find the RVMMethod that this member reference refers to using the search order specified in JVM spec 5.4.3.4.
private RVMMethod	resolveInternal(RVMClass declaringClass) Find the RVMMethod that this member reference refers to using the search order specified in JVM spec 5.4.3.3.
RVMMethod	resolveInvokeSpecial() Resolves the method reference for an invoke special into a target method, if that is possible without causing classloading.
private RVMMethod	searchInterfaceMethods(RVMClass c)
(package private) void	setResolvedMember(RVMMethod it)

Methods inherited from class org.jikesrvm.classloader.MemberReference

asFieldReference, asMethodReference, equals, getDescriptor, getFieldRef, getId, getMemberRef, getMethodRef, getName, getNextId, getType, hashCode, isFieldReference, isMethodReference, needsDynamicLink, parse, parse, peekResolvedMember, resolveMember, toString

Methods inherited from class java.lang.Object

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

Field Detail

returnType

private final TypeReference returnType

type of return value

parameterTypes

private final TypeReference[] parameterTypes

types of parameters (not including "this", if virtual)

resolvedMember

private RVMMethod resolvedMember

The RVMMethod that this method reference resolved to (null if not yet resolved).

Constructor Detail

MethodReference

MethodReference(TypeReference tr,
                Atom mn,
                Atom d,
                int id)

Parameters:

tr - a type reference to the defining class in which this method appears. (e.g., "Ljava/lang/String;")

mn - the name of this method (e.g., "equals")

d - the method descriptor (e.g., "(Ljava/lang/Object;)Z")

id - the new ID of the member were a new member required

Method Detail

findOrCreate

public static MethodReference findOrCreate(TypeReference tRef,
                                           Atom mn,
                                           Atom md)

Find or create a method reference

Parameters:

tRef - the type reference

mn - the name of the member

md - the descriptor of the member

Returns:

a method reference, never null

See Also:

MemberReference.findOrCreate(TypeReference, Atom, Atom)

getReturnType

public TypeReference getReturnType()

Returns:

return type of the method

getParameterTypes

public TypeReference[] getParameterTypes()

Returns:

parameter types of the method

getParameterWords

public int getParameterWords()

Returns:

space required by method for its parameters, in words. Note: does *not* include implicit "this" parameter, if any.

definitelyDifferent

public boolean definitelyDifferent(MethodReference that)

Do this and that definitely refer to different methods?

Parameters:

that - the reference to compare with

Returns:

true if the methods are definitely different, false if it's not known (e.g. because at least one of the method references is unresolved)

definitelySame

public boolean definitelySame(MethodReference that)

Do this and that definitely refer to the same method?

Parameters:

that - the reference to compare with

Returns:

true if the methods are definitely the same, false if it's not known (e.g. because at least one of the method references is unresolved)

isResolved

public boolean isResolved()

Returns:

true if the method reference has already been resolved into a target method

getResolvedMember

public RVMMethod getResolvedMember()

Get the member this reference has been resolved to, if it has already been resolved. Does NOT force resolution.

Returns:

the resolved RVMMethod or null if not yet resolved

setResolvedMember

void setResolvedMember(RVMMethod it)

resolveInvokeSpecial

public RVMMethod resolveInvokeSpecial()

Resolves the method reference for an invoke special into a target method, if that is possible without causing classloading.

Returns:

target method or null if the method cannot be resolved without classloading.

peekResolvedMethod

public RVMMethod peekResolvedMethod()

Find the RVMMethod that this method reference refers to using the search order specified in JVM spec 5.4.3.3.

Returns:

the RVMMethod that this method ref resolved to or null if it cannot be resolved.

resolve

public RVMMethod resolve()

Find the RVMMethod that this field reference refers to using the search order specified in JVM specification 5.4.3.3.

Returns:

the RVMMethod that this method reference resolved to.

isMiranda

public boolean isMiranda()

Return true iff this member reference refers to a method which is declared as part of an abstract class but actually is an interface method, known formally as a "miranda method".

This method is necessary to handle the special case where an invokevirtual is defined on an abstract class, where the method invocation points to a method inherited from an interface.

Returns:

true iff this member method reference is a miranda method

isMagic

public boolean isMagic()

Is the method reference to a magic method? NB. In the case of SysCall annotated methods we don't know until they are resolved.

Returns:

true if this method reference is for a magic method

isSpecializedInvoke

public boolean isSpecializedInvoke()

Is the method reference to a specialized invoke? NB. we don't know until they are resolved.

Returns:

true if this method reference is for a specialized invoke

isSysCall

public boolean isSysCall()

Is the method reference to a magic method? NB. In the case of SysCall annotated methods we don't know until they are resolved.

Returns:

true if this method reference is for a sysCall method

resolveInternal

private RVMMethod resolveInternal(RVMClass declaringClass)

Find the RVMMethod that this member reference refers to using the search order specified in JVM spec 5.4.3.3.

Parameters:

declaringClass - the class that declared the method

Returns:

the RVMMethod that this method ref resolved to.

peekInterfaceMethod

public RVMMethod peekInterfaceMethod()

Find the RVMMethod that this member reference refers to using the search order specified in JVM spec 5.4.3.4.

Returns:

the RVMMethod that this method ref resolved to or null if it cannot be resolved without trigering class loading

resolveInterfaceMethod

public RVMMethod resolveInterfaceMethod()
                                 throws IncompatibleClassChangeError,
                                        NoSuchMethodError

Find the RVMMethod that this member reference refers to using the search order specified in JVM spec 5.4.3.4.

Returns:

the RVMMethod that this method ref resolved to

Throws:

IncompatibleClassChangeError

NoSuchMethodError

resolveInterfaceMethodInternal

private RVMMethod resolveInterfaceMethodInternal(RVMClass declaringClass)

Find the RVMMethod that this member reference refers to using the search order specified in JVM spec 5.4.3.4.

Parameters:

declaringClass - the class that declared the method

Returns:

the RVMMethod that this method ref resolved to or null for error

searchInterfaceMethods

private RVMMethod searchInterfaceMethods(RVMClass c)