Package de.xima.fc.plugin.gui
Interface IPluginGenericCustomGUIBean
-
- All Superinterfaces:
Serializable
- All Known Subinterfaces:
INodePropertyPluginBean<TData>,IPluginAuthenticatorCustomGUIBean,IPluginClientDashboardCustomGUIBean,IPluginCustomGUIBean,IPluginProjectMenuGUIBean,IPluginPromptConnectionBean,IPluginPromptQueryBean,IPluginWorkflowNodeBean,IPluginWorkflowTriggerBean,ITriggerPropertyPluginBean<TData>
- All Known Implementing Classes:
APluginClientDashboardCustomGUIBean,APluginCustomGUIBean,APluginGenericCustomGUIBean
public interface IPluginGenericCustomGUIBean extends Serializable
Interface for a managed bean required by a plugin that provides a custom user interface.This bean should be annotated with
Named. If this annotation is not present or no name is specified, the name defaults to the simple name of the bean class.Also, the bean needs to be annotated with one of the following scopes:
RequestScoped,ViewScoped,SessionScopedorApplicationScoped. Note that it depends on the type of plugin which scopes are actually supported. In case you do not specify a scope, an appropriate scope will be determined automatically.Please note that this bean is unmanaged - certain features of CDI managed beans might not be supported may be; or supported only partially and may behave differently. This includes, but is not limited to:
- The exact timing at which
PostConstructandPreDestroyare called may differ. - A field marked with
Injectmay not work with all values allowed by the CDI bean specification, and may not perform checks such as the check for circular dependencies. It will also not create new beans when those beans have not been created yet as part of the current page.
PostConstruct, you can useinitialize(IPluginInitializeBeanData). Instead ofPreDestroy, you can usedestroy().- Author:
- XIMA MEDIA GmbH
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description default voiddestroy()A callback method that is called when this bean is not needed anymore.IPluginFileHelpergetFileHelper()Lets you access the file helper of the plugin that provided this UI.PropertiesgetProperties()Lets you access the properties of the plugin that provided this UI.IPluginResourceHelpergetResourceHelper()Lets you access the resource helper of the plugin that provided this UI.default voidinitialize(IPluginInitializeBeanData initializeBeanData)A callback method that is invoked after all beans required by theIPluginGenericCustomGUIplugin were created.
-
-
-
Method Detail
-
destroy
default void destroy()
A callback method that is called when this bean is not needed anymore. When exactly this and whether this is called may depend on the type of plugin. Usually, this should be called when the bean is about to be destroyed. This can be used to perform any required cleanup.
-
getFileHelper
IPluginFileHelper getFileHelper()
Lets you access the file helper of the plugin that provided this UI.- Returns:
IPluginFileHelperThe helper class for working with the plugin files
-
getProperties
Properties getProperties()
Lets you access the properties of the plugin that provided this UI.- Returns:
PropertiesThe properties of the plugin.
-
getResourceHelper
IPluginResourceHelper getResourceHelper()
Lets you access the resource helper of the plugin that provided this UI.- Returns:
IPluginResourceHelperThe helper class for working with resources
-
initialize
default void initialize(IPluginInitializeBeanData initializeBeanData) throws FCPluginException
A callback method that is invoked after all beans required by theIPluginGenericCustomGUIplugin were created. You can use this method to get access to the plugin configuration data. If you need to perform any initialization logic, do it in this method.- Parameters:
initializeBeanData- TheIPluginInitializeBeanDatayou can make use of in the initialization process.- Throws:
FCPluginException- When the bean could not be initialized. If you do throw the exception, an error will be shown to the user. Depending on the type of custom UI, the user may instead see an error page, a default page or be redirected to another page.
-
-