de.griefed.serverpackcreator

Class ApplicationAddons

java.lang.Object

org.pf4j.AbstractPluginManager

org.pf4j.DefaultPluginManager

org.pf4j.JarPluginManager

de.griefed.serverpackcreator.ApplicationAddons

All Implemented Interfaces:

org.pf4j.PluginManager

@Component
public final class ApplicationAddons
extends org.pf4j.JarPluginManager

Manager for ServerPackCreator plugins. In itself it doesn't do much. It gathers lists of all available extensions for TabExtension,PreGenExtension,PreZipExtension and PostGenExtension so they can then be run during server pack generation and during initialization of the GUI.

Field Summary

Fields inherited from class org.pf4j.DefaultPluginManager

PLUGINS_DIR_CONFIG_PROPERTY_NAME

Fields inherited from class org.pf4j.AbstractPluginManager

DEFAULT_PLUGINS_DIR, dependencyResolver, DEVELOPMENT_PLUGINS_DIR, exactVersionAllowed, extensionFactory, extensionFinder, MODE_PROPERTY_NAME, pluginClassLoaders, pluginDescriptorFinder, pluginFactory, pluginLoader, pluginRepository, plugins, PLUGINS_DIR_PROPERTY_NAME, pluginsRoots, pluginStateListeners, pluginStatusProvider, resolvedPlugins, runtimeMode, startedPlugins, systemVersion, unresolvedPlugins, versionManager

Constructor Summary

Constructors

Constructor and Description
ApplicationAddons(com.electronwill.nightconfig.toml.TomlParser tomlParser, ApplicationProperties injectedApplicationProperties, VersionMeta injectedVersionMeta, Utilities injectedUtilities) Initialize ServerPackCreators addons and give access to any and all available extensions.

Method Summary

Modifier and Type	Method and Description
void	addTabExtensionTabs(javax.swing.JTabbedPane tabbedPane) Add any and all additional tabs to the ServerPackCreator tabbed pane (main GUI).
java.util.List<ConfigPanelExtension>	configPanelExtensions() List of available ConfigPanelExtension-extensions.
protected org.pf4j.ExtensionFactory	createExtensionFactory()
java.util.Optional<com.electronwill.nightconfig.core.CommentedConfig>	getAddonConfig(java.lang.String addonId) Get the global addon configuration for an addon of the passed ID.
java.util.Optional<java.io.File>	getAddonConfigFile(java.lang.String addonId) Get the configuration-file for an addon, if it exists.
java.util.List<ExtensionConfigPanel>	getConfigPanels(TabCreateServerPack tabCreateServerPack) Create config panels for the passed server pack configuration tab.
java.util.List<TabExtension>	tabExtensions() List of available TabExtension-extensions.

Methods inherited from class org.pf4j.JarPluginManager

createPluginDescriptorFinder, createPluginLoader, createPluginRepository

Methods inherited from class org.pf4j.DefaultPluginManager

createExtensionFinder, createPluginFactory, createPluginStatusProvider, createVersionManager, initialize, loadPluginFromPath

Methods inherited from class org.pf4j.AbstractPluginManager

addPluginStateListener, checkPluginId, createPluginsRoot, createPluginWrapper, deletePlugin, disablePlugin, enablePlugin, firePluginStateEvent, getExtensionClasses, getExtensionClasses, getExtensionClasses, getExtensionClasses, getExtensionClassNames, getExtensionFactory, getExtensions, getExtensions, getExtensions, getExtensions, getPlugin, getPluginClassLoader, getPluginClassLoaders, getPluginDescriptorFinder, getPluginFactory, getPluginLabel, getPluginLoader, getPlugins, getPlugins, getPluginsRoot, getPluginsRoots, getResolvedPlugins, getRuntimeMode, getStartedPlugins, getSystemVersion, getUnresolvedPlugins, getVersion, getVersionManager, idForPath, isExactVersionAllowed, isPluginDisabled, isPluginValid, loadPlugin, loadPlugins, removePluginStateListener, resolvePlugins, setExactVersionAllowed, setSystemVersion, startPlugin, startPlugins, stopPlugin, stopPlugin, stopPlugins, unloadPlugin, unloadPlugin, unloadPlugins, validatePluginDescriptor, whichPlugin

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.pf4j.PluginManager

isDevelopment, isNotDevelopment

Constructor Detail

ApplicationAddons

@Autowired
public ApplicationAddons(com.electronwill.nightconfig.toml.TomlParser tomlParser,
                                    ApplicationProperties injectedApplicationProperties,
                                    VersionMeta injectedVersionMeta,
                                    Utilities injectedUtilities)

Initialize ServerPackCreators addons and give access to any and all available extensions.

Parameters:

tomlParser - To read addon-configurations, so they can be provided to extensions.

injectedApplicationProperties - ServerPackCreator settings to be provided to extensions.

injectedVersionMeta - Version meta to be provided to extensions.

injectedUtilities - Utilities to be provided to extensions.

Method Detail

createExtensionFactory

protected org.pf4j.ExtensionFactory createExtensionFactory()

Overrides:

createExtensionFactory in class org.pf4j.DefaultPluginManager

getAddonConfig

public java.util.Optional<com.electronwill.nightconfig.core.CommentedConfig> getAddonConfig(java.lang.String addonId)

Get the global addon configuration for an addon of the passed ID. The configuration is wrapped in an Optional, because an addon may not provide a global configuration. If you intend on using a global configuration for your addon, make sure to check whether it is present before trying to use it!

Parameters:

addonId - The addon ID of the...well...addon.

Returns:

The global addon configuration, wrapped in an Optional.

getAddonConfigFile

public java.util.Optional<java.io.File> getAddonConfigFile(java.lang.String addonId)

Get the configuration-file for an addon, if it exists. This is wrapped in an Optional, because not every addon may provide a configuration-file to use globally for the relevant addons settings. If you intend on using a global configuration, make sure to check whether the file is present, before moving on!

Parameters:

addonId - The addon ID with which to identify the correct config-file to return.

Returns:

The config-file corresponding to the ID of the addon, wrapped in an Optional.

addTabExtensionTabs

public void addTabExtensionTabs(javax.swing.JTabbedPane tabbedPane)

Add any and all additional tabs to the ServerPackCreator tabbed pane (main GUI). You may use this to add tabs to your own JTabbedPane, if you so desire. Could be pretty awesome to have your addons extra tabs in a separate window!

Parameters:

tabbedPane - The tabbed pane to which the additional panels should be added to as tabs.

getConfigPanels

public java.util.List<ExtensionConfigPanel> getConfigPanels(TabCreateServerPack tabCreateServerPack)

Create config panels for the passed server pack configuration tab. Note that this method does NOT add the panels to the tab, it only creates them and passes the server pack config tab object-reference to each config panel, so they, in turn, may use any available fields and methods for their own operations. A given server pack config tab needs to add the panels which are returned by this method, so a user may make their configurations accordingly.

Parameters:

tabCreateServerPack - The server pack configuration tab to which the config panels are to be added.

Returns:

A list of config panels specifically created for the passed server pack configuration-tab.

tabExtensions

public java.util.List<TabExtension> tabExtensions()

List of available TabExtension-extensions.

Returns:

List of available TabExtension-extensions.

configPanelExtensions

public java.util.List<ConfigPanelExtension> configPanelExtensions()

List of available ConfigPanelExtension-extensions.

Returns:

List of available ConfigPanelExtension-extensions.