org.gridgain.grid.kernal.processors

Class GridProcessorAdapter

java.lang.Object

org.gridgain.grid.kernal.processors.GridProcessorAdapter

All Implemented Interfaces:

GridComponent, GridProcessor

Direct Known Subclasses:

GridAffinityProcessor, GridCacheProcessor, GridClockSyncProcessor, GridClosureProcessor, GridContinuousProcessor, GridDataLoaderProcessor, GridEmailProcessorAdapter, GridGgfsProcessorAdapter, GridJobMetricsProcessor, GridJobProcessor, GridOffHeapProcessor, GridOsDrProcessor, GridOsLicenseProcessor, GridOsSegmentationProcessor, GridOsVersionProcessor, GridPortProcessor, GridResourceProcessor, GridRestProcessor, GridScheduleProcessorAdapter, GridStreamProcessor, GridTaskProcessor, GridTaskSessionProcessor, GridTimeoutProcessor

public abstract class GridProcessorAdapter
extends Object
implements GridProcessor

Advanced parent adapter for all processor.

Field Summary

Fields

Modifier and Type	Field and Description
protected GridKernalContext	ctx Kernal context.
protected GridLogger	log Grid logger.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	GridProcessorAdapter(GridKernalContext ctx)

Method Summary

Methods

Modifier and Type	Method and Description
void	addAttributes(Map<String,Object> attrs) Adds attributes from this component to map of all node attributes.
protected void	assertParameter(boolean cond, String condDesc) Throws exception with uniform error message if given parameter's assertion condition is false.
Object	collectDiscoveryData(UUID nodeId) Gets discovery data object that will be sent to new node during discovery process.
void	onDiscoveryDataReceived(Object data) Receives discovery data object from remote nodes (called on new node during discovery process).
void	onKernalStart() Callback that notifies that kernal has successfully started, including all managers and processors.
void	onKernalStop(boolean cancel) Callback to notify that kernal is about to stop.
void	printMemoryStats() Prints memory statistics (sizes of internal structures, etc.).
void	start() Starts grid component.
void	stop(boolean cancel) Stops grid component.
String	toString()
GridNodeValidationResult	validateNode(GridNode node) Validates that new node can join grid topology, this method is called on coordinator node before new node joins topology.

Methods inherited from class java.lang.Object

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

Field Detail

ctx

@GridToStringExclude
protected final GridKernalContext ctx

Kernal context.

log

@GridToStringExclude
protected final GridLogger log

Grid logger.

Constructor Detail

GridProcessorAdapter

protected GridProcessorAdapter(GridKernalContext ctx)

Parameters:

ctx - Kernal context.

Method Detail

onKernalStart

public void onKernalStart()
                   throws GridException

Callback that notifies that kernal has successfully started, including all managers and processors.

Specified by:

onKernalStart in interface GridComponent

Throws:

GridException - Thrown in case of any errors.

onKernalStop

public void onKernalStop(boolean cancel)

Callback to notify that kernal is about to stop.

Specified by:

onKernalStop in interface GridComponent

Parameters:

cancel - Flag indicating whether jobs should be canceled.

collectDiscoveryData

@Nullable
public Object collectDiscoveryData(UUID nodeId)

Gets discovery data object that will be sent to new node during discovery process.

Specified by:

collectDiscoveryData in interface GridComponent

Parameters:

nodeId - ID of new node that joins topology.

Returns:

Discovery data object or null if there is nothing to send for this component.

onDiscoveryDataReceived

public void onDiscoveryDataReceived(Object data)

Receives discovery data object from remote nodes (called on new node during discovery process).

Specified by:

onDiscoveryDataReceived in interface GridComponent

Parameters:

data - Discovery data object or null if nothing was sent for this component.

start

public void start()
           throws GridException

Starts grid component.

Specified by:

start in interface GridComponent

Throws:

GridException - Throws in case of any errors.

stop

public void stop(boolean cancel)
          throws GridException

Stops grid component.

Specified by:

stop in interface GridComponent

Parameters:

cancel - If true, then all ongoing tasks or jobs for relevant components need to be cancelled.

Throws:

GridException - Thrown in case of any errors.

assertParameter

protected final void assertParameter(boolean cond,
                   String condDesc)
                              throws GridException

Throws exception with uniform error message if given parameter's assertion condition is false.

Parameters:

cond - Assertion condition to check.

condDesc - Description of failed condition. Note that this description should include JavaBean name of the property (not a variable name) as well condition in Java syntax like, for example:

      ...
      assertParameter(dirPath != null, "dirPath != null");
      ...
      

Note that in case when variable name is the same as JavaBean property you can just copy Java condition expression into description as a string.

Throws:

GridException - Thrown if given condition is false

printMemoryStats

public void printMemoryStats()

Prints memory statistics (sizes of internal structures, etc.). NOTE: this method is for testing and profiling purposes only.

Specified by:

printMemoryStats in interface GridComponent

addAttributes

public void addAttributes(Map<String,Object> attrs)
                   throws GridException

Adds attributes from this component to map of all node attributes.

Specified by:

addAttributes in interface GridProcessor

Parameters:

attrs - Map of all attributes.

Throws:

GridException - If failed.

validateNode

@Nullable
public GridNodeValidationResult validateNode(GridNode node)

Validates that new node can join grid topology, this method is called on coordinator node before new node joins topology.

Specified by:

validateNode in interface GridComponent

Parameters:

node - Joining node.

Returns:

Validation result or null in case of success.

toString

public String toString()

Overrides:

toString in class Object