Interface IPluginCustomGUI
-
- All Superinterfaces:
IFCPlugin
,INamedUiElement
,INameProviding
,IPluginGenericCustomGUI<IPluginCustomGUIBean>
,IPluginProcessing
,ITransferable
,Serializable
@Deprecated public interface IPluginCustomGUI extends IPluginProcessing, IPluginGenericCustomGUI<IPluginCustomGUIBean>
Deprecated.Use the new workflow engine, e.g.IPluginWorkflowNode
.Interface for a processing plugin with a custom user interface.- Author:
- XIMA MEDIA GmbH
-
-
Field Summary
-
Fields inherited from interface de.xima.fc.plugin.interfaces.IFCPlugin
CONFIG_FILENAME
-
Fields inherited from interface de.xima.fc.interfaces.INamedUiElement
ATTR_DISPLAY_NAME
-
Fields inherited from interface de.xima.fc.entities.interfaces.INameProviding
ATTR_NAME, COL_NAME
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods Modifier and Type Method Description String
getConfigPage()
Deprecated.UsegetXhtmlView()
Class<? extends IPluginCustomGUIBean>
getManagedBean()
Deprecated.UsegetUnmanagedBeans()
, the bean will not be managed, ie.default Iterable<Class<? extends IPluginCustomGUIBean>>
getUnmanagedBeans()
Deprecated.This must return a list of backing bean classes that control the user interface and are required by theXHTML Facelet view
.default URL
getXhtmlView()
Deprecated.This method must return the path to the XHTML page for the custom user interface.default void
initCustomGUI()
Deprecated.If you need to do initialization, do so in the managed bean viaIPluginGenericCustomGUIBean.initialize(de.xima.fc.interfaces.plugin.lifecycle.IPluginInitializeBeanData)
.-
Methods inherited from interface de.xima.fc.plugin.interfaces.IFCPlugin
getDescription, getDescription, getDisplayName, getName, initialize, initPlugin, install, shutdown, shutdown, uninstall, validateConfigurationData
-
Methods inherited from interface de.xima.fc.plugin.interfaces.workflow.IPluginProcessing
execute, isReplacePlaceholders
-
-
-
-
Method Detail
-
getXhtmlView
default URL getXhtmlView()
Deprecated.Description copied from interface:IPluginGenericCustomGUI
This method must return the path to the XHTML page for the custom user interface. Usually the XHTML file is part of the classpath resources of the plugin. In this case, simply return an URL to resource (jar:file:/...
) like so:@Override public URL getXhtmlView() { return getClass().getResource("/path/to/view.xhtml"); }
- Specified by:
getXhtmlView
in interfaceIPluginGenericCustomGUI<IPluginCustomGUIBean>
- Returns:
- Path to the Facelet view. Must not return
null
. May returnnull
to indicate that no custom view is available. Whether a custom view is required depends on the type of the plugin.
-
getUnmanagedBeans
default Iterable<Class<? extends IPluginCustomGUIBean>> getUnmanagedBeans()
Deprecated.Description copied from interface:IPluginGenericCustomGUI
This must return a list of backing bean classes that control the user interface and are required by theXHTML Facelet view
. A new instance of the bean will be created automatically when the view is opened. Make sure each bean has got a no-argument constructor or instantiation will fail.Each 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, with the first character changed to lower case.Also, each bean needs to be annotated one of the following scopes:
@RequestScoped
,@ViewScoped
,@SessionScoped
, or@ApplicationScoped
. Note that it depends on the type of plugin which scopes are actually supported (most plugins expect@ViewScoped
beans). In case you do not specify a scope, an appropriate scope will be determined automatically.Please note that the beans are fundamentally unmanaged - functionality specific to managed CDI beans may not be supported, depending on the type of plugin. Certain features of CDI managed beans may be supported partially, depending on the type of plugin, but may work slightly differently. This includes, but is not limited to:
- The exact timing at which
PostConstruct
andPreDestroy
are called may differ. - A field marked with
Inject
may not work with all values allowed by the CDI specification, and may not perform certain validation passes such as the check for circular dependencies. Also, no new bean instances will be created when those beans have not yet been created as part of the current page.
- Specified by:
getUnmanagedBeans
in interfaceIPluginGenericCustomGUI<IPluginCustomGUIBean>
- Returns:
- A list of unmanaged bean classes required by the Facelet page.
- The exact timing at which
-
getManagedBean
@Deprecated Class<? extends IPluginCustomGUIBean> getManagedBean()
Deprecated.UsegetUnmanagedBeans()
, the bean will not be managed, ie. annotations such asPostConstruct
andManagedProperty
will not work.
-
initCustomGUI
@Deprecated default void initCustomGUI() throws FCPluginException
Deprecated.If you need to do initialization, do so in the managed bean viaIPluginGenericCustomGUIBean.initialize(de.xima.fc.interfaces.plugin.lifecycle.IPluginInitializeBeanData)
.- Throws:
FCPluginException
-
getConfigPage
@Deprecated String getConfigPage()
Deprecated.UsegetXhtmlView()
-
-