Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
  * See the file LICENSE for redistribution information.
  * Copyright (c) 2002, 2013 Oracle and/or its affiliates.  All rights reserved.

An asynchronous mechanism for tracking the ReplicatedEnvironment.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 ReplicatedEnvironment.State.MASTER node can execute write operations.

The Listener is registered with the replicated environment using ReplicatedEnvironment.setStateChangeListener( There is at most one Listener associated with the actual environment (not an handle) at any given instance in time.

See the href="{@docRoot/../examples/je/rep/quote/package-summary.html"> examples} for information on different approaches toward routing database operations and an example of using the StateChangeListener.

See also:
Managing Write Requests at a Replica
public interface StateChangeListener {

The notification method. It is initially invoked when the StateChangeListener is first associated with the ReplicatedEnvironment via the ReplicatedEnvironment.setStateChangeListener( 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 event
java.lang.RuntimeException Any uncaught exceptions will result in the shutdown of the ReplicatedEnvironment.
   public void stateChange(StateChangeEvent stateChangeEvent)
       throws RuntimeException;
New to GrepCode? Check out our FAQ X