is.codion.javafx.framework.ui

Class EntityApplicationView<M extends FXEntityApplicationModel>

java.lang.Object

javafx.application.Application

is.codion.javafx.framework.ui.EntityApplicationView<M>

Type Parameters:

M - the type of FXEntityApplicationModel used by this application view

All Implemented Interfaces:

ViewTreeNode<EntityView>

public abstract class EntityApplicationView<M extends FXEntityApplicationModel>
extends javafx.application.Application
implements ViewTreeNode<EntityView>

A root application View.

Nested Class Summary

Nested classes/interfaces inherited from class javafx.application.Application

javafx.application.Application.Parameters

Field Summary

Fields inherited from class javafx.application.Application

STYLESHEET_CASPIAN, STYLESHEET_MODENA

Constructor Summary

Constructors

Constructor and Description
EntityApplicationView(String applicationTitle) Instantiates a new EntityApplicationView instance.
EntityApplicationView(String applicationTitle, String iconFileName) Instantiates a new EntityApplicationView instance.

Method Summary

Modifier and Type	Method and Description
void	addEntityView(EntityView entityView) Adds a EntityView to this application
protected String	applicationIdentifier()
List<EntityView>	childViews()
protected abstract M	createApplicationModel(EntityConnectionProvider connectionProvider) Initializes the application model
protected javafx.scene.Scene	createApplicationScene(javafx.stage.Stage primaryStage) Creates the application scene from the available EntityViews.
protected abstract void	createEntityViews() Initialized all entity views and adds them via addEntityView(EntityView)
protected javafx.scene.control.MenuBar	createMainMenu()
protected User	defaultUser()
protected EntityConnectionProvider	initializeConnectionProvider(User user, String clientTypeId) Initializes the connection provider to use in this application
protected User	loginUser() Displays a login panel in case authentication is required, otherwise returns the default user.
M	model()
Optional<EntityView>	nextSiblingView()
Optional<ViewTreeNode<EntityView>>	parentView()
Optional<EntityView>	previousSiblingView()
protected void	savePreferences() Called on application exit, override to save user preferences on program exit, remember to call super.savePreferences() when overriding
protected User	showLoginPanel(User defaultUser) Displays a login panel
void	start(javafx.stage.Stage stage) Starts this application

Methods inherited from class javafx.application.Application

getHostServices, getParameters, getUserAgentStylesheet, init, launch, launch, notifyPreloader, setUserAgentStylesheet, stop

Methods inherited from class java.lang.Object

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

Constructor Detail

EntityApplicationView

public EntityApplicationView(String applicationTitle)

Instantiates a new EntityApplicationView instance.

Parameters:

applicationTitle - the title to display in the view header

EntityApplicationView

public EntityApplicationView(String applicationTitle,
                             String iconFileName)

Instantiates a new EntityApplicationView instance.

Parameters:

applicationTitle - the title to display in the view header

iconFileName - the name of an icon file on the classpath to display

Method Detail

model

public final M model()

Returns:

the application model

addEntityView

public final void addEntityView(EntityView entityView)

Adds a EntityView to this application

Parameters:

entityView - the EntityView to add

parentView

public final Optional<ViewTreeNode<EntityView>> parentView()

Specified by:

parentView in interface ViewTreeNode<EntityView>

Returns:

null, since EntityApplicationView does not have a parent view

previousSiblingView

public final Optional<EntityView> previousSiblingView()

Specified by:

previousSiblingView in interface ViewTreeNode<EntityView>

Returns:

null, since EntityApplicationView does not have a previous sibling view

nextSiblingView

public final Optional<EntityView> nextSiblingView()

Specified by:

nextSiblingView in interface ViewTreeNode<EntityView>

Returns:

null, since EntityApplicationView does not have a next sibling view

childViews

public final List<EntityView> childViews()

Specified by:

childViews in interface ViewTreeNode<EntityView>

Returns:

the EntityViews associated with this application

See Also:

addEntityView(EntityView)

start

public final void start(javafx.stage.Stage stage)

Starts this application

Specified by:

start in class javafx.application.Application

Parameters:

stage - the State on which to set this application

initializeConnectionProvider

protected EntityConnectionProvider initializeConnectionProvider(User user,
                                                                String clientTypeId)

Initializes the connection provider to use in this application

Parameters:

user - the user on which to base the connection

clientTypeId - a String identifying the client type

Returns:

a EntityConnectionProvider based on the given user and client type

defaultUser

protected User defaultUser()

Returns:

the default user when logging into this application

applicationIdentifier

protected String applicationIdentifier()

Returns:

a String identifying this application, the class name by default

createMainMenu

protected javafx.scene.control.MenuBar createMainMenu()

Returns:

the main menu for this application

loginUser

protected final User loginUser()

Displays a login panel in case authentication is required, otherwise returns the default user.

Returns:

the user to use when logging into this application.

See Also:

EntityApplicationModel.AUTHENTICATION_REQUIRED, defaultUser()

showLoginPanel

protected final User showLoginPanel(User defaultUser)

Displays a login panel

Parameters:

defaultUser - the default user to display

Returns:

the user retrieved from the login panel

Throws:

CancelException - in case the login action is cancelled

savePreferences

protected void savePreferences()

Called on application exit, override to save user preferences on program exit, remember to call super.savePreferences() when overriding

See Also:

EntityApplicationModel.savePreferences()

createEntityViews

protected abstract void createEntityViews()

Initialized all entity views and adds them via addEntityView(EntityView)

createApplicationScene

protected javafx.scene.Scene createApplicationScene(javafx.stage.Stage primaryStage)

Creates the application scene from the available EntityViews.

Parameters:

primaryStage - the primary stage

Returns:

the application scene

createApplicationModel

protected abstract M createApplicationModel(EntityConnectionProvider connectionProvider)

Initializes the application model

Parameters:

connectionProvider - the connection provider

Returns:

the application model