net.bbmsoft.iocfx

Interface Standalone.Application

All Superinterfaces:

Standalone

Enclosing interface:

Standalone

@ConsumerType
public static interface Standalone.Application
extends Standalone

Interface for components that represent an application main window and bring their own UI layout. The root region provided by this component will automatically be put into a stage and shown.

Before the Stage is shown, it will be passed into the Standalone.prepareStage(Stage) method, giving developers the opportunity to customize the stage, e.g. to initialize a stage style. By default, prepareStage() does nothing.

Additionally, an Application component can provide a customized StageService.ExitPolicy by overriding the Standalone.getExitPolicy() method. The default is StageService.ExitPolicy.SHUTDOWN_ON_STAGE_EXIT.

Author:

Michael Bachmann

Nested Class Summary

Nested classes/interfaces inherited from interface net.bbmsoft.iocfx.Standalone

Standalone.Application

Method Summary

Modifier and Type	Method and Description
default javafx.scene.layout.Region	getRootNode() Provide this application's root layout node.

Methods inherited from interface net.bbmsoft.iocfx.Standalone

getExitPolicy, prepareStage

Method Detail

getRootNode

default javafx.scene.layout.Region getRootNode()

Provide this application's root layout node. This will be put in a stage and shown. This method will always be called on the JavaFX Application Thread.

By convention, classes implementing Standalone.Application should be derived from Region, in which case this method will by default simply return the Application instance. If the Application class is not derived from Region, this class must be overridden to return the correct root node.

Currently, IoCFX will call this method only once per instance, however this may change in future versions, so it is advised to make sure that this method does not create a new layout every time it is called.

Returns:

the application layout's root node

Throws:

IllegalStateException - if the implementing class is not a Region