org.jikesrvm.classloader

Class InterfaceInvocation

java.lang.Object

org.jikesrvm.classloader.InterfaceInvocation

public class InterfaceInvocation
extends Object

Runtime system mechanisms and data structures to implement interface invocation.

We support two mechanisms:

   IMT-based (Alpern, Cocchi, Fink, Grove, and Lieber OOPSLA'01).
   ITable-based (searched at dispatch time with 1 entry move-to-front cache)
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	InterfaceInvocation.IMTDict

Constructor Summary

Constructors

Constructor and Description
InterfaceInvocation()

Method Summary

Modifier and Type	Method and Description
private static InterfaceInvocation.IMTDict	buildIMTDict(RVMClass klass, RVMClass[] interfaces) Build up a description of the IMT contents for the given class.
private static ITable	buildITable(RVMClass C, RVMClass I)
static ITable	findITable(TIB tib, int id) Return a reference to the itable for a given class, interface pair We might not have created the iTable yet, in which case we will do that and then return it.
static int	getITableIndex(RVMClass klass, Atom mname, Atom mdesc)
static void	initializeDispatchStructures(RVMClass klass) Main entrypoint called from RVMClass.instantiate to initialize the interface dispatching data structures for the given class.
private static void	installITable(RVMClass C, RVMClass I)
static CodeArray	invokeInterface(Object target, int mid) Resolve an interface method call.
private static void	populateIMT(RVMClass klass, InterfaceInvocation.IMTDict d)
static void	unresolvedInvokeinterfaceImplementsTest(int mid, Object rhsObject) mid is the dictionary id of an interface method we are trying to invoke RHStib is the TIB of an object on which we are attempting to invoke it.
static void	updateTIBEntry(RVMClass klass, RVMMethod m) If there is an an IMT or ITable entry that contains compiled code for the argument method, then update it to contain the current compiled code for the method.

Methods inherited from class java.lang.Object

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

Constructor Detail

InterfaceInvocation

public InterfaceInvocation()

Method Detail

invokeInterface

public static CodeArray invokeInterface(Object target,
                                        int mid)
                                 throws IncompatibleClassChangeError

Resolve an interface method call. This routine is never called by the IMT-based dispatching code. It is only called for directly indexed ITables when the table index was unknown at compile time (i.e. the target Interface was not loaded).

Parameters:

target - object to which interface method is to be applied

mid - id of the MemberReference for the target interface method.

Returns:

machine code corresponding to desired interface method

Throws:

IncompatibleClassChangeError

findITable

public static ITable findITable(TIB tib,
                                int id)
                         throws IncompatibleClassChangeError

Return a reference to the itable for a given class, interface pair We might not have created the iTable yet, in which case we will do that and then return it.

Parameters:

tib - the TIB for the class

id - interface id of the interface sought (NOT dictionary id!!)

Returns:

iTable for desired interface

Throws:

IncompatibleClassChangeError

unresolvedInvokeinterfaceImplementsTest

public static void unresolvedInvokeinterfaceImplementsTest(int mid,
                                                           Object rhsObject)
                                                    throws IncompatibleClassChangeError

mid is the dictionary id of an interface method we are trying to invoke RHStib is the TIB of an object on which we are attempting to invoke it. We were unable to resolve the member reference at compile time. Therefore we must resolve it now and then call invokeinterfaceImplementsTest with the right LHSclass.

Parameters:

mid - Dictionary id of the MemberReference for the target interface method.

rhsObject - The object on which we are attempting to invoke the interface method

Throws:

IncompatibleClassChangeError

initializeDispatchStructures

public static void initializeDispatchStructures(RVMClass klass)

Main entrypoint called from RVMClass.instantiate to initialize the interface dispatching data structures for the given class.

Parameters:

klass - the RVMClass to initialize the dispatch structures for.

buildIMTDict

private static InterfaceInvocation.IMTDict buildIMTDict(RVMClass klass,
                                                        RVMClass[] interfaces)

Build up a description of the IMT contents for the given class. NOTE: this structure is only used during class loading, so we don't have to worry about making it space efficient.

Parameters:

klass - the RVMClass whose IMT we are going to build.

interfaces - the interfaces that the class implements

Returns:

an IMTDict that describes the IMT we need to build for the class.

populateIMT

private static void populateIMT(RVMClass klass,
                                InterfaceInvocation.IMTDict d)

installITable

private static void installITable(RVMClass C,
                                  RVMClass I)

buildITable

private static ITable buildITable(RVMClass C,
                                  RVMClass I)

getITableIndex

public static int getITableIndex(RVMClass klass,
                                 Atom mname,
                                 Atom mdesc)

Parameters:

klass - the interface class

mname - method name

mdesc - method descriptor

Returns:

the index of the interface method m in the itable or -1 if none found

updateTIBEntry

public static void updateTIBEntry(RVMClass klass,
                                  RVMMethod m)

If there is an an IMT or ITable entry that contains compiled code for the argument method, then update it to contain the current compiled code for the method.

Parameters:

klass - the RVMClass who's IMT/ITable is being reset

m - the method that needs to be updated.