org.jminor.javafx.framework.ui

Class EntityApplicationView<M extends EntityApplicationModel>

java.lang.Object

javafx.application.Application

org.jminor.javafx.framework.ui.EntityApplicationView<M>

Type Parameters:

M - the type of EntityApplicationModel used by this application view

All Implemented Interfaces:

ViewTreeNode<EntityView>

public abstract class EntityApplicationView<M extends EntityApplicationModel>
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(java.lang.String applicationTitle) Instantiates a new EntityApplicationView instance.
EntityApplicationView(java.lang.String applicationTitle, java.lang.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 javafx.scene.control.MenuBar	createMainMenu()
protected java.lang.String	getApplicationIdentifier()
protected User	getApplicationUser() Displays a login panel in case authentication is required, otherwise returns the default user.
java.util.List<EntityView>	getChildViews()
protected User	getDefaultUser()
M	getModel()
EntityView	getNextSiblingView()
ViewTreeNode<EntityView>	getParentView()
EntityView	getPreviousSiblingView()
protected abstract M	initializeApplicationModel(EntityConnectionProvider connectionProvider) Initializes the application model
protected javafx.scene.Scene	initializeApplicationScene(javafx.stage.Stage primaryStage) Creates the application scene from the available EntityViews.
protected EntityConnectionProvider	initializeConnectionProvider(User user, java.lang.String clientTypeId) Initializes the connection provider to use in this application
protected abstract void	initializeEntityViews() Initialized all entity views and adds them via addEntityView(EntityView)
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(java.lang.String applicationTitle)

Instantiates a new EntityApplicationView instance.

Parameters:

applicationTitle - the title to display in the view header

EntityApplicationView

public EntityApplicationView(java.lang.String applicationTitle,
                             java.lang.String iconFileName)

Instantiates a new EntityApplicationView instance.

Parameters:

applicationTitle - the title to display in the view header

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

Method Detail

getModel

public final M getModel()

Returns:

the application model

addEntityView

public final void addEntityView(EntityView entityView)

Adds a EntityView to this application

Parameters:

entityView - the EntityView to add

getParentView

public final ViewTreeNode<EntityView> getParentView()

Specified by:

getParentView in interface ViewTreeNode<EntityView>

Returns:

null, since EntityApplicationView does not have a parent view

getPreviousSiblingView

public final EntityView getPreviousSiblingView()

Specified by:

getPreviousSiblingView in interface ViewTreeNode<EntityView>

Returns:

null, since EntityApplicationView does not have a previous sibling view

getNextSiblingView

public final EntityView getNextSiblingView()

Specified by:

getNextSiblingView in interface ViewTreeNode<EntityView>

Returns:

null, since EntityApplicationView does not have a next sibling view

getChildViews

public final java.util.List<EntityView> getChildViews()

Specified by:

getChildViews 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,
                                                                java.lang.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

getDefaultUser

protected User getDefaultUser()

Returns:

the default user when logging into this application

getApplicationIdentifier

protected java.lang.String getApplicationIdentifier()

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

getApplicationUser

protected final User getApplicationUser()

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, getDefaultUser()

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()

initializeEntityViews

protected abstract void initializeEntityViews()

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

initializeApplicationScene

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

Creates the application scene from the available EntityViews.

Parameters:

primaryStage - the primary stage

Returns:

the application scene

initializeApplicationModel

protected abstract M initializeApplicationModel(EntityConnectionProvider connectionProvider)

Initializes the application model

Parameters:

connectionProvider - the connection provider

Returns:

the application model