org.mdi.app.jfx

Class AbstractJFXApplication

java.lang.Object

javafx.application.Application

org.mdi.app.jfx.AbstractJFXApplication

All Implemented Interfaces:

MDIApplication, PluginsListener

public abstract class AbstractJFXApplication
extends javafx.application.Application
implements MDIApplication, PluginsListener

An abstract JavaFX-based MDIApplication which does not provide a GUI. However, it provides the following utilities:

• A Plugin configuration framework
• A Menu Factory
• An action framework
• A Configuration / Preferences framework

Nested Class Summary

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

javafx.application.Application.Parameters

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Map<java.lang.String,AppliManifestType>	additionalPluginTypes The additional Plugins Types, optional property.
protected java.util.Map<java.lang.String,java.lang.Boolean>	allowedPluginTypes The allowed Plugins Types, optional property.
protected Configuration	conf The associated Configuration.
protected ConfigurationManager	confmanager The MDIApplication associated ConfigurationManager.
protected ErrorLogger	errorLogger The error logger.
protected java.util.List<Plugin>	plugins The list of loaded Plugins.
protected java.io.File	pluginsConfiguration The plugins definition xml file.
protected boolean	pluginsDefInFile True if the plugins definition is stored in a XML File (true by default).
protected java.io.File	pluginsDir The plugins directory.
protected PluginsManager	pluginsManager The MDIApplication associated PluginsManager.
protected java.util.Map<java.lang.String,Plugin>	pluginsMap The Map of loaded Plugins.
protected ThreadQueue	queue The MDIApplication associated ThreadQueue (managing Actions).
protected long	time

Fields inherited from class javafx.application.Application

STYLESHEET_CASPIAN, STYLESHEET_MODENA

Constructor Summary

Constructors

Constructor and Description
AbstractJFXApplication()

Method Summary

Modifier and Type	Method and Description
protected void	addAdditionalPluginType(java.lang.String key, AppliManifestType manifestType) Add an additional Plugin type.
void	addPluginDirectory(java.net.URL pluginDir) Add an URL defining a directory where to look for Plugins.
protected ThreadQueue	createThreadQueue() Create the ThreadQueue.
void	disposeApplication() Dispose of the Application, and serialize its resources if a Configuration manager has been set.
void	endAction(MDIAction action) Ends a generic action.
void	executeAction(MDIAction action, short blockingType) Execute a generic Action.
void	executeAction(MDIAction action, short blockingType, java.lang.ClassLoader loader) Execute a generic Action, using a specific Classloader.
java.util.Map<java.lang.String,AppliManifestType>	getAdditionalPluginTypes() Return the optional additional Plugin Types.
java.util.Map<java.lang.String,java.lang.Boolean>	getAllowedPluginTypes() Return the allowed Plugin Types.
ConfigurationManager	getConfigurationManager() Returns the Configuration Manager.
ErrorLogger	getErrorLogger() Return the error logger.
Plugin	getPlugin(java.lang.String clazz) Return a Plugin, given its associated class path.
Plugin	getPluginForName(java.lang.String name) Return a Plugin, given its associated name.
java.util.List<Plugin>	getPlugins() Return the list of Plugins.
PluginsEDTSupport	getPluginsEDTSupport(PluginsManager manager) Return the JavaFX support class for the GUI initialization of Plugins.
PluginsManager	getPluginsManager() Returns the PluginsManager.
java.util.Map<java.lang.String,Plugin>	getPluginsMap() Return the Map of Plugins.
ThreadQueue	getThreadQueue() Return the MDIApplication ThreadQueue.
long	getTime() Return the time after the last operation.
boolean	hasPlugin(java.lang.String name) Return true if the application has a Plugin of the specified name.
boolean	hasPluginsDirectories() Return true if there is a plugins directory or directory List.
boolean	hasPluginsDirectoryList() Return true if there is a plugins directory List.
boolean	hasSinglePluginsDirectory() Return true if there is a single plugins directory.
protected void	initConfiguration() Creates the Configuration, with no root Preferences.
protected void	initConfiguration(java.util.prefs.Preferences prefRoot) Creates the Configuration, and initialize it with a root Preference.
protected void	initConfiguration(java.util.prefs.Preferences prefRoot, short mdiPluginsInitMode) Creates the Configuration, and initialize it with a root Preference.
boolean	isDefaultBlockingActions() Return true if actions are blocking by default.
protected void	loadResources() Load resources used in the Application.
void	noTimeMessages() Do nothing by default.
void	noWriteMessages() Do nothing by default.
void	pluginsActionPerformed(PluginsEvent event) Does nothing by default.
protected void	registerPlugins() Register the Plugins.
void	setAllowedPluginTypes(java.util.Map<java.lang.String,java.lang.Boolean> allowedPluginTypes) Set the allowed Plugin Types.
void	setDefaultBlockingActions(boolean isBlocking) Set if actions are blocking by default.
void	setErrorLogger(ErrorLogger errorLogger)
protected void	setPluginsConfiguration(java.io.File pluginsDir) Set the plugins directory for the application.
protected void	setPluginsConfiguration(java.io.File pluginsDir, java.lang.String pluginsConfigFileName) Set the plugins directory and configuration for the application.
protected void	setPluginsConfigurationFile(java.io.File pluginsDir, java.io.File pluginsConfiguration) Set the plugins directory and configuration for the application.
void	showActionException(java.lang.String message, java.lang.Exception e) Show the Exception stackTrace by default.
void	startTime(MDIAction action) Start to count the time for the last operation, and show the statusBar progress.
long	stopTime(MDIAction action) Return the time after the last operation and stop the progress bar if there is any.

Methods inherited from class javafx.application.Application

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.mdi.bootstrap.MDIApplication

executeAction, executeAction, getApplicationDesc, getApplicationID, getCommandLineArguments, getStartDirectory

Field Detail

conf

protected Configuration conf

The associated Configuration.

time

protected long time

plugins

protected java.util.List<Plugin> plugins

The list of loaded Plugins.

pluginsMap

protected java.util.Map<java.lang.String,Plugin> pluginsMap

The Map of loaded Plugins.

pluginsDir

protected java.io.File pluginsDir

The plugins directory.

queue

protected ThreadQueue queue

The MDIApplication associated ThreadQueue (managing Actions).

pluginsConfiguration

protected java.io.File pluginsConfiguration

The plugins definition xml file.

allowedPluginTypes

protected java.util.Map<java.lang.String,java.lang.Boolean> allowedPluginTypes

The allowed Plugins Types, optional property.

additionalPluginTypes

protected java.util.Map<java.lang.String,AppliManifestType> additionalPluginTypes

The additional Plugins Types, optional property.

pluginsDefInFile

protected boolean pluginsDefInFile

True if the plugins definition is stored in a XML File (true by default).

See Also:

pluginsConfiguration

confmanager

protected ConfigurationManager confmanager

The MDIApplication associated ConfigurationManager.

pluginsManager

protected PluginsManager pluginsManager

The MDIApplication associated PluginsManager.

errorLogger

protected ErrorLogger errorLogger

The error logger.

Constructor Detail

AbstractJFXApplication

public AbstractJFXApplication()

Method Detail

initConfiguration

protected final void initConfiguration()

Creates the Configuration, with no root Preferences.

getAllowedPluginTypes

public java.util.Map<java.lang.String,java.lang.Boolean> getAllowedPluginTypes()

Return the allowed Plugin Types. Plugins which have the PluginsManager.KEY_PLUGIN_TYPE attribute in their manifest will have to match one of the Application allowed plugin type names.

Specified by:

getAllowedPluginTypes in interface MDIApplication

Returns:

the allowed Plugin Types

getAdditionalPluginTypes

public java.util.Map<java.lang.String,AppliManifestType> getAdditionalPluginTypes()

Return the optional additional Plugin Types. Contrary to the allowed Plugin Types the manifest key for these types is up to the application. It allows to define additional constraints which will define if Plugins will be loaded.

Specified by:

getAdditionalPluginTypes in interface MDIApplication

Returns:

the optional additional Plugin Types

See Also:

PluginsManager.setAdditionalPluginTypes(java.util.Map)

addPluginDirectory

public final void addPluginDirectory(java.net.URL pluginDir)

Add an URL defining a directory where to look for Plugins.

Parameters:

pluginDir - the directory as an URL

setDefaultBlockingActions

public void setDefaultBlockingActions(boolean isBlocking)

Set if actions are blocking by default.

Specified by:

setDefaultBlockingActions in interface MDIApplication

Parameters:

isBlocking - true if actions are blocking by default

isDefaultBlockingActions

public boolean isDefaultBlockingActions()

Return true if actions are blocking by default.

Specified by:

isDefaultBlockingActions in interface MDIApplication

Returns:

true if actions are blocking by default

createThreadQueue

protected ThreadQueue createThreadQueue()

Create the ThreadQueue.

Returns:

the ThreadQueue

getThreadQueue

public final ThreadQueue getThreadQueue()

Return the MDIApplication ThreadQueue.

Returns:

the MDIApplication ThreadQueue

getPluginsEDTSupport

public PluginsEDTSupport getPluginsEDTSupport(PluginsManager manager)

Return the JavaFX support class for the GUI initialization of Plugins.

Specified by:

getPluginsEDTSupport in interface MDIApplication

Parameters:

manager - the PluginsManager

Returns:

the support class

setAllowedPluginTypes

public final void setAllowedPluginTypes(java.util.Map<java.lang.String,java.lang.Boolean> allowedPluginTypes)

Set the allowed Plugin Types. Plugins which have the PluginsManager.KEY_PLUGIN_TYPE attribute in their manifest will have to match one of the Application allowed plugin type names.

Parameters:

allowedPluginTypes - the allowed Plugin types

See Also:

PluginsManager.setAllowedPluginTypes(java.util.Map)

addAdditionalPluginType

protected void addAdditionalPluginType(java.lang.String key,
                                       AppliManifestType manifestType)

Add an additional Plugin type.

Parameters:

key - the key to look for in the Plugin Manifest

manifestType - the type of the application relative to the manifest key

See Also:

PluginsManager.setAdditionalPluginTypes(java.util.Map)

setErrorLogger

public void setErrorLogger(ErrorLogger errorLogger)

getErrorLogger

public ErrorLogger getErrorLogger()

Description copied from interface: MDIApplication

Return the error logger.

Specified by:

getErrorLogger in interface MDIApplication

Returns:

the error logger

hasPluginsDirectories

public boolean hasPluginsDirectories()

Return true if there is a plugins directory or directory List.

Returns:

true if there is a plugins directory or directory List

hasSinglePluginsDirectory

public boolean hasSinglePluginsDirectory()

Return true if there is a single plugins directory.

Returns:

true if there is a single plugins directory

hasPluginsDirectoryList

public boolean hasPluginsDirectoryList()

Return true if there is a plugins directory List.

Returns:

true if there is a plugins directory List

setPluginsConfigurationFile

protected void setPluginsConfigurationFile(java.io.File pluginsDir,
                                           java.io.File pluginsConfiguration)

Set the plugins directory and configuration for the application.

Parameters:

pluginsDir - the plugins directory

pluginsConfiguration - the XML File holding the plugins entry-point classes

setPluginsConfiguration

protected void setPluginsConfiguration(java.io.File pluginsDir,
                                       java.lang.String pluginsConfigFileName)

Set the plugins directory and configuration for the application.

Parameters:

pluginsDir - the plugins directory

pluginsConfigFileName - the name of the XML File holding the plugins entry-point classes

setPluginsConfiguration

protected void setPluginsConfiguration(java.io.File pluginsDir)

Set the plugins directory for the application.

Parameters:

pluginsDir - the plugins directory

pluginsActionPerformed

public void pluginsActionPerformed(PluginsEvent event)

Does nothing by default.

Specified by:

pluginsActionPerformed in interface PluginsListener

Parameters:

event - the PluginsEvent

initConfiguration

protected void initConfiguration(java.util.prefs.Preferences prefRoot)

Creates the Configuration, and initialize it with a root Preference. This method is fairly configurable:

• If the root preference is null, no Configuration manager will be created, and the Configuration won't be deserialized nor serialized
• If the pluginsDir is not null, the application will look for Plugins in this directory. There are two ways of asking the applicatin to load a Plugin in this directory (Plugins are distributed as jar Files in this directory):
  • If the pluginsDefInFile property is set to true, the application will look for an XML File called pluginsConfiguration, defining the Plugin classes to load
  • If the pluginsDefInFile property is set to false, the application will look for the manifest of the Jar files in this directory

Parameters:

prefRoot - the root Preference, or null if there is no Preference for this MDIApplication

See Also:

PluginsManager

initConfiguration

protected void initConfiguration(java.util.prefs.Preferences prefRoot,
                                 short mdiPluginsInitMode)

Creates the Configuration, and initialize it with a root Preference. This method is fairly configurable:

• If the root preference is null, no Configuration manager will be created, and the Configuration won't be deserialized nor serialized
• If the pluginsDir is not null, the application will look for Plugins in this directory. There are two ways of asking the applicatin to load a Plugin in this directory (Plugins are distributed as jar Files in this directory):
  • If the pluginsDefInFile property is set to true, the application will look for an XML File called pluginsConfiguration, defining the Plugin classes to load
  • If the pluginsDefInFile property is set to false, the application will look for the manifest of the Jar files in this directory

Parameters:

prefRoot - the root Preference, or null if there is no Preference for this MDIApplication

mdiPluginsInitMode - the plugins initialization mode

See Also:

PluginsManager

startTime

public void startTime(MDIAction action)

Start to count the time for the last operation, and show the statusBar progress.

Specified by:

startTime in interface MDIApplication

Parameters:

action - the action

getTime

public final long getTime()

Return the time after the last operation.

Specified by:

getTime in interface MDIApplication

Returns:

the time after the last operation

stopTime

public long stopTime(MDIAction action)

Return the time after the last operation and stop the progress bar if there is any.

Specified by:

stopTime in interface MDIApplication

Parameters:

action - the action

Returns:

the time after the last operation

executeAction

public void executeAction(MDIAction action,
                          short blockingType)

Execute a generic Action.

Blocking types

The blocking type can be:

• BlockingType.DEFAULT: use the default blocking type of the application
• BlockingType.BLOCKING: if the action should be blocking
• BlockingType.NOT_BLOCKING: if the action should not be blocking

Specified by:

executeAction in interface MDIApplication

Parameters:

action - the Action

blockingType - the enumeration specifying if the action should be blocking

executeAction

public void executeAction(MDIAction action,
                          short blockingType,
                          java.lang.ClassLoader loader)

Execute a generic Action, using a specific Classloader.

Blocking types

The blocking type can be:

• BlockingType.DEFAULT: use the default blocking type of the application
• BlockingType.BLOCKING: if the action should be blocking
• BlockingType.NOT_BLOCKING: if the action should not be blocking

Specified by:

executeAction in interface MDIApplication

Parameters:

action - the Action

blockingType - the enumeration specifying if the action should be blocking

loader - the ClassLoader to execute the action

showActionException

public void showActionException(java.lang.String message,
                                java.lang.Exception e)

Show the Exception stackTrace by default. Can be overriden.

Specified by:

showActionException in interface MDIApplication

Parameters:

message - the message

e - the Exception

registerPlugins

protected void registerPlugins()

Register the Plugins.

getConfigurationManager

public ConfigurationManager getConfigurationManager()

Returns the Configuration Manager.

Specified by:

getConfigurationManager in interface MDIApplication

Returns:

the Configuration Manager

getPluginsManager

public PluginsManager getPluginsManager()

Returns the PluginsManager.

Specified by:

getPluginsManager in interface MDIApplication

Returns:

the PluginsManager

getPlugins

public final java.util.List<Plugin> getPlugins()

Return the list of Plugins.

Specified by:

getPlugins in interface MDIApplication

Returns:

the list of Plugins

getPluginsMap

public final java.util.Map<java.lang.String,Plugin> getPluginsMap()

Return the Map of Plugins.

Specified by:

getPluginsMap in interface MDIApplication

Returns:

the Map of Plugins

hasPlugin

public boolean hasPlugin(java.lang.String name)

Return true if the application has a Plugin of the specified name.

Specified by:

hasPlugin in interface MDIApplication

Parameters:

name - the Plugin name

Returns:

true if the application has a Plugin of the specified name

getPluginForName

public final Plugin getPluginForName(java.lang.String name)

Return a Plugin, given its associated name.

Specified by:

getPluginForName in interface MDIApplication

Parameters:

name - the Plugin name

Returns:

the Plugin

getPlugin

public final Plugin getPlugin(java.lang.String clazz)

Return a Plugin, given its associated class path.

Specified by:

getPlugin in interface MDIApplication

Parameters:

clazz - the plugin class path

Returns:

the Plugin

loadResources

protected void loadResources()

Load resources used in the Application. Do nothing by default.

endAction

public void endAction(MDIAction action)

Ends a generic action.

Specified by:

endAction in interface MDIApplication

Parameters:

action - the action

disposeApplication

public void disposeApplication()

Dispose of the Application, and serialize its resources if a Configuration manager has been set.

Specified by:

disposeApplication in interface MDIApplication

noWriteMessages

public void noWriteMessages()

Do nothing by default.

Specified by:

noWriteMessages in interface MDIApplication

noTimeMessages

public void noTimeMessages()

Do nothing by default.

Specified by:

noTimeMessages in interface MDIApplication