Class CellFactory<T, C extends VFXCell<T>>

java.lang.Object

io.github.palexdev.virtualizedfx.properties.CellFactory<T,C>

All Implemented Interfaces:

Observable, Property<Function<T,C>>, ReadOnlyProperty<Function<T,C>>, ObservableValue<Function<T,C>>, WritableValue<Function<T,C>>

public class CellFactory<T, C extends VFXCell<T>>
extends Object
implements Property<Function<T,C>>

A wrapper for cell creation functions used by virtualized containers.

Encapsulates a cell generation function (create(Object)) along with a reference to the associated VFXContainer, allowing each created cell to access the container instance upon creation. In other words, this wrapper is an easy way to provide all cells the container they belong to without radical API changes.

Basically provides a hook that invokes VFXCell.onCreated(VFXContainer) on each newly generated cell, passing the container instance to the cell. This is particularly useful when cells need contextual information from the container, such as configuration, state, selection handling.

Note 1: nothing prevents you from creating cells using the function directly, however, keep in mind that to automatically make use of the new VFXCell.onCreated(VFXContainer) hook, you must use create(Object) instead.

Note 2: for convenience this extends Property and delegates the implemented methods to the wrapped cell factory property.

Constructor Summary

Constructors

Constructor	Description
CellFactory(VFXContainer<T> owner)

Method Summary

Modifier and Type	Method	Description
void	addListener(InvalidationListener listener)
void	addListener(ChangeListener<? super Function<T,C>> listener)
void	bind(ObservableValue<? extends Function<T,C>> observable)
void	bindBidirectional(Property<Function<T,C>> other)
boolean	canCreate()	Convenience method to check whether the cell generating function is not null.
C	create(T item)	Creates a new cell for the given item, using the current cell factory function.
Object	getBean()
String	getName()
VFXContainer<T>	getOwner()
Function<T,C>	getValue()
boolean	isBound()
protected void	onInvalidated(Function<T,C> newFactory)	Hook method called when the cell factory function is invalidated.
void	removeListener(InvalidationListener listener)
void	removeListener(ChangeListener<? super Function<T,C>> listener)
void	setValue(Function<T,C> value)
void	unbind()
void	unbindBidirectional(Property<Function<T,C>> other)

Methods inherited from class java.lang.Object

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

Methods inherited from interface javafx.beans.Observable

subscribe

Methods inherited from interface javafx.beans.value.ObservableValue

flatMap, map, orElse, subscribe, subscribe, when

Constructor Details

CellFactory

public CellFactory(VFXContainer<T> owner)

Method Details

create

public C create(T item)

Creates a new cell for the given item, using the current cell factory function.

If the factory function is set, it generates a cell, calls VFXCell.onCreated(VFXContainer) on it, and then returns it. Returns null if no factory function is defined.

onInvalidated

protected void onInvalidated(Function<T,C> newFactory)

Hook method called when the cell factory function is invalidated. Subclasses may override this method to handle changes to the factory function.

bind

public void bind(ObservableValue<? extends Function<T,C>> observable)

Specified by:

bind in interface Property<T>

unbind

public void unbind()

Specified by:

unbind in interface Property<T>

isBound

public boolean isBound()

Specified by:

isBound in interface Property<T>

bindBidirectional

public void bindBidirectional(Property<Function<T,C>> other)

Specified by:

bindBidirectional in interface Property<T>

unbindBidirectional

public void unbindBidirectional(Property<Function<T,C>> other)

Specified by:

unbindBidirectional in interface Property<T>

getBean

public Object getBean()

Specified by:

getBean in interface ReadOnlyProperty<T>

getName

public String getName()

Specified by:

getName in interface ReadOnlyProperty<T>

addListener

public void addListener(ChangeListener<? super Function<T,C>> listener)

Specified by:

addListener in interface ObservableValue<T>

removeListener

public void removeListener(ChangeListener<? super Function<T,C>> listener)

Specified by:

removeListener in interface ObservableValue<T>

getValue

public Function<T,C> getValue()

Specified by:

getValue in interface ObservableValue<T>

Specified by:

getValue in interface WritableValue<T>

addListener

public void addListener(InvalidationListener listener)

Specified by:

addListener in interface Observable

removeListener

public void removeListener(InvalidationListener listener)

Specified by:

removeListener in interface Observable

setValue

public void setValue(Function<T,C> value)

Specified by:

setValue in interface WritableValue<T>

getOwner

public VFXContainer<T> getOwner()

Returns:

the container that owns this cell factory and inherently the cells created by it.

canCreate

public boolean canCreate()

Convenience method to check whether the cell generating function is not null.