org.gridgain.grid.spi.communication
Interface GridCommunicationSpi

All Superinterfaces:

GridSpi

All Known Implementing Classes:

GridCoherenceCommunicationSpi, GridJgroupsCommunicationSpi, GridJmsCommunicationSpi, GridMailCommunicationSpi, GridMuleCommunicationSpi, GridTcpCommunicationSpi

@Apache20LicenseCompatible
public interface GridCommunicationSpi
extends GridSpi

Communication SPI is responsible for data exchange between nodes.

Communication SPI is one of the most important SPI in GridGain. It is used heavily throughout the system and provides means for all data exchanges between nodes, such as internal implementation details and user driven messages.

Functionality to this SPI is exposed directly in Grid interface:

• Grid.sendMessage(Collection, Serializable)
• Grid.sendMessage(GridNode, Serializable)
• Grid.addMessageListener(GridMessageListener)

GridGain comes with large set of built-in communication SPI implementations:

• GridCoherenceCommunicationSpi
• GridJgroupsCommunicationSpi
• GridJmsCommunicationSpi
• GridMailCommunicationSpi
• GridMuleCommunicationSpi
• GridTcpCommunicationSpi

See Also:

Documentation
Email Support
Online Forums
Issue Tracking

Author: 2005-2008 Copyright © GridGain Systems. All Rights Reserved. ver. 2.0.3

	Nikita Ivanov, GridGain Systems nivanov@gridgain.com
	Dmitriy Setrakyan, GridGain Systems dsetrakyan@gridgain.com
	Alexander Magdenko, GridGain Systems amagdenko@gridgain.com
	Boris Suchodoev, GridGain Systems bsuchodoev@gridgain.com
	Denis Kharlamov, GridGain Systems dkharlamov@gridgain.com
	close

Method Summary

void	sendMessage(Collection<GridNode> destNodes, Serializable msg) Sends given message to destination nodes.
void	sendMessage(GridNode destNode, Serializable msg) Sends given message to destination node.
void	setListener(GridMessageListener listener) Set communication listener.

Methods inherited from interface org.gridgain.grid.spi.GridSpi

getNodeAttributes, onContextDestroyed, onContextInitialized, spiStart, spiStop

Method Detail

sendMessage

void sendMessage(GridNode destNode,
                 Serializable msg)
                 throws GridSpiException

Sends given message to destination node. Note that characteristics of the exchange such as durability, guaranteed delivery or error notification is dependant on SPI implementation.

Throws:

GridSpiException - Thrown in case of any error during sending the message. Note that this is not guaranteed that failed communication will result in thrown exception as this is dependant on SPI implementation.

Parameters:

destNode - Destination node.

msg - Message to send.

sendMessage

void sendMessage(Collection<GridNode> destNodes,
                 Serializable msg)
                 throws GridSpiException

Sends given message to destination nodes. Note that characteristics of the exchange such as durability, guaranteed delivery or error notification is dependant on SPI implementation.

Throws:

GridSpiException - Thrown in case of any error during sending the message. Note that this is not guaranteed that failed communication will result in thrown exception as this is dependant on SPI implementation.

Parameters:

destNodes - Destination nodes.

msg - Message to send.

setListener

void setListener(GridMessageListener listener)

Set communication listener.

Parameters:

listener - Listener to set or null to unset the listener.