Package com.palmer.billingstatementgenerator.views.controllers

Class GridTabController<T>

java.lang.Object

com.palmer.billingstatementgenerator.views.controllers.BaseController

com.palmer.billingstatementgenerator.views.controllers.GridTabController<T>

Type Parameters:

T - the line item type displayed in this tab

Direct Known Subclasses:

CashAdvanceController, MerchandiseController, ServicesController, SpecialChargesController

public abstract class GridTabController<T>
extends BaseController

Abstract base controller for tabs that display a grid of selectable line items. Handles building the item grid, managing checkboxes, wiring the clear button, clearing selections, and displaying a running total at the bottom of the tab.

Field Summary

Fields

Modifier and Type	Field	Description
protected javafx.scene.layout.GridPane	itemsGrid	The grid pane containing the line item rows.

Fields inherited from class com.palmer.billingstatementgenerator.views.controllers.BaseController

clearButton, DOLLAR_FORMATTER, nextButton

Constructor Summary

Constructors

Constructor	Description
GridTabController()

Method Summary

Modifier and Type	Method	Description
protected abstract javafx.scene.control.CheckBox	addItemRow(T item, int row)	Builds and adds a single row to the items grid for the given line item.
protected void	addValidationPair(javafx.scene.control.CheckBox cb, javafx.beans.value.ObservableValue<java.math.BigDecimal> priceProperty)	Registers a checkbox/price pair for validation.
javafx.scene.layout.GridPane	buildView()	Builds the full tab view including the items grid, separator, and total label.
protected void	clearAll()	Clears all checkbox selections, clears all text fields, and refreshes the total.
protected abstract java.util.List<T>	getItems()	Returns the list of line items to display in this tab.
javafx.beans.binding.BooleanBinding	hasInvalidSelections()	Returns a binding that is true when any checked item is missing a required price.
protected void	onClearButtonSet()	Called when the clear button is injected.
protected void	refreshTotal()	Refreshes the total label using the configured totalSupplier.
void	reset()	Resets the tab by clearing all selections.
void	setTotalSupplier(java.util.function.Supplier<java.math.BigDecimal> totalSupplier)	Sets the supplier used to calculate the tab total.

Methods inherited from class com.palmer.billingstatementgenerator.views.controllers.BaseController

bindIntegerTextField, buildCheckBox, buildPriceField, buildPriceLabel, buildTextField, configTextFieldForInts, configureClearButton, onHide, onNextButtonSet, onShow, setClearButton, setNextButton, wireTextFieldToCheckBox

Methods inherited from class java.lang.Object

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

Field Detail

itemsGrid

protected javafx.scene.layout.GridPane itemsGrid

The grid pane containing the line item rows.

Constructor Detail

GridTabController

public GridTabController()

Method Detail

buildView

public javafx.scene.layout.GridPane buildView()

Builds the full tab view including the items grid, separator, and total label.

Returns:

a GridPane wrapper containing the complete tab content

onClearButtonSet

protected void onClearButtonSet()

Called when the clear button is injected. Wires the button to the current checkboxes if the grid has already been built.

Overrides:

onClearButtonSet in class BaseController

clearAll

protected void clearAll()

Clears all checkbox selections, clears all text fields, and refreshes the total.

Overrides:

clearAll in class BaseController

reset

public void reset()

Resets the tab by clearing all selections. Delegates to clearAll().

Overrides:

reset in class BaseController

setTotalSupplier

public void setTotalSupplier(java.util.function.Supplier<java.math.BigDecimal> totalSupplier)

Sets the supplier used to calculate the tab total. The supplier is called whenever the total label needs to be refreshed.

Parameters:

totalSupplier - a Supplier returning the current tab total

refreshTotal

protected void refreshTotal()

Refreshes the total label using the configured totalSupplier. Does nothing if either the supplier or the label has not been initialized.

Overrides:

refreshTotal in class BaseController

addValidationPair

protected void addValidationPair(javafx.scene.control.CheckBox cb,
                                 javafx.beans.value.ObservableValue<java.math.BigDecimal> priceProperty)

Registers a checkbox/price pair for validation. The nav buttons are disabled while the checkbox is selected but the price is null or zero.

Parameters:

cb - the checkbox to observe

priceProperty - the price property that must be greater than zero when checked

hasInvalidSelections

public javafx.beans.binding.BooleanBinding hasInvalidSelections()

Returns a binding that is true when any checked item is missing a required price.

Overrides:

hasInvalidSelections in class BaseController

Returns:

a BooleanBinding indicating whether any checked item is missing a required price

getItems

protected abstract java.util.List<T> getItems()

Returns the list of line items to display in this tab.

Returns:

the list of items of type T

addItemRow

protected abstract javafx.scene.control.CheckBox addItemRow(T item,
                                                            int row)

Builds and adds a single row to the items grid for the given line item.

Parameters:

item - the line item to render

row - the grid row index

Returns:

the CheckBox created for this row