public interface StateChangeListener
State
of the replicated environment and
choosing how to route database operations. State
determines which
operations are currently permitted on the node. For example, only the MASTER
node can execute write
operations.
The Listener is registered with the replicated environment using ReplicatedEnvironment.setStateChangeListener(StateChangeListener)
. There
is at most one Listener associated with the actual environment (not an
Environment
handle) at any given instance in time.
See the examples for information on different approaches toward routing database operations and an example of using the StateChangeListener.
Modifier and Type | Method and Description |
---|---|
void |
stateChange(StateChangeEvent stateChangeEvent)
The notification method.
|
void stateChange(StateChangeEvent stateChangeEvent) throws java.lang.RuntimeException
StateChangeListener
is first associated with the ReplicatedEnvironment
via the ReplicatedEnvironment.setStateChangeListener(StateChangeListener)
method and subsequently each time there is a state change.
This method should do the minimal amount of work, queuing any resource intensive operations for processing by another thread before returning to the caller, so that it does not unduly delay the other housekeeping operations performed by the internal thread which invokes this method.
stateChangeEvent
- the new state change eventjava.lang.RuntimeException
- Any uncaught exceptions will result in the
shutdown of the ReplicatedEnvironment.Copyright (c) 2002, 2017 Oracle and/or its affiliates. All rights reserved.