com.goldencode.proxy

Class ProxyAssembler.ProxyMethod

java.lang.Object

com.goldencode.proxy.ProxyAssembler.ProxyMethod

Direct Known Subclasses:

DmoProxyPlugin.IndexedProxyMethod

Enclosing class:

ProxyAssembler

public static class ProxyAssembler.ProxyMethod
extends java.lang.Object

Helper class to assemble a proxy method. The proxy method delegates its invocation to an instance of java.lang.reflect.Method in the ma array in the containing class.

Pseudo-code for the generated method is:

 public ReturnType methodName([ArgumentList])
 [throws ExceptionList]
 {
    return (ReturnType)
       [Handler].invoke(this,
                        ma[index],
                        [ArgumentList (as Object[])] or null);
 }
 

where:

• index is an index into the enclosing class' array of delegate Method objects ma;
• Handler is the "this" pointer if the proxy itself is the invocation handler, or the "h" instance field if a separate invocation handler is stored within the proxy.

For methods which return void, the return statement and cast to ReturnType are omitted. In the event of an empty argument list, an empty array of type Object is passed to the InvocationHandler.invoke method.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ProxyMethod() Default constructor.

Method Summary

Modifier and Type	Method and Description
void	assemble(org.objectweb.asm.ClassWriter classWriter, org.objectweb.asm.MethodVisitor mv, java.lang.reflect.Method method, int methodIndex, boolean parentIsHandler, java.lang.String proxyName) Assemble the bytecode which comprises the proxy method.

Methods inherited from class java.lang.Object

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

Constructor Detail

ProxyMethod

protected ProxyMethod()

Default constructor.

Method Detail

assemble

public void assemble(org.objectweb.asm.ClassWriter classWriter,
                     org.objectweb.asm.MethodVisitor mv,
                     java.lang.reflect.Method method,
                     int methodIndex,
                     boolean parentIsHandler,
                     java.lang.String proxyName)

Assemble the bytecode which comprises the proxy method.

Parameters:

classWriter - Class writer for proxy class.

mv - Method visitor for this method.

method - Method for which this proxy is being implemented.

methodIndex - Index of this method within the array of methods used by the invocation handler.

parentIsHandler - true if the parent class implements the InvocationHandler interface, else false. If true, no separate instance field will be assembled to store the invocation handler reference, as the instance of this class itself will act as the handler.

proxyName - Internal form of the proxy class' name.