com.gluonhq.connect

Class GluonObservableList<E>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

javafx.collections.ObservableListBase<E>

javafx.collections.ModifiableObservableListBase<E>

com.gluonhq.connect.GluonObservableList<E>

Type Parameters:

E - the type of the elements inside this list

All Implemented Interfaces:

GluonObservable, java.lang.Iterable<E>, java.util.Collection<E>, java.util.List<E>, javafx.beans.Observable, javafx.collections.ObservableList<E>, javafx.event.EventTarget

public class GluonObservableList<E>
extends javafx.collections.ModifiableObservableListBase<E>
implements GluonObservable, javafx.collections.ObservableList<E>

A GluonObservableList is an ObservableList that is linked with a data source.

See Also:

DataProvider.retrieveList(ListDataReader)

Property Summary

Type	Property and Description
javafx.beans.property.ReadOnlyObjectProperty<java.lang.Throwable>	exception Holds the exception that was thrown when a synchronization operation failed.
javafx.beans.property.ReadOnlyBooleanProperty	initialized A boolean property that is true when the observable has been initialized successfully after its initial retrieval.
javafx.beans.property.ReadOnlyObjectProperty<ConnectState>	state Holds the current state of this observable.

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
GluonObservableList()

Method Summary

Modifier and Type	Method and Description
javafx.event.EventDispatchChain	buildEventDispatchChain(javafx.event.EventDispatchChain tail)
protected void	doAdd(int index, E element) Adds the element to the List at the position of index.
protected E	doRemove(int index) Removes the element at position of index.
protected E	doSet(int index, E element) Sets the element in the List at the position of index.
javafx.beans.property.ReadOnlyObjectProperty<java.lang.Throwable>	exceptionProperty() Holds the exception that was thrown when a synchronization operation failed.
E	get(int index) Returns the element at the specified position in this list.
java.lang.Throwable	getException() Gets the value of the property exception.
ConnectState	getState() Gets the value of the property state.
javafx.beans.property.ReadOnlyBooleanProperty	initializedProperty() A boolean property that is true when the observable has been initialized successfully after its initial retrieval.
boolean	isInitialized() Gets the value of the property initialized.
void	setException(java.lang.Throwable exception) Sets the value of the property exception.
void	setOnCancelled(javafx.event.EventHandler<ConnectStateEvent> value) The onCancelled event handler is called whenever the GluonObservable state transitions to the CANCELLED state.
void	setOnFailed(javafx.event.EventHandler<ConnectStateEvent> value) The onFailed event handler is called whenever the GluonObservable state transitions to the FAILED state.
void	setOnReady(javafx.event.EventHandler<ConnectStateEvent> value) The onReady event handler is called whenever the GluonObservable state transitions to the READY state.
void	setOnRemoved(javafx.event.EventHandler<ConnectStateEvent> value) The onRemoved event handler is called whenever the GluonObservable state transitions to the REMOVED state.
void	setOnRunning(javafx.event.EventHandler<ConnectStateEvent> value) The onRunning event handler is called whenever the GluonObservable state transitions to the RUNNING state.
void	setOnSucceeded(javafx.event.EventHandler<ConnectStateEvent> value) The onSucceeded event handler is called whenever the GluonObservable state transitions to the SUCCEEDED state.
void	setState(ConnectState state) Sets the value of the property state.
int	size() Returns the number of elements in this list.
javafx.beans.property.ReadOnlyObjectProperty<ConnectState>	stateProperty() Holds the current state of this observable.

Methods inherited from class javafx.collections.ModifiableObservableListBase

add, addAll, addAll, remove, remove, removeAll, removeRange, retainAll, set, setAll, subList

Methods inherited from class javafx.collections.ObservableListBase

addAll, addListener, addListener, beginChange, endChange, fireChange, hasListeners, nextAdd, nextPermutation, nextRemove, nextRemove, nextReplace, nextSet, nextUpdate, remove, removeAll, removeListener, removeListener, retainAll, setAll

Methods inherited from class java.util.AbstractList

add, clear, equals, hashCode, indexOf, iterator, lastIndexOf, listIterator, listIterator

Methods inherited from class java.util.AbstractCollection

contains, containsAll, isEmpty, toArray, toArray, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface javafx.collections.ObservableList

addAll, addListener, filtered, remove, removeAll, removeListener, retainAll, setAll, setAll, sorted, sorted

Methods inherited from interface java.util.List

add, add, addAll, addAll, clear, contains, containsAll, equals, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, replaceAll, retainAll, set, sort, spliterator, subList, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface javafx.beans.Observable

addListener, removeListener

Property Detail

initialized

public javafx.beans.property.ReadOnlyBooleanProperty initializedProperty

Specified by:

initializedProperty in interface GluonObservable

See Also:

isInitialized()

state

public javafx.beans.property.ReadOnlyObjectProperty<ConnectState> stateProperty

Specified by:

stateProperty in interface GluonObservable

See Also:

getState(), setState(ConnectState)

exception

public javafx.beans.property.ReadOnlyObjectProperty<java.lang.Throwable> exceptionProperty

Specified by:

exceptionProperty in interface GluonObservable

See Also:

getException(), setException(Throwable)

Constructor Detail

GluonObservableList

public GluonObservableList()

Method Detail

isInitialized

public boolean isInitialized()

Gets the value of the property initialized.

Specified by:

isInitialized in interface GluonObservable

Returns:

true when the observable is initialized; false otherwise.

initializedProperty

public javafx.beans.property.ReadOnlyBooleanProperty initializedProperty()

Description copied from interface: GluonObservable

A boolean property that is true when the observable has been initialized successfully after its initial retrieval.

Specified by:

initializedProperty in interface GluonObservable

See Also:

isInitialized()

getState

public ConnectState getState()

Gets the value of the property state.

Specified by:

getState in interface GluonObservable

Returns:

the current state

setState

public void setState(ConnectState state)

Sets the value of the property state.

stateProperty

public javafx.beans.property.ReadOnlyObjectProperty<ConnectState> stateProperty()

Description copied from interface: GluonObservable

Holds the current state of this observable. This property can be used to listen for changes in the synchronization process.

Specified by:

stateProperty in interface GluonObservable

See Also:

getState(), setState(ConnectState)

getException

public java.lang.Throwable getException()

Gets the value of the property exception.

Specified by:

getException in interface GluonObservable

Returns:

the exception, if one has occurred; otherwise null.

setException

public void setException(java.lang.Throwable exception)

Sets the value of the property exception.

exceptionProperty

public javafx.beans.property.ReadOnlyObjectProperty<java.lang.Throwable> exceptionProperty()

Description copied from interface: GluonObservable

Holds the exception that was thrown when a synchronization operation failed.

Specified by:

exceptionProperty in interface GluonObservable

See Also:

getException(), setException(Throwable)

setOnReady

public void setOnReady(javafx.event.EventHandler<ConnectStateEvent> value)

Description copied from interface: GluonObservable

The onReady event handler is called whenever the GluonObservable state transitions to the READY state.

Specified by:

setOnReady in interface GluonObservable

Parameters:

value - the event handler, can be null to clear it

setOnRunning

public void setOnRunning(javafx.event.EventHandler<ConnectStateEvent> value)

Description copied from interface: GluonObservable

The onRunning event handler is called whenever the GluonObservable state transitions to the RUNNING state.

Specified by:

setOnRunning in interface GluonObservable

Parameters:

value - the event handler, can be null to clear it

setOnFailed

public void setOnFailed(javafx.event.EventHandler<ConnectStateEvent> value)

Description copied from interface: GluonObservable

The onFailed event handler is called whenever the GluonObservable state transitions to the FAILED state.

Specified by:

setOnFailed in interface GluonObservable

Parameters:

value - the event handler, can be null to clear it

setOnSucceeded

public void setOnSucceeded(javafx.event.EventHandler<ConnectStateEvent> value)

Description copied from interface: GluonObservable

The onSucceeded event handler is called whenever the GluonObservable state transitions to the SUCCEEDED state.

Specified by:

setOnSucceeded in interface GluonObservable

Parameters:

value - the event handler, can be null to clear it

setOnCancelled

public void setOnCancelled(javafx.event.EventHandler<ConnectStateEvent> value)

Description copied from interface: GluonObservable

The onCancelled event handler is called whenever the GluonObservable state transitions to the CANCELLED state.

Specified by:

setOnCancelled in interface GluonObservable

Parameters:

value - the event handler, can be null to clear it

setOnRemoved

public void setOnRemoved(javafx.event.EventHandler<ConnectStateEvent> value)

Description copied from interface: GluonObservable

The onRemoved event handler is called whenever the GluonObservable state transitions to the REMOVED state.

Specified by:

setOnRemoved in interface GluonObservable

Parameters:

value - the event handler, can be null to clear it

get

public E get(int index)

Returns the element at the specified position in this list.

Specified by:

get in interface java.util.List<E>

Specified by:

get in class javafx.collections.ModifiableObservableListBase<E>

Parameters:

index - index of the element to return

Returns:

the element at the specified position in this list

size

public int size()

Returns the number of elements in this list.

Specified by:

size in interface java.util.Collection<E>

Specified by:

size in interface java.util.List<E>

Specified by:

size in class javafx.collections.ModifiableObservableListBase<E>

Returns:

the number of elements in this list

doAdd

protected void doAdd(int index,
                     E element)

Adds the element to the List at the position of index.

For the description of possible exceptions, please refer to the documentation of AbstractList.add(java.lang.Object) method.

Specified by:

doAdd in class javafx.collections.ModifiableObservableListBase<E>

Parameters:

index - the position where to add the element

element - the element that will be added

Throws:

java.lang.ClassCastException

java.lang.NullPointerException

java.lang.IllegalArgumentException

java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index > size())

doSet

protected E doSet(int index,
                  E element)

Sets the element in the List at the position of index.

For the description of possible exceptions, please refer to the documentation of ModifiableObservableListBase.set(int, java.lang.Object) method.

Specified by:

doSet in class javafx.collections.ModifiableObservableListBase<E>

Parameters:

index - the position where to set the element

element - the element that will be set at the specified position

Returns:

the old element at the specified position

Throws:

java.lang.ClassCastException

java.lang.NullPointerException

java.lang.IllegalArgumentException

java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())

doRemove

protected E doRemove(int index)

Removes the element at position of index.

Specified by:

doRemove in class javafx.collections.ModifiableObservableListBase<E>

Parameters:

index - the index of the removed element

Returns:

the removed element

Throws:

java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())

buildEventDispatchChain

public javafx.event.EventDispatchChain buildEventDispatchChain(javafx.event.EventDispatchChain tail)

Specified by:

buildEventDispatchChain in interface javafx.event.EventTarget