org.gridgain.grid.events

Class GridTaskEvent

java.lang.Object

org.gridgain.grid.events.GridEventAdapter

org.gridgain.grid.events.GridTaskEvent

All Implemented Interfaces:

Serializable, Comparable<GridEvent>, GridEvent

public class GridTaskEvent
extends GridEventAdapter

Grid task event.

Grid events are used for notification about what happens within the grid. Note that by design GridGain keeps all events generated on the local node locally and it provides APIs for performing a distributed queries across multiple nodes:

• GridEvents.remoteQuery(GridPredicate, long, int...) - asynchronously querying events occurred on the nodes specified, including remote nodes.
• GridEvents.localQuery(GridPredicate, int...) - querying only local events stored on this local node.
• GridEvents.localListen(GridPredicate, int...) - listening to local grid events (events from remote nodes not included).

User can also wait for events using method GridEvents.waitForLocal(GridPredicate, int...).

Events and Performance

Note that by default all events in GridGain are enabled and therefore generated and stored by whatever event storage SPI is configured. GridGain can and often does generate thousands events per seconds under the load and therefore it creates a significant additional load on the system. If these events are not needed by the application this load is unnecessary and leads to significant performance degradation.

It is highly recommended to enable only those events that your application logic requires by using GridConfiguration.getIncludeEventTypes() method in GridGain configuration. Note that certain events are required for GridGain's internal operations and such events will still be generated but not stored by event storage SPI if they are disabled in GridGain configuration.

See Also:

GridEventType.EVT_TASK_FAILED, GridEventType.EVT_TASK_FINISHED, GridEventType.EVT_TASK_REDUCED, GridEventType.EVT_TASK_STARTED, GridEventType.EVT_TASK_SESSION_ATTR_SET, GridEventType.EVT_TASK_TIMEDOUT, GridEventType.EVTS_TASK_EXECUTION, Serialized Form

Constructor Summary

Constructors

Constructor and Description
GridTaskEvent(GridNode node, String msg, int type, GridUuid sesId, String taskName, String taskClsName, boolean internal, UUID subjId) Creates task event with given parameters.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	internal() Returns true if task is created by GridGain and is used for system needs.
String	shortDisplay() Gets a shortened version of toString() result.
UUID	subjectId() Gets security subject ID initiated this task event, if available.
String	taskClassName() Gets name of task class that triggered this event.
String	taskName() Gets name of the task that triggered the event.
GridUuid	taskSessionId() Gets session ID of the task that triggered the event.
String	toString()

Methods inherited from class org.gridgain.grid.events.GridEventAdapter

compareTo, equals, hashCode, id, localOrder, message, message, name, node, node, timestamp, type, type

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

GridTaskEvent

public GridTaskEvent(GridNode node,
             String msg,
             int type,
             GridUuid sesId,
             String taskName,
             String taskClsName,
             boolean internal,
             @Nullable
             UUID subjId)

Creates task event with given parameters.

Parameters:

node - Node.

msg - Optional message.

type - Event type.

sesId - Task session ID.

taskName - Task name.

subjId - Subject ID.

Method Detail

shortDisplay

public String shortDisplay()

Gets a shortened version of toString() result. Suitable for humans to read.

Specified by:

shortDisplay in interface GridEvent

Overrides:

shortDisplay in class GridEventAdapter

Returns:

Shortened version of toString() result.

taskName

public String taskName()

Gets name of the task that triggered the event.

Returns:

Name of the task that triggered the event.

taskClassName

public String taskClassName()

Gets name of task class that triggered this event.

Returns:

Name of task class that triggered the event.

taskSessionId

public GridUuid taskSessionId()

Gets session ID of the task that triggered the event.

Returns:

Session ID of the task that triggered the event.

internal

public boolean internal()

Returns true if task is created by GridGain and is used for system needs.

Returns:

True if task is created by GridGain and is used for system needs.

subjectId

@Nullable
public UUID subjectId()

Gets security subject ID initiated this task event, if available. This property is not available for GridEventType#EVT_TASK_SESSION_ATTR_SET task event.

Subject ID will be set either to node ID or client ID initiated task execution.

Returns:

Subject ID.

toString

public String toString()

Overrides:

toString in class GridEventAdapter