org.cometd.oort

Class OortList<E>

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.cometd.oort.OortObject<List<E>>

org.cometd.oort.OortList<E>

Type Parameters:

E - the element type

All Implemented Interfaces:

Iterable<OortObject.Info<List<E>>>, EventListener, org.cometd.bayeux.server.ConfigurableServerChannel.Initializer, Oort.CometListener, org.eclipse.jetty.util.component.LifeCycle

public class OortList<E>
extends OortObject<List<E>>

A specialized oort object whose entity is a List.

OortList specializes OortObject and allows optimized replication of elements across the cluster: instead of replicating the whole list, that may be contain a lot of elements, only elements that are added or removed are replicated.

Applications can use addAndShare(Object[]) and removeAndShare(Object[]) to broadcast changes related to elements, as well as OortObject.setAndShare(Object) to change the whole list.

When one or more elements are changed, OortList.ElementListeners are notified. OortList.DeltaListener converts whole list updates triggered by OortObject.setAndShare(Object) into events for OortList.ElementListeners, giving applications a single listener type to implement their business logic.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	OortList.DeltaListener<E> An implementation of Listener that converts whole list events into OortList.ElementListener events.
static interface	OortList.ElementListener<E> Listener for element events that update the entity list, either locally or remotely.

Nested classes/interfaces inherited from class org.cometd.oort.OortObject

OortObject.Data<T>, OortObject.Factory<T>, OortObject.Info<T>, OortObject.Listener<T>, OortObject.Merger<T,R>

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface org.cometd.bayeux.server.ConfigurableServerChannel.Initializer

org.cometd.bayeux.server.ConfigurableServerChannel.Initializer.Persistent

Nested classes/interfaces inherited from interface org.cometd.oort.Oort.CometListener

Oort.CometListener.Adapter, Oort.CometListener.Event

Field Summary

Fields inherited from class org.cometd.oort.OortObject

logger, OORT_OBJECTS_CHANNEL

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor and Description
OortList(Oort oort, String name, OortObject.Factory<List<E>> factory)

Method Summary

Modifier and Type	Method and Description
boolean	addAndShare(E... elements) Adds the given elements to the local entity list, and then broadcasts the addition to all nodes in the cluster.
void	addElementListener(OortList.ElementListener<E> listener)
boolean	contains(E element) Returns whether the given element is present in the local entity list of this node.
boolean	isPresent(E element) Returns whether the given element is present in one of the entity lists of all nodes.
protected void	onObject(Map<String,Object> data)
boolean	removeAndShare(E... elements) Removes the given elements to the local entity list, and then broadcasts the removal to all nodes in the cluster.
void	removeElementListener(OortList.ElementListener<E> listener)

Methods inherited from class org.cometd.oort.OortObject

addListener, cometJoined, cometLeft, configureChannel, deserialize, doStart, doStop, getChannelName, getFactory, getInfo, getInfoByObject, getInfos, getLocalSession, getName, getOort, iterator, merge, newInfo, nextVersion, notifyRemoved, notifyUpdated, pushInfo, removeListener, serialize, setAndShare, setInfo, toString

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, setStopTimeout, start, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

OortList

public OortList(Oort oort,
                String name,
                OortObject.Factory<List<E>> factory)

Method Detail

addElementListener

public void addElementListener(OortList.ElementListener<E> listener)

removeElementListener

public void removeElementListener(OortList.ElementListener<E> listener)

contains

public boolean contains(E element)

Returns whether the given element is present in the local entity list of this node. Differently from isPresent(Object), only the local entity list is scanned.

Parameters:

element - the element to test for presence

Returns:

true if the element is contained in the local entity list, false otherwise

isPresent

public boolean isPresent(E element)

Returns whether the given element is present in one of the entity lists of all nodes. Differently from contains(Object) entity lists of all nodes are scanned.

Parameters:

element - the element to test for presence

Returns:

true if the element is contained in one of the entity lists of all nodes, false otherwise

addAndShare

public boolean addAndShare(E... elements)

Adds the given elements to the local entity list, and then broadcasts the addition to all nodes in the cluster.

Calling this method triggers notifications OortList.ElementListeners, both on this node and on remote nodes.

Parameters:

elements - the elements to add

Returns:

whether at least one of the elements was added to the local entity list

removeAndShare

public boolean removeAndShare(E... elements)

Removes the given elements to the local entity list, and then broadcasts the removal to all nodes in the cluster.

Calling this method triggers notifications OortList.ElementListeners, both on this node and on remote nodes.

Parameters:

elements - the elements to remove

Returns:

whether at least one of the elements was removed from the local entity list

onObject

protected void onObject(Map<String,Object> data)

Overrides:

onObject in class OortObject<List<E>>