de.ipcon.gui

Class ClientPluginHelper

java.lang.Object

de.ipcon.gui.AbstractClientHelper

de.ipcon.gui.ClientPluginHelper

All Implemented Interfaces:

L10nLocaleChangeListenerI, PreloadL10nCacheFinishedListenerI

public class ClientPluginHelper
extends AbstractClientHelper
implements PreloadL10nCacheFinishedListenerI, L10nLocaleChangeListenerI

Coordinates client plugin discovery, reflective instantiation, lifecycle events, and action bindings.

Manages the active collection of ClientPluginI instances, propagates runtime events (such as locale mutations and preload completions), drives plugin-specific action re-registrations on the EDT, and collects shutdown vetoes during client termination.

Constructor Summary

Constructors

Constructor and Description
ClientPluginHelper(Client _client) Constructs a new plugin helper bound to client context, user profile settings, and dialog services.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getClientCloseVetos() Queries all active plugins for reasons to prevent closing the client application.
java.util.List<ClientPluginI>	getPlugins() Returns an unmodifiable view of all currently registered client plugins.
void	initPluginActionsOnEDT() Triggers action re-registration on the EDT across all active plugins.
void	processLocaleChanged(java.util.Locale oldLocale, java.util.Locale newLocale) Propagates a locale change notification across all active plugins.
void	processPreloadFinished(java.util.Locale lc) Notifies all active plugins that client resource preloading has completed for a given locale.
void	refreshPluginActions(boolean sync) Refreshes action enablement and state across all plugins on the EDT.
void	tryCleanupBeforeClose() Executes pre-shutdown cleanup routines across all active plugins before client termination.

Methods inherited from class de.ipcon.gui.AbstractClientHelper

client

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientPluginHelper

public ClientPluginHelper(Client _client)

Constructs a new plugin helper bound to client context, user profile settings, and dialog services.

Parameters:

_ctx - client runtime context

Method Detail

getPlugins

public java.util.List<ClientPluginI> getPlugins()

Returns an unmodifiable view of all currently registered client plugins.

Returns:

read-only list of active ClientPluginI instances

processLocaleChanged

public void processLocaleChanged(java.util.Locale oldLocale,
                                 java.util.Locale newLocale)

Propagates a locale change notification across all active plugins.

Specified by:

processLocaleChanged in interface L10nLocaleChangeListenerI

Parameters:

oldLocale - previous client locale

newLocale - newly activated client locale

processPreloadFinished

public void processPreloadFinished(java.util.Locale lc)

Notifies all active plugins that client resource preloading has completed for a given locale.

Specified by:

processPreloadFinished in interface PreloadL10nCacheFinishedListenerI

Parameters:

lc - locale for which preloading has finished

initPluginActionsOnEDT

public void initPluginActionsOnEDT()

Triggers action re-registration on the EDT across all active plugins.

refreshPluginActions

public void refreshPluginActions(boolean sync)

Refreshes action enablement and state across all plugins on the EDT.

Parameters:

sync - true to wait synchronously for EDT execution; false to schedule asynchronously

tryCleanupBeforeClose

public void tryCleanupBeforeClose()

Executes pre-shutdown cleanup routines across all active plugins before client termination.

getClientCloseVetos

public java.lang.String getClientCloseVetos()

Queries all active plugins for reasons to prevent closing the client application.

Returns:

concatenated veto message explaining why closing must be aborted, or null if no veto exists