org.mases.jcobridge

Class JCVoidDelegate

java.lang.Object

org.mases.jcobridge.JCVoidDelegate

public class JCVoidDelegate
extends Object

JVM-side representation of a CLR delegate with a void return type.

Pass an instance of this class (or a subclass) to CLR methods that expect a void delegate parameter. When the CLR invokes the delegate, the bridge calls DelegateInvoked(Object...) without expecting a return value. The CLR delegate type is identified either by its fully qualified name (JCVoidDelegate(String)) or by a pre-resolved JCType handle (JCVoidDelegate(JCType)).

Override DelegateInvoked(Object...) to provide the delegate body. The default implementation is a no-op.

For CLR delegates with a non-void return type, use JCDelegate instead.

See also: JCOReflector for usage examples.

Since:

1.0.0.0

Author:

MASES S.R.L.

Constructor Summary

Constructors

Constructor and Description
JCVoidDelegate(JCType delegateType) Constructs a JCVoidDelegate from a pre-resolved JCType handle.
JCVoidDelegate(String delegateTypeName) Constructs a JCVoidDelegate identified by the fully qualified CLR delegate type name.

Method Summary

Modifier and Type	Method and Description
void	DelegateInvoked(Object... args) Called by the bridge when the CLR invokes this delegate.
JCType	getDelegateType() Returns the pre-resolved CLR delegate type handle, or null if this instance was constructed with a type name string.
String	getDelegateTypeName() Returns the fully qualified CLR delegate type name, or null if this instance was constructed with a JCType handle.

Methods inherited from class java.lang.Object

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

Constructor Detail

JCVoidDelegate

public JCVoidDelegate(String delegateTypeName)

Constructs a JCVoidDelegate identified by the fully qualified CLR delegate type name. The name is resolved by the bridge when the delegate is passed to a CLR method.

Parameters:

delegateTypeName - the fully qualified CLR delegate type name, e.g. "System.Action`1[System.String]".

JCVoidDelegate

public JCVoidDelegate(JCType delegateType)

Constructs a JCVoidDelegate from a pre-resolved JCType handle. Use this overload when the delegate type has already been resolved via JCOBridge.GetType(String) to avoid redundant type lookups.

Parameters:

delegateType - the pre-resolved CLR delegate type handle.

Method Detail

getDelegateTypeName

public String getDelegateTypeName()

Returns the fully qualified CLR delegate type name, or null if this instance was constructed with a JCType handle.

Returns:

the CLR delegate type name.

getDelegateType

public JCType getDelegateType()

Returns the pre-resolved CLR delegate type handle, or null if this instance was constructed with a type name string.

Returns:

the JCType handle for the CLR delegate type.

DelegateInvoked

public void DelegateInvoked(Object... args)

Called by the bridge when the CLR invokes this delegate.

Override this method to provide the delegate body. No return value is expected. The default implementation is a no-op.

Parameters:

args - the arguments passed by the CLR caller, in the order and types declared by the CLR delegate signature.