NodeExtension (hazelcast-client-protocol 1.0.0 API)

All Known Implementing Classes:

DefaultNodeExtension
```
public interface NodeExtension
```
NodeExtension is a Node extension mechanism to be able to plug different implementations of some modules, like; SerializationService, SocketChannelWrapperFactory etc.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`afterStart()` Called after node is started
`void`	`beforeJoin()` Called before node attempts to join to the cluster
`void`	`beforeShutdown()` Called before `Node.shutdown()`
`void`	`beforeStart()` Called before node is started
`Map<String,Object>`	`createExtensionServices()` Creates additional extension services, which will be registered by service manager during start-up.
`ReadHandler`	`createReadHandler(TcpIpConnection connection, IOService ioService)` Creates a `ReadHandler` for given `Connection` instance.
`SerializationService`	`createSerializationService()` Creates a `SerializationService` instance to be used by this `Node`.
`<T> T`	`createService(Class<T> type)` Creates a service which is an implementation of given type parameter.
`WriteHandler`	`createWriteHandler(TcpIpConnection connection, IOService ioService)` Creates a `WriteHandler` for given `Connection` instance.
`MemberSocketInterceptor`	`getMemberSocketInterceptor()` Returns `MemberSocketInterceptor` for this `Node` if available, otherwise returns null.
`MemoryStats`	`getMemoryStats()` Returns MemoryStats of for the JVM and current HazelcastInstance.
`SecurityContext`	`getSecurityContext()` Returns `SecurityContext` for this `Node` if available, otherwise returns null.
`SocketChannelWrapperFactory`	`getSocketChannelWrapperFactory()` Returns `SocketChannelWrapperFactory` instance to be used by this `Node`.
`boolean`	`isStartCompleted()` Returns true if the instance has started
`void`	`onClusterStateChange(ClusterState newState, boolean persistentChange)` Called when cluster state is changed
`void`	`onThreadStart(Thread thread)` Called on thread start to inject/intercept extension specific logic, like; registering thread in some service, executing a special method before thread starts to do its own task.
`void`	`onThreadStop(Thread thread)` Called before a thread stops to clean/release injected by `onThreadStart(Thread)`.
`void`	`printNodeInfo()` Called to print node information during startup
`boolean`	`registerListener(Object listener)` Registers given register if it's a known type.
`void`	`shutdown()` Shutdowns `NodeExtension`.
`boolean`	`triggerForceStart()` Forces node to start by skipping hot-restart completely and removing all hot-restart data even if node is still on validation phase or loading hot-restart data.
`void`	`validateJoinRequest()` Called before a new node is joining to cluster, executed if node is the master node before join event.

- Method Detail
  - beforeStart
```
void beforeStart()
```
    Called before node is started
  - printNodeInfo
```
void printNodeInfo()
```
    Called to print node information during startup
  - beforeJoin
```
void beforeJoin()
```
    Called before node attempts to join to the cluster
  - afterStart
```
void afterStart()
```
    Called after node is started
  - isStartCompleted
```
boolean isStartCompleted()
```
    Returns true if the instance has started
  - createSerializationService
```
SerializationService createSerializationService()
```
    Creates a SerializationService instance to be used by this Node.
    
    Returns:
    a SerializationService instance
  - getSecurityContext
```
SecurityContext getSecurityContext()
```
    Returns SecurityContext for this Node if available, otherwise returns null.
    
    Returns:
    security context
  - createService
```
<T> T createService(Class<T> type)
```
    Creates a service which is an implementation of given type parameter.
    
    Parameters:
    type - type of service
    
    Returns:
    service implementation
    
    Throws:
    
    IllegalArgumentException - if type is not known
  - createExtensionServices
```
Map<String,Object> createExtensionServices()
```
    Creates additional extension services, which will be registered by service manager during start-up. By default returned map will be empty.
    
    Returns:
    extension services
  - getMemberSocketInterceptor
```
MemberSocketInterceptor getMemberSocketInterceptor()
```
    Returns MemberSocketInterceptor for this Node if available, otherwise returns null.
    
    Returns:
    MemberSocketInterceptor
  - getSocketChannelWrapperFactory
```
SocketChannelWrapperFactory getSocketChannelWrapperFactory()
```
    Returns SocketChannelWrapperFactory instance to be used by this Node.
    
    Returns:
    SocketChannelWrapperFactory
  - createReadHandler
```
ReadHandler createReadHandler(TcpIpConnection connection,
                            IOService ioService)
```
    Creates a ReadHandler for given Connection instance.
    
    Parameters:
    connection - tcp-ip connection
    ioService - IOService
    
    Returns:
    the created ReadHandler.
  - createWriteHandler
```
WriteHandler createWriteHandler(TcpIpConnection connection,
                              IOService ioService)
```
    Creates a WriteHandler for given Connection instance.
    
    Parameters:
    connection - tcp-ip connection
    ioService - IOService
    
    Returns:
    the created WriteHandler
  - onThreadStart
```
void onThreadStart(Thread thread)
```
    Called on thread start to inject/intercept extension specific logic, like; registering thread in some service, executing a special method before thread starts to do its own task.
    
    Parameters:
    thread - thread starting
  - onThreadStop
```
void onThreadStop(Thread thread)
```
    Called before a thread stops to clean/release injected by onThreadStart(Thread).
    
    Parameters:
    thread - thread stopping
  - getMemoryStats
```
MemoryStats getMemoryStats()
```
    Returns MemoryStats of for the JVM and current HazelcastInstance.
    
    Returns:
    memory statistics
  - beforeShutdown
```
void beforeShutdown()
```
    Called before Node.shutdown()
  - shutdown
```
void shutdown()
```
    Shutdowns NodeExtension. Called on Node.shutdown()
  - validateJoinRequest
```
void validateJoinRequest()
```
    Called before a new node is joining to cluster, executed if node is the master node before join event. ClusterJoinManager calls this method, when handleJoinRequest method is called. By this way, we can check the logic we want by implementing this method. Implementation should throw required exception, with a valid message which explains rejection reason.
  - onClusterStateChange
```
void onClusterStateChange(ClusterState newState,
                        boolean persistentChange)
```
    Called when cluster state is changed
    
    Parameters:
    newState - new state
    persistentChange - status of the change. A cluster state change may be non-persistent if it has been done temporarily during system operations such cluster start etc.
  - registerListener
```
boolean registerListener(Object listener)
```
    Registers given register if it's a known type.
    
    Parameters:
    listener - listener instance
    
    Returns:
    true if listener is registered, false otherwise
  - triggerForceStart
```
boolean triggerForceStart()
```
    Forces node to start by skipping hot-restart completely and removing all hot-restart data even if node is still on validation phase or loading hot-restart data.
    
    Returns:
    true if hot restart is enabled and this node knows the master

Interface NodeExtension

Method Summary

Method Detail

beforeStart

printNodeInfo

beforeJoin

afterStart

isStartCompleted

createSerializationService

getSecurityContext

createService

createExtensionServices

getMemberSocketInterceptor

getSocketChannelWrapperFactory

createReadHandler

createWriteHandler

onThreadStart

onThreadStop

getMemoryStats

beforeShutdown

shutdown

validateJoinRequest

onClusterStateChange

registerListener

triggerForceStart