org.mases.jcobridge

Class JCListener

java.lang.Object

org.mases.jcobridge.JCListener

All Implemented Interfaces:

IJCListener

public class JCListener
extends Object
implements IJCListener

The JCListener class represents a generic implementation of event raiser class to CLR

Extend this class and implement the event of interest. An implementation of ActionListener is the following one. It can be used as starting point example, it pairs with the example in C# documentation counterpart:

 public final class JCActionListener extends JCListener implements ActionListener {
    public JCActionListener(String key) throws JCNativeException {
       super(key);
    }

    public void actionPerformed(ActionEvent e) {
       raiseEvent("actionPerformed", e);
    }
 }
 

Since:

2.0.0.0

Author:

MASES S.R.L.

Constructor Summary

Constructors

Constructor and Description
JCListener(String key)

Method Summary

Modifier and Type	Method and Description
Object[]	extraData() Invoked from the CLR to get extra information.
int	extraDataLength() Invoked from the CLR to know how many Object contains extra information.
Object	getEventData() Invoked from the CLR counterpart to get the event Object.
Object	getReturnData() Invoked from the JVM to get the event return Object.
boolean	hasExtraData() Invoked from the CLR to know if the event has extra information.
void	raiseEvent(String eventName) Invoked when an action occurs.
void	raiseEvent(String eventName, Object e) Invoked when an action occurs.
void	raiseEvent(String eventName, Object e, Object... objects) Invoked when an action occurs.
void	release() Invoked when the CLR counterpart request to release the instance.
void	setReturnData(Object retData) Invoked from the CLR counterpart to set the event return Object.

Methods inherited from class java.lang.Object

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

Constructor Detail

JCListener

public JCListener(String key)
           throws JCNativeException

Throws:

JCNativeException

Method Detail

release

public void release()

Invoked when the CLR counterpart request to release the instance.

Specified by:

release in interface IJCListener

raiseEvent

public void raiseEvent(String eventName)

Invoked when an action occurs.

Specified by:

raiseEvent in interface IJCListener

Parameters:

eventName - The name of the remote method to be invoked

raiseEvent

public void raiseEvent(String eventName,
                       Object e)

Invoked when an action occurs.

Specified by:

raiseEvent in interface IJCListener

Parameters:

eventName - The name of the remote method to be invoked

e - The event raised

raiseEvent

public void raiseEvent(String eventName,
                       Object e,
                       Object... objects)

Invoked when an action occurs.

Specified by:

raiseEvent in interface IJCListener

Parameters:

eventName - The name of the remote method to be invoked

e - The event raised

objects - Extra objects associated to the event

getEventData

public Object getEventData()

Invoked from the CLR counterpart to get the event Object.

Specified by:

getEventData in interface IJCListener

Returns:

The Object associated to the event raised

hasExtraData

public boolean hasExtraData()

Invoked from the CLR to know if the event has extra information.

Specified by:

hasExtraData in interface IJCListener

Returns:

True if extra information is available

Since:

2.4.2.0

extraDataLength

public int extraDataLength()

Invoked from the CLR to know how many Object contains extra information.

Specified by:

extraDataLength in interface IJCListener

Returns:

The length of extra data

Since:

2.4.2.0

extraData

public Object[] extraData()

Invoked from the CLR to get extra information.

Specified by:

extraData in interface IJCListener

Returns:

An array of extra information ordered with the same order of the caller

Since:

2.4.2.0

getReturnData

public Object getReturnData()

Invoked from the JVM to get the event return Object.

Specified by:

getReturnData in interface IJCListener

Returns:

The Object returned from the event raised

Since:

2.4.2.0

setReturnData

public void setReturnData(Object retData)

Invoked from the CLR counterpart to set the event return Object.

Specified by:

setReturnData in interface IJCListener

Parameters:

retData - The Object returned from CLR

Since:

2.4.2.0