com.inet.plugin.ServerPluginManager

public class ServerPluginManager extends Object

The ServerPluginManager is the central point in the server for the plugin framework. It detects the installed plugins and initializes them. Additionally, there are methods for registering and querying extensions.

Seit:: inetcore 1.0

Verschachtelte Klassen - Übersicht

Verschachtelte Klassen

Modifikator und Typ

Klasse

Beschreibung

static enum

ServerPluginManager.PluginLoadFailCause

Possible cause why a plugin was not loaded.

static enum

ServerPluginManager.ServerPluginManagerState

The state the plugin manager is in: whether before initialization, currently registering plugins, initialized, or resetting
Feldübersicht

Felder

Modifikator und Typ

Feld

Beschreibung

static final boolean

DEBUG

Signals if we run a debug session in an IDE like Eclipse.

static final boolean

IS_SERVLET_API

signals if the servlet API is available
Konstruktorübersicht

Konstruktoren

Modifikator

Konstruktor

Beschreibung

protected

ServerPluginManager()

Create a instance of ServerPluginManager.
Methodenübersicht

Modifikator und Typ

Methode

Beschreibung

boolean

addExtractedPlugin(@Nonnull String className)

Add an extracted plugin that can be load from system/base classloader.

protected @Nullable com.inet.plugin.ServerPluginDescription

findCoreServerPluginDescriptionWithoutLoadingForServerStart(@Nullable String coreID, @Nonnull com.inet.logging.Logger logger)

FOR INTERNAL USE ONLY Get the core server plugin description without loading for the testing framework.

<T> @Nonnull List<T>

get(@Nonnull Class<? super T> interfaceClass)

Get a new modifiable list of instances of the given extension type.

String[]

getAvailablePlugins()

Get the list of all available plugins in the plugin directory.

String

getCorePluginId()

Returns the id of the product core plugin that was provided to initialize the ServerPluginManager.

static @Nonnull String

getDiagnostic()

FOR INTERNAL USE ONLY Get additional diagnostic information for the case of fatal error:

static ServerPluginManager

getInstance()

Gets the current instance of the ServerPluginManager.

String[]

getLoadedPlugins()

Get the list of all loaded/running plugins.

<T> @Nullable T

getOptionalInstance(Class<T> interfaceClass)

Get a optional instance of a specific type.

com.inet.plugin.ServerPluginDescription

getPluginDescription(String id)

FOR INTERNAL USE ONLY Get the description of a plugin or null

com.inet.plugin.fs.ResourceFile

getPluginDir()

Get the base plugin directory.

@Nonnull List<com.inet.plugin.fs.ResourceFile>

getPluginDirs()

Get the locations from which plugins are loaded.

com.inet.plugin.fs.ResourceFile

getPluginFile(String id, String path)

Returns a ResourceFile for a file which is contained in a plugin.

@Nullable PluginFilter

getPluginFilter()

Return a plugin filter which filter the available plugins

Object

getPluginLoadError(String id)

Get the cause because a plugin was not loaded.

<T> @Nonnull T

getSingleInstance(Class<T> interfaceClass)

Get a single instance of a specific type.

<T extends NamedExtension> @Nonnull T

getSingleInstanceByName(@Nonnull Class<? super T> interfaceClass, @Nullable String instanceKey, boolean useDefault)

Get a single instance of a certain type.

@Nonnull Properties

getStartProperties()

Get the start properties.

ServerPluginManager.ServerPluginManagerState

getState()

Get the current state of the manager

File

getTempDir()

FOR INTERNAL USE ONLY Get the temp directory and clear it from old files.

Throwable

getThrowable()

Get a throwable that occur on init of the plugin manager.

@Nonnull com.inet.plugin.fs.ResourceFile

getTranslationsDir()

Get the directory where additional translations can be saved.

void

init(@Nullable com.inet.plugin.ServerPluginDescription core)

Veraltet.

void

init(@Nullable com.inet.plugin.ServerPluginDescription... plugins)

FOR INTERNAL USE ONLY Initialize the ServerPluginManager and start the live cycle of the plugins. there is no check.

void

init(@Nullable String corePluginId)

Veraltet.

boolean

isInitFinish()

If the init phase is complete.

boolean

isPluginLoaded(String id)

Check if a plugin was loaded and can used in other plugins for access to API of optional dependencies.

@Nullable com.inet.plugin.ServerPluginDescription

loadCoreServerPluginDescriptionForServerStart(@Nullable String coreID)

Get the core server plugin for recovery and process starter.

protected Map<String, com.inet.plugin.ServerPluginDescription>

loadDirectory(com.inet.plugin.fs.ResourceFile pluginsDir)

FOR INTERNAL USE ONLY Durchgang #1 : plugins erst mal initial einlesen

protected Map<String, com.inet.plugin.ServerPluginDescription>

readPluginsFromDirectory(com.inet.plugin.fs.ResourceFile[] archives)

FOR INTERNAL USE ONLY Extrahiert die Plugin-Archive und erzeugt die Plugin-Beschreibungen.

<T> void

register(Class<T> interfaceClass, T instance)

Register a instance as extension in the ServerPluginManager.

void

reset()

FOR INTERNAL USE ONLY Reset the ServerPluginManager after a server stop.

void

runIfPluginLoaded(String id, Supplier<com.inet.plugin.Executable> pluginRegisterSupplier)

Runs the plugin register supplier when the plugin with the given id is loaded
and the caller was load from the DependencyClassLoader.
This code can be used in the register phase of a plugin to ensure that code of
optional plugins is only used executed, if available.

void

setActived(Map<String,Boolean> activated)

Set the activated plugins.

void

setCorePluginId(String corePluginId)

Set the name of the core plugin id.

void

setPluginDir(com.inet.plugin.fs.ResourceFile pluginDir)

Set the relative or absolute plugin directory which is to be searched for plugins.

void

setPluginDir(String pluginDir)

Set the relative or absolute path of plugin directory which is to be searched for plugins

void

setPluginFilter(PluginFilter filter)

Set a plugin filter which filter the available plugins

void

setPluginLoadError(String id, Throwable th)

Set the cause because a plugin was not loaded.

void

uninstall(com.inet.plugin.ServerPluginDescription core, boolean isFullUninstall)

Executes uninstall tasks of available plugins.

void

waitOnInitState(int seconds)

Wait the given count that the plugin manager will receive the state init.

Von Klasse geerbte Methoden Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Felddetails
- DEBUG
  
  public static final boolean DEBUG
  
  Signals if we run a debug session in an IDE like Eclipse.
- IS_SERVLET_API
  
  public static final boolean IS_SERVLET_API
  
  signals if the servlet API is available
Konstruktordetails
- ServerPluginManager
  
  protected ServerPluginManager()
  
  Create a instance of ServerPluginManager.
  
  Seit:
  
  inetcore 1.0
Methodendetails
- getInstance
  
  public static ServerPluginManager getInstance()
  
  Gets the current instance of the ServerPluginManager. If one does not exist then it will be created.
  
  Gibt zurück:
  
  Singleton instance of the manager
  
  Seit:
  
  inetcore 1.0
- reset
  
  public void reset()
  
  FOR INTERNAL USE ONLY Reset the ServerPluginManager after a server stop. All loaded plugins are reset.
  
  Seit:
  
  inetcore 1.0
- register
  
  public <T> void register(Class<T> interfaceClass, T instance)
  
  Register a instance as extension in the ServerPluginManager.
  
  Typparameter:
  
  T - a interface or a class (preferred abstract)
  
  Parameter:
  
  interfaceClass - a class of type T, can not be null
  
  instance - a instance which T implements or extends
  
  Löst aus:
  
  IllegalStateException - if the State of the ServerPluginManager is ServerPluginManager.ServerPluginManagerState.INIT
  
  IllegalArgumentException - is thrown if the interfaceClasse implements NamedExtension and there already is an extension of the same name registered
  
  Seit:
  
  inetcore 1.0
- get
  
  public <T> @Nonnull List<T> get(@Nonnull Class<? super T> interfaceClass)
  
  Get a new modifiable list of instances of the given extension type. The extensions need to be registered before with register(Class, Object)
  
  Typparameter:
  
  T - a interface or a class (preferred abstract)
  
  Parameter:
  
  interfaceClass - a class of type T, can not be null
  
  Gibt zurück:
  
  a list of instances. can be empty but not null
  
  Löst aus:
  
  IllegalStateException - if the State of the ServerPluginManager is differ from ServerPluginManager.ServerPluginManagerState.INIT
  
  Seit:
  
  inetcore 1.0
- getSingleInstance
  
  public <T> @Nonnull T getSingleInstance(Class<T> interfaceClass) throws IllegalStateException
  
  Get a single instance of a specific type.
  
  Typparameter:
  
  T - a interface or a class (preferred abstract)
  
  Parameter:
  
  interfaceClass - a class of type T, can not be null
  
  Gibt zurück:
  
  a single instance of type T
  
  Löst aus:
  
  IllegalStateException - if the State of the ServerPluginManager is differ from ServerPluginManager.ServerPluginManagerState.INIT or no instance or more as one instance of the needed type is registered
  
  Seit:
  
  inetcore 1.0
- getSingleInstanceByName
  
  public <T extends NamedExtension> @Nonnull T getSingleInstanceByName(@Nonnull Class<? super T> interfaceClass, @Nullable String instanceKey, boolean useDefault) throws IllegalStateException
  
  Get a single instance of a certain type. The instance can be selected using it's extension name. If no name is set or there is no instance of such name, the default instance may be returned. The default is defined as the first instance that was registered for the a type.
  
  Typparameter:
  
  T - a interface or a class (preferably abstract)
  
  Parameter:
  
  interfaceClass - a class of type T, can not be null
  
  instanceKey - the name of the instance to be selected, if null the default (aka. first instance) will be returned
  
  useDefault - if true a fall back to the default instance is allowed, in case of false the user requires a certain instance. If no such instance is registered a IllegalStateException will be thrown
  
  Gibt zurück:
  
  a single instance of type T
  
  Löst aus:
  
  IllegalStateException - if the State of the ServerPluginManager is not ServerPluginManager.ServerPluginManagerState.INIT or if the requested instance/default could not be found
  
  Seit:
  
  inetcore 3.0
- getOptionalInstance
  
  public <T> @Nullable T getOptionalInstance(Class<T> interfaceClass) throws IllegalStateException
  
  Get a optional instance of a specific type.
  
  Typparameter:
  
  T - a interface or a class (preferred abstract)
  
  Parameter:
  
  interfaceClass - a class of type T, can not be null
  
  Gibt zurück:
  
  a optional instance of type T or null
  
  Löst aus:
  
  IllegalStateException - if the state of ServerPluginManager is not either ServerPluginManager.ServerPluginManagerState.INIT or ServerPluginManager.ServerPluginManagerState.RESET or more than one instance of the needed type is registered
  
  Seit:
  
  inetcore 2.0
- addExtractedPlugin
  public boolean addExtractedPlugin(@Nonnull String className)
  
  Add an extracted plugin that can be load from system/base classloader. It is loaded with:
  Class.forName( className );
  The plugin must have an PluginInfo annotation as replacement for the plugin.properties. This method must be called before the initialize phase of the manager. The register and and init phase of the plugin will be invoked and own extensions can be registered. This method is not thread safe.
  
  Parameter:
  
  className - the class name of the plugin
  
  Gibt zurück:
  
  true, if the plugin was added; false, if any error occurred, see the log for details
  
  Seit:
  
  23.10
- init
  
  @Deprecated public void init(@Nullable com.inet.plugin.ServerPluginDescription core)
  
  Veraltet.
  
  FOR INTERNAL USE ONLY Initialize the ServerPluginManager and start the live cycle of the plugins. there is no check.
  
  Parameter:
  
  core - description of an optional core plugin
  
  Löst aus:
  
  IllegalStateException - if the State of the ServerPluginManager is ServerPluginManager.ServerPluginManagerState.INIT
  
  Seit:
  
  inetcore 3.1
- init
  
  public void init(@Nullable com.inet.plugin.ServerPluginDescription... plugins)
  
  FOR INTERNAL USE ONLY Initialize the ServerPluginManager and start the live cycle of the plugins. there is no check.
  
  Parameter:
  
  plugins - optional descriptions of plugins, the first is used as core plugin
  
  Löst aus:
  
  IllegalStateException - if the State of the ServerPluginManager is ServerPluginManager.ServerPluginManagerState.INIT
  
  Seit:
  
  inetcore 24.4
- init
  
  @Deprecated public void init(@Nullable String corePluginId)
  
  Veraltet.
  
  FOR INTERNAL USE ONLY Initialize the ServerPluginManager and start the live cycle of the plugins. there is no check.
  
  Parameter:
  
  corePluginId - the ID of an optional core plugin
  
  Löst aus:
  
  IllegalStateException - if the State of the ServerPluginManager is ServerPluginManager.ServerPluginManagerState.INIT
  
  Seit:
  
  inetcore 5.1
- getCorePluginId
  
  public String getCorePluginId()
  
  Returns the id of the product core plugin that was provided to initialize the ServerPluginManager.
  
  Gibt zurück:
  
  the id of the plugin. Can be null if not core plugin was provided.
  
  Seit:
  
  inetcore 1.1
- setCorePluginId
  
  public void setCorePluginId(String corePluginId) throws IllegalStateException
  
  Set the name of the core plugin id. This can be set only once.
  
  Parameter:
  
  corePluginId - the new ID
  
  Löst aus:
  
  IllegalStateException - if the state is already init
  
  Seit:
  
  inetcore 5.1
- getTempDir
  
  public File getTempDir()
  
  FOR INTERNAL USE ONLY Get the temp directory and clear it from old files.
  
  Gibt zurück:
  
  the directory
- readPluginsFromDirectory
  
  protected Map<String, com.inet.plugin.ServerPluginDescription> readPluginsFromDirectory(com.inet.plugin.fs.ResourceFile[] archives)
  
  FOR INTERNAL USE ONLY Extrahiert die Plugin-Archive und erzeugt die Plugin-Beschreibungen.
  
  Parameter:
  
  archives - eine Liste mit den gefundenen Plugin-Archiven
  
  Gibt zurück:
  
  Map mit Plugin-ID und Plugin-Beschreibung aller gefundenen Plugins
- loadDirectory
  
  protected Map<String, com.inet.plugin.ServerPluginDescription> loadDirectory(com.inet.plugin.fs.ResourceFile pluginsDir)
  
  FOR INTERNAL USE ONLY Durchgang #1 : plugins erst mal initial einlesen
  
  Parameter:
  
  pluginsDir - Verzeichnis der Plugins
  
  Gibt zurück:
  
  eine Map mit allen gefundenen Plugins, Key ist deren ID, nie null
- getPluginFile
  
  public com.inet.plugin.fs.ResourceFile getPluginFile(String id, String path) throws IOException
  
  Returns a ResourceFile for a file which is contained in a plugin. This may cover files in the jar files of a plugin as well. Note: you can not use it for directories!
  
  Parameter:
  
  id - the ID of the plugin to get a file of
  
  path - the path into the plugin ZIP file or one of the plugin JAR files
  
  Gibt zurück:
  
  the requested file, may be null if there is no such plugin or file
  
  Löst aus:
  
  IOException - thrown if the ZIP or JAR cannot be accessed
  
  Seit:
  
  inetcore 1.0
- isPluginLoaded
  public boolean isPluginLoaded(String id)
  
  Check if a plugin was loaded and can used in other plugins for access to API of optional dependencies. Do not access to the API of an optional plugin in an IF block or inside a lambda expression. Use an extra class or anonymous class to decouple class loading. For example:
  if( spm.isPluginLoaded( "reporting" ) ) { new Runnable() { // anonymous class to decouple class loading public void run() { ... } }.run(); }
  
  Parameter:
  
  id - the plugin ID
  
  Gibt zurück:
  
  true, if the plugin is available and loaded.
  
  Seit:
  
  inetcore 1.1
- runIfPluginLoaded
  public void runIfPluginLoaded(String id, Supplier<com.inet.plugin.Executable> pluginRegisterSupplier)
  
  Runs the plugin register supplier when the plugin with the given id is loaded
  and the caller was load from the DependencyClassLoader.
  This code can be used in the register phase of a plugin to ensure that code of
  optional plugins is only used executed, if available. It ensures the decoupling
  of class loading.
  spm.runIfPluginLoaded( "reporting", () -> new Executable() { public void execute() { ... } } );
  
  Parameter:
  
  id - the plugin ID
  
  pluginRegisterSupplier - the subblier to return a PluginRegister instance, the run method will be called of.
  
  Seit:
  
  inetcore 21.10
- getPluginLoadError
  
  public Object getPluginLoadError(String id)
  
  Get the cause because a plugin was not loaded.
  
  Parameter:
  
  id - the plugin ID
  
  Gibt zurück:
  
  null, PluginLoadFailCause or a Throwbale
  
  Seit:
  
  inetcore 2.2
- setPluginLoadError
  
  public void setPluginLoadError(String id, Throwable th)
  
  Set the cause because a plugin was not loaded.
  
  Parameter:
  
  id - the plugin ID
  
  th - the cause
  
  Seit:
  
  23.4
- getLoadedPlugins
  public String[] getLoadedPlugins()
  
  Get the list of all loaded/running plugins. This method can be called in the register and init phase (and later). In the pre_init phase it will return only an empty result.
  
  Gibt zurück:
  
  a list of IDs from loaded plugins
  
  Seit:
  
  inetcore 1.0
  
  Siehe auch:
  
  isPluginLoaded(String)
- getAvailablePlugins
  
  public String[] getAvailablePlugins()
  
  Get the list of all available plugins in the plugin directory.
  
  Gibt zurück:
  
  a list of IDs from all plugins
  
  Seit:
  
  inetcore 1.0
- setPluginDir
  
  public void setPluginDir(String pluginDir)
  
  Set the relative or absolute path of plugin directory which is to be searched for plugins
  
  Parameter:
  
  pluginDir - the path of the plugin directory, can not be null.
  
  Löst aus:
  
  IllegalStateException - if the state is already init
  
  Seit:
  
  inetcore 1.0
- setPluginDir
  
  public void setPluginDir(com.inet.plugin.fs.ResourceFile pluginDir)
  
  Set the relative or absolute plugin directory which is to be searched for plugins. Can be set only once.
  
  Parameter:
  
  pluginDir - the path of the plugin directory, can not be null.
  
  Löst aus:
  
  IllegalStateException - if the state is already init
  
  Seit:
  
  inetcore 1.0
- getPluginDir
  
  public com.inet.plugin.fs.ResourceFile getPluginDir()
  
  Get the base plugin directory. If not set then it returns the "plugins" path relative to the application base.
  
  Gibt zurück:
  
  the plugin dir
  
  Seit:
  
  inetcore 5.2
- getPluginDirs
  
  public @Nonnull List<com.inet.plugin.fs.ResourceFile> getPluginDirs()
  
  Get the locations from which plugins are loaded. The list returns at minimum one element. If the core plugin is set and this is a file persistence there can be an additional directory.
  
  Gibt zurück:
  
  the directories
  
  Seit:
  
  inetcore 5.2
- getTranslationsDir
  
  public @Nonnull com.inet.plugin.fs.ResourceFile getTranslationsDir()
  
  Get the directory where additional translations can be saved.
  
  Gibt zurück:
  
  the custom translation directory
  
  Seit:
  
  inetcore 5.2
- setPluginFilter
  
  public void setPluginFilter(PluginFilter filter)
  
  Set a plugin filter which filter the available plugins
  
  Parameter:
  
  filter - the new filter
  
  Seit:
  
  inetcore 2.0
- getPluginFilter
  
  public @Nullable PluginFilter getPluginFilter()
  
  Return a plugin filter which filter the available plugins
  
  Gibt zurück:
  
  the new filter, null for no filter
  
  Seit:
  
  inetcore 21.10
- setActived
  
  public void setActived(Map<String,Boolean> activated)
  
  Set the activated plugins. All plugins not in the map use the default behavior of the plugin. This replace the settings in the configuration manager.
  
  Parameter:
  
  activated - a map of plugin id to a boolean flag
  
  Seit:
  
  inetcore 5.0
- getState
  
  public ServerPluginManager.ServerPluginManagerState getState()
  
  Get the current state of the manager
  
  Gibt zurück:
  
  the state
  
  Seit:
  
  inetcore 1.0
- isInitFinish
  
  public boolean isInitFinish()
  
  If the init phase is complete.
  
  Gibt zurück:
  
  return true
  
  Seit:
  
  20.4
- waitOnInitState
  
  public void waitOnInitState(int seconds)
  
  Wait the given count that the plugin manager will receive the state init. This can only called from asynchrony background threads.
  
  Parameter:
  
  seconds - time in seconds to wait
  
  Seit:
  
  inetcore 5.1
- getThrowable
  
  public Throwable getThrowable()
  
  Get a throwable that occur on init of the plugin manager.
  
  Gibt zurück:
  
  a throwable or null if no fatal error occur.
  
  Seit:
  
  inetcore 2.0
- getPluginDescription
  
  public com.inet.plugin.ServerPluginDescription getPluginDescription(String id)
  
  FOR INTERNAL USE ONLY Get the description of a plugin or null
  
  Parameter:
  
  id - of the plugin
  
  Gibt zurück:
  
  description of the plugin or null
  
  Seit:
  
  inetcore 1.1
- getStartProperties
  
  public @Nonnull Properties getStartProperties()
  
  Get the start properties. A plugin can vary its behavier depending on this properties.
  
  Gibt zurück:
  
  the start properties.
  
  Seit:
  
  inetcore 2.0
- uninstall
  
  public void uninstall(com.inet.plugin.ServerPluginDescription core, boolean isFullUninstall)
  
  Executes uninstall tasks of available plugins. In case of problems with loading plugin, its task execution will be skipped and process will continue.
  
  Parameter:
  
  core - description of a optional core plugin (may be null).
  
  isFullUninstall - whether a full uninstall must be performed.
  
  Löst aus:
  
  IllegalStateException - if ServerPluginManager's state is not PRE_INIT.
  
  Seit:
  
  inetcore 2.2
- findCoreServerPluginDescriptionWithoutLoadingForServerStart
  
  protected @Nullable com.inet.plugin.ServerPluginDescription findCoreServerPluginDescriptionWithoutLoadingForServerStart(@Nullable String coreID, @Nonnull com.inet.logging.Logger logger) throws Exception
  
  FOR INTERNAL USE ONLY Get the core server plugin description without loading for the testing framework.
  
  Parameter:
  
  coreID - optional/possible ID of a core plugin. This is only a hint.
  
  logger - the logger
  
  Gibt zurück:
  
  the plugin or null if not found.
  
  Löst aus:
  
  Exception - if any error occur on loading the plugin
  
  IllegalStateException - if call after init the plugin manager
  
  Seit:
  
  20.4
- loadCoreServerPluginDescriptionForServerStart
  
  public @Nullable com.inet.plugin.ServerPluginDescription loadCoreServerPluginDescriptionForServerStart(@Nullable String coreID) throws Exception
  
  Get the core server plugin for recovery and process starter. If find then this plugin is used for the launcher.
  
  Parameter:
  
  coreID - optional/possible ID of a core plugin. This is only a hint.
  
  Gibt zurück:
  
  the plugin or null if not found.
  
  Löst aus:
  
  Exception - if any error occur on loading the plugin
  
  IllegalStateException - if call after init the plugin manager
  
  Seit:
  
  20.4
- getDiagnostic
  
  public static @Nonnull String getDiagnostic()
  
  FOR INTERNAL USE ONLY Get additional diagnostic information for the case of fatal error:
  
  Gibt zurück:
  
  a string starting with newline
  
  Seit:
  
  21.4

Klasse ServerPluginManager

Verschachtelte Klassen - Übersicht

Feldübersicht

Konstruktorübersicht

Methodenübersicht

Von Klasse geerbte Methoden Object

Felddetails

DEBUG

IS_SERVLET_API

Konstruktordetails

ServerPluginManager

Methodendetails

getInstance

reset

register

get

getSingleInstance

getSingleInstanceByName

getOptionalInstance

addExtractedPlugin

init

init

init

getCorePluginId

setCorePluginId

getTempDir

readPluginsFromDirectory

loadDirectory

getPluginFile

isPluginLoaded

runIfPluginLoaded

getPluginLoadError

setPluginLoadError

getLoadedPlugins

getAvailablePlugins

setPluginDir

setPluginDir

getPluginDir

getPluginDirs

getTranslationsDir

setPluginFilter

getPluginFilter

setActived

getState

isInitFinish

waitOnInitState

getThrowable

getPluginDescription

getStartProperties

uninstall

findCoreServerPluginDescriptionWithoutLoadingForServerStart

loadCoreServerPluginDescriptionForServerStart

getDiagnostic