java.lang.Object
- org.tentackle.fx.rdc.Rdc

```
public class Rdc
extends java.lang.Object
```
Collected factory methods for FX-RDC-related stuff.
Enhances code readability.

Author:

harald

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method	Description
`static void`	`bg(java.lang.Runnable runner)`	Runs some code in another thread.
`static <V> void`	`bg(java.util.function.Supplier<V> runner, java.util.function.Consumer<V> updateUI)`	Same as `bg(Supplier, Consumer, Consumer)` but with a predefined exception consumer. The exception is shown as an error dialog.
`static <V> void`	`bg(java.util.function.Supplier<V> runner, java.util.function.Consumer<V> updateUI, java.util.function.Consumer<java.lang.RuntimeException> failedUI)`	Runs some code in another thread and optionally updates the UI. The method is provided to hide the concrete implementation and make it replaceable. Use this method whenever some lengthy operation (database I/O, for example) would otherwise block the event queue.
`static void`	`closeStageHierarchy(javafx.scene.Node node)`	Closes the stage hierarchy of given node, except the main stage.
`static <T extends org.tentackle.pdo.PersistentDomainObject<T>> PdoCrud<T>`	`createPdoCrud(T pdo, boolean editable, boolean modal)`	Creates a CRUD controller for a pdo.
`static <T extends org.tentackle.pdo.PersistentDomainObject<T>> PdoSearch<T>`	`createPdoSearch(T pdo)`	Creates a search controller for a pdo.
`static <T extends org.tentackle.pdo.PersistentDomainObject<T>> javafx.scene.control.TreeCell<T>`	`createTreeCell()`	Creates a tree cell for a pdo type.
`static <T extends org.tentackle.pdo.PersistentDomainObject<T>> void`	`displayCrudStage(T pdo, boolean editable, javafx.stage.Modality modality, javafx.stage.Window owner, java.util.function.Consumer<T> updatedPdo)`	CRUD of a PDO in a separate window.
`static <T extends org.tentackle.pdo.PersistentDomainObject<T>> void`	`displayCrudStage(T pdo, boolean editable, javafx.stage.Window owner)`	CRUD of a PDO in a non-modal separate window.
`static <T extends org.tentackle.pdo.PersistentDomainObject<T>> void`	`displayCrudStage(T pdo, javafx.collections.ObservableList<T> pdoList, boolean editable, javafx.stage.Modality modality, javafx.stage.Window owner, java.util.function.Consumer<T> updatedPdo, java.util.function.Consumer<PdoCrud<T>> configurator)`	CRUD of a PDO in a separate window.
`static <T extends org.tentackle.pdo.PersistentDomainObject<T>> void`	`displaySearchStage(T pdo, javafx.stage.Modality modality, javafx.stage.Window owner, boolean createPdoAllowed, java.util.function.Consumer<javafx.collections.ObservableList<T>> selectedItems)`	Searches for PDOs in a separate window.
`static <T extends org.tentackle.pdo.PersistentDomainObject<T>> void`	`displaySearchStage(T pdo, javafx.stage.Modality modality, javafx.stage.Window owner, boolean createPdoAllowed, java.util.function.Consumer<javafx.collections.ObservableList<T>> selectedItems, java.util.function.Consumer<PdoSearch<T>> configurator)`	Searches for PDOs in a separate window.
`static <T extends org.tentackle.pdo.PersistentDomainObject<T>> void`	`displaySearchStage(T pdo, javafx.stage.Window owner, boolean createPdoAllowed)`	Searches for PDOs in a non-modal separate window.
`static <T extends org.tentackle.pdo.PersistentDomainObject<T>> PdoCrud<T>`	`getCrud(T pdo, javafx.collections.ObservableList<T> pdoList, boolean editable, javafx.stage.Modality modality, javafx.stage.Window owner)`	Gets a CRUD for a PDO. If the PDO is already being edited the corresponding stage will be brought to front and null is returned.
`static <T extends org.tentackle.pdo.PersistentDomainObject<T>> PdoSearch<T>`	`getSearch(T pdo, javafx.stage.Modality modality, javafx.stage.Window owner)`	Gets a search controller for a PDO.
`static void`	`showSaveDiscardCancelDialog(java.util.function.Consumer<java.lang.Boolean> doIt)`	Shows a question dialog whether to save, discard or cancel editing of a PDO.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createPdoCrud

public static <T extends org.tentackle.pdo.PersistentDomainObject<T>> PdoCrud<T> createPdoCrud(T pdo,
                                                                                               boolean editable,
                                                                                               boolean modal)

Creates a CRUD controller for a pdo.

Type Parameters:: T - the pdo type
Parameters:: pdo - the pdo; editable - true if user may edit the pdo, false if to view only; modal - true if modal mode
Returns:: the crud controller

createPdoSearch
```
public static <T extends org.tentackle.pdo.PersistentDomainObject<T>> PdoSearch<T> createPdoSearch(T pdo)
```
Creates a search controller for a pdo.

Type Parameters:

T - the pdo type

Parameters:

pdo - the pdo

Returns:

the search controller

createTreeCell

public static <T extends org.tentackle.pdo.PersistentDomainObject<T>> javafx.scene.control.TreeCell<T> createTreeCell()

Creates a tree cell for a pdo type.

Type Parameters:: T - the pdo type
Returns:: the tree cell

displayCrudStage

public static <T extends org.tentackle.pdo.PersistentDomainObject<T>> void displayCrudStage(T pdo,
                                                                                            boolean editable,
                                                                                            javafx.stage.Window owner)

CRUD of a PDO in a non-modal separate window.

Type Parameters:: T - the pdo type
Parameters:: pdo - the pdo; editable - true if user may edit the pdo, false if to view only; owner - the owner, null if none

displayCrudStage

public static <T extends org.tentackle.pdo.PersistentDomainObject<T>> void displayCrudStage(T pdo,
                                                                                            boolean editable,
                                                                                            javafx.stage.Modality modality,
                                                                                            javafx.stage.Window owner,
                                                                                            java.util.function.Consumer<T> updatedPdo)

CRUD of a PDO in a separate window.

Type Parameters:: T - the pdo type
Parameters:: pdo - the pdo; editable - true if user may edit the pdo, false if to view only; modality - the modality; owner - the owner, null if none; updatedPdo - the consumer for the possibly changed pdo if modal

displayCrudStage

public static <T extends org.tentackle.pdo.PersistentDomainObject<T>> void displayCrudStage(T pdo,
                                                                                            javafx.collections.ObservableList<T> pdoList,
                                                                                            boolean editable,
                                                                                            javafx.stage.Modality modality,
                                                                                            javafx.stage.Window owner,
                                                                                            java.util.function.Consumer<T> updatedPdo,
                                                                                            java.util.function.Consumer<PdoCrud<T>> configurator)

CRUD of a PDO in a separate window.

Type Parameters:: T - the pdo type
Parameters:: pdo - the pdo; pdoList - the optional list of PDOs to navigate in the list; editable - true if user may edit the pdo, false if to view only; modality - the modality; owner - the owner, null if none; updatedPdo - the consumer for the possibly changed pdo if modal; configurator - optional crud configurator

getCrud

public static <T extends org.tentackle.pdo.PersistentDomainObject<T>> PdoCrud<T> getCrud(T pdo,
                                                                                         javafx.collections.ObservableList<T> pdoList,
                                                                                         boolean editable,
                                                                                         javafx.stage.Modality modality,
                                                                                         javafx.stage.Window owner)

Gets a CRUD for a PDO.
If the PDO is already being edited the corresponding stage will be brought to front and null is returned.

Type Parameters:: T - the pdo type
Parameters:: pdo - the pdo; pdoList - the optional list of PDOs to navigate in the list; editable - true if user may edit the pdo, false if to view only; modality - the modality; owner - the owner, null if none
Returns:: the CRUD, null if there is already a CRUD editing this PDO.

displaySearchStage

public static <T extends org.tentackle.pdo.PersistentDomainObject<T>> void displaySearchStage(T pdo,
                                                                                              javafx.stage.Window owner,
                                                                                              boolean createPdoAllowed)

Searches for PDOs in a non-modal separate window.

Type Parameters:: T - the pdo type
Parameters:: pdo - the pdo as a template; owner - the owner, null if none; createPdoAllowed - true if allow to create a new PDO from within the search dialog

displaySearchStage

public static <T extends org.tentackle.pdo.PersistentDomainObject<T>> void displaySearchStage(T pdo,
                                                                                              javafx.stage.Modality modality,
                                                                                              javafx.stage.Window owner,
                                                                                              boolean createPdoAllowed,
                                                                                              java.util.function.Consumer<javafx.collections.ObservableList<T>> selectedItems)

Searches for PDOs in a separate window.

Type Parameters:: T - the pdo type
Parameters:: pdo - the pdo as a template; modality - the modality; owner - the owner, null if none; createPdoAllowed - true if allow to create a new PDO from within the search dialog; selectedItems - the consumer for the selected PDOs if modal, null if not modal

displaySearchStage

public static <T extends org.tentackle.pdo.PersistentDomainObject<T>> void displaySearchStage(T pdo,
                                                                                              javafx.stage.Modality modality,
                                                                                              javafx.stage.Window owner,
                                                                                              boolean createPdoAllowed,
                                                                                              java.util.function.Consumer<javafx.collections.ObservableList<T>> selectedItems,
                                                                                              java.util.function.Consumer<PdoSearch<T>> configurator)

Searches for PDOs in a separate window.

Type Parameters:: T - the pdo type
Parameters:: pdo - the pdo as a template; modality - the modality; owner - the owner, null if none; createPdoAllowed - true if allow to create a new PDO from within the search dialog; selectedItems - the consumer for the selected PDOs if modal, null if not modal; configurator - the optional configurator for the PdoSearch

getSearch

public static <T extends org.tentackle.pdo.PersistentDomainObject<T>> PdoSearch<T> getSearch(T pdo,
                                                                                             javafx.stage.Modality modality,
                                                                                             javafx.stage.Window owner)

Gets a search controller for a PDO.

Type Parameters:: T - the pdo type
Parameters:: pdo - the pdo; modality - the modality; owner - the owner, null if none
Returns:: the search controller, never null

showSaveDiscardCancelDialog
```
public static void showSaveDiscardCancelDialog(java.util.function.Consumer<java.lang.Boolean> doIt)
```
Shows a question dialog whether to save, discard or cancel editing of a PDO.

Parameters:

doIt - consumer invoked with true to save, false to discard changes, null to cancel and do nothing

closeStageHierarchy
```
public static void closeStageHierarchy(javafx.scene.Node node)
```
Closes the stage hierarchy of given node, except the main stage.

Parameters:

node - the node

bg
```
public static <V> void bg(java.util.function.Supplier<V> runner,
                          java.util.function.Consumer<V> updateUI,
                          java.util.function.Consumer<java.lang.RuntimeException> failedUI)
```
Runs some code in another thread and optionally updates the UI.
The method is provided to hide the concrete implementation and make it replaceable.
Use this method whenever some lengthy operation (database I/O, for example) would otherwise block the event queue.
Example:
```
   Rdc.bg(() -> {
              on(MyPdo.class).findWhateverItTakes()...
              ...
              return "Done";
          },
          s -> Fx.info(s));
 
```
Type Parameters:

V - the type returned by the runner

Parameters:

runner - the code running in another thread in parallel to the FX thread

updateUI - optional UI updater invoked from within the FX event queue

failedUI - optional UI updater invoked if execution failed

See Also:

RdcUtilities.runInBackground(Supplier, Consumer, Consumer)

bg
```
public static <V> void bg(java.util.function.Supplier<V> runner,
                          java.util.function.Consumer<V> updateUI)
```
Same as bg(Supplier, Consumer, Consumer) but with a predefined exception consumer.
The exception is shown as an error dialog.

Type Parameters:

V - the type returned by the runner

Parameters:

runner - the code running in another thread in parallel to the FX thread

updateUI - optional UI updater invoked from within the FX event queue

bg
```
public static void bg(java.lang.Runnable runner)
```
Runs some code in another thread.

Parameters:

runner - the code running in another thread in parallel to the FX thread

See Also:

bg(Supplier, Consumer)

Class Rdc

Method Summary

Methods inherited from class java.lang.Object

Method Detail

createPdoCrud

createPdoSearch

createTreeCell

displayCrudStage

displayCrudStage

displayCrudStage

getCrud

displaySearchStage

displaySearchStage

displaySearchStage

getSearch

showSaveDiscardCancelDialog

closeStageHierarchy

bg

bg

bg