ptolemy.actor
Class IOPortEvent

java.lang.Object
  ptolemy.actor.IOPortEvent

All Implemented Interfaces:

DebugEvent

public class IOPortEvent
extends java.lang.Object
implements DebugEvent

An event that is published by an IOPort when a token is sent or received.

In Kepler the provenance recorder and the activity monitor use these events to save intermediate results / show status of the workflow. In the future these events could be used for "smart" reruns or a fault tolerance mechanism.

Since:

Ptolemy II 7.0

Version:

$Id: IOPortEvent.java 54721 2009-06-26 22:32:23Z cxh $

Author:

Oscar Barney, Norbert Podhorszki

Accepted Rating:

Red (barney)

Proposed Rating:

Red (barney)

Field Summary

private int	_channel
private int	_event
private boolean	_outside
private IOPort	_port
private Token	_token
private Token[]	_tokenArray
private int	_vectorLength
static int	ALLCHANNELS The token was broadcast on all channels.
static int	GET_BEGIN An event corresponding with the beginning of a token being received.
static int	GET_END An event corresponding with the ending of a token being received.
static int	SEND Deprecated. Use SEND_BEGIN or SEND_END instead.
static int	SEND_BEGIN An event corresponding with the beginning of a token being sent.
static int	SEND_END An evernt correspoding with the ending of a token being sent.
static int	SINGLETOKEN A single token related event in getVectorLength().

Constructor Summary

IOPortEvent(IOPort port, int event, int channel, boolean outside, Token token)
Create a new port event with the given parameters.

IOPortEvent(IOPort port, int event, int channel, boolean outside, Token[] tokens, int vectorLength)
Create a new port event with the given parameters.

Method Summary

int	getChannel() Return the channel on which the token was sent or received.
int	getEventType() Return the type of event.
boolean	getOutsideFlag() Return the flag indicating that the event related to the port's outside activity (true) or to its inside activity.
IOPort	getPort() Return the port where the event occured.
NamedObj	getSource() Return the port that caused this event.
Token	getToken() Return the token that was sent or received by the IOPort.
Token[]	getTokenArray() Return the array of tokens that the IOPort sent or received.
int	getVectorLength() Return the number of tokens in the array sent by the IOPort.
java.lang.String	toString() Return a string representation of this event.

Methods inherited from class java.lang.Object

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

Field Detail

SEND

public static final int SEND

Deprecated. Use SEND_BEGIN or SEND_END instead.

An event corresponding with a token being sent.

See Also:

Constant Field Values

SEND_BEGIN

public static final int SEND_BEGIN

An event corresponding with the beginning of a token being sent.

See Also:

Constant Field Values

GET_BEGIN

public static final int GET_BEGIN

An event corresponding with the beginning of a token being received.

See Also:

Constant Field Values

GET_END

public static final int GET_END

An event corresponding with the ending of a token being received.

See Also:

Constant Field Values

SEND_END

public static final int SEND_END

An evernt correspoding with the ending of a token being sent.

See Also:

Constant Field Values

ALLCHANNELS

public static final int ALLCHANNELS

The token was broadcast on all channels.

See Also:

Constant Field Values

SINGLETOKEN

public static final int SINGLETOKEN

A single token related event in getVectorLength().

See Also:

Constant Field Values

_channel

private int _channel

_port

private IOPort _port

_event

private int _event

_outside

private boolean _outside

_token

private Token _token

_tokenArray

private Token[] _tokenArray

_vectorLength

private int _vectorLength

Constructor Detail

IOPortEvent

public IOPortEvent(IOPort port,
                   int event,
                   int channel,
                   boolean outside,
                   Token[] tokens,
                   int vectorLength)

Create a new port event with the given parameters. This constructor is used when an array of tokens is sent or received.

Parameters:

port - The IOPort where the event occured.

event - The type of event.

channel - Channel the token was sent/received on. Use IOPortEvent.ALLCHANNELS to indicate a broadcast event.

outside - True if the event is related the port's outside activity, false if the event is related to the port's inside activity.

tokens - The token array used for the send/receive.

vectorLength - The number of tokens sent/received.

IOPortEvent

public IOPortEvent(IOPort port,
                   int event,
                   int channel,
                   boolean outside,
                   Token token)

Create a new port event with the given parameters. This constructor is used when a token is sent or sent inside, received or recevied inside.

Parameters:

port - The IOPort where the event occured

event - The type of event.

channel - Channel the token was sent/received on. Use IOPortEvent.ALLCHANNELS to indicate a broadcast event.

outside - True if the event is related the port's outside activity, false if the event is related to the port's inside activity.

token - The token that was sent/received.

Method Detail

getSource

public NamedObj getSource()

Return the port that caused this event.

Specified by:

getSource in interface DebugEvent

Returns:

The port.

getChannel

public int getChannel()

Return the channel on which the token was sent or received.

Returns:

The channel number.

getEventType

public int getEventType()

Return the type of event.

Returns:

The int event.

getOutsideFlag

public boolean getOutsideFlag()

Return the flag indicating that the event related to the port's outside activity (true) or to its inside activity.

Returns:

The int event.

getPort

public IOPort getPort()

Return the port where the event occured.

Returns:

An instance of IOPort.

getToken

public Token getToken()

Return the token that was sent or received by the IOPort. Return null if the event was for an array of tokens. To get the tokens that were sent use getTokenArray() instead. The condition (getVectorLength == IOPortEvent.SINGLETOKEN) is true if there was a single token involved. It returns null if it was getstart event, since that has no related token at all.

Returns:

The token sent/received by the IOPort.

getTokenArray

public Token[] getTokenArray()

Return the array of tokens that the IOPort sent or received. Return null if an individual token was sent or received instead of an array.

Returns:

The array of tokens which were sent/received.

getVectorLength

public int getVectorLength()

Return the number of tokens in the array sent by the IOPort. Return IOPortEvent.SINGLETOKEN if an individual token was sent instead of an array of tokens.

Returns:

The number of tokens sent by the port.

toString

public java.lang.String toString()

Return a string representation of this event.

Specified by:

toString in interface DebugEvent

Overrides:

toString in class java.lang.Object

Returns:

A user-readable string describing the event.