Package com.atlassian.confluence.plugin.module

Class PluginModuleHolder<T>

  • public class PluginModuleHolder<T>
extends Object
    Manages the lifecycle of a plugin module of type T that is constructed when the module is first requested via getModule() method. However if module type is StateAware module is created and enabled once enabled() is called.

    This class does not have any synchronisation or thread-safety guarantees. It relies on the plugin manager initialising and enabling plugin modules in single-threaded mode to ensure thread safety.

    • Method Detail

      • getInstanceWithDefaultFactory

        public static <T> PluginModuleHolder<T> getInstanceWithDefaultFactory​(com.atlassian.plugin.ModuleDescriptor<? extends T> moduleDescriptor)
        Creates a PluginModuleHolder for the given module descriptor with the default factory.
        See Also:
        DefaultPluginModuleFactory

      • getInstance

        public static <T> PluginModuleHolder<T> getInstance​(PluginModuleFactory<? extends T> pluginModuleFactory)
        Creates a PluginModuleHolder with a custom module factory.

      • enabled

        public void enabled​(Class<T> moduleClass)
        Changes the state of the module to enabled. If module class is StateAware the module instance will be created if it does not exist yet and then enabled() method on the instance will be called. However if it is not StateAware module, its instance will not be created and creation will be deferred until the first time it is used!
        Parameters:
        moduleClass - a type of the module that this holder holds. We cannot use the type parameter of this class because of java implementation of generics(erasure).
        Throws:
        ClassCastException - if passed moduleClass is StateAware but the module type is not.

      • disabled

        public void disabled()

      • isEnabled

        public boolean isEnabled()