com.atlassian.bamboo.plugin.descriptor

Class AbstractBambooModuleDescriptor<T>

java.lang.Object

com.atlassian.plugin.descriptors.AbstractModuleDescriptor<T>

com.atlassian.bamboo.plugin.descriptor.AbstractBambooModuleDescriptor<T>

All Implemented Interfaces:

com.atlassian.plugin.ModuleDescriptor<T>, com.atlassian.plugin.Resourced, com.atlassian.plugin.ScopeAware, com.atlassian.plugin.StateAware

Direct Known Subclasses:

AbstractBambooConfigurableModuleDescriptor, AbstractCustomIndexModuleDescriptor, ArtifactHandlerModuleDescriptorImpl, BambooEventListenerModuleDescriptor, BuildAgentRequirementFilterDescriptor, BuildDefinitionTransformerModuleDescriptor, BuildTriggerConditionModuleDescriptorImpl, CapabilityConfiguratorModuleDescriptor, CapabilityDefaultsHelperModuleDescriptor, CapabilityTypeModuleDescriptor, CredentialTypeModuleDescriptorImpl, CustomBuildCompleteActionModuleDescriptor, CustomBuildProcessorModuleDescriptor, CustomBuildProcessorServerModuleDescriptor, CustomEnvironmentConfigPluginModuleDescriptorImpl, CustomPostBuildCompletedActionModuleDescriptor, CustomPreBuildActionModuleDescriptor, CustomPreBuildQueuedActionModuleDescriptor, CustomPreDeploymentActionModuleDescriptorImpl, DecoratorMapperModuleDescriptor, DecoratorModuleDescriptor, FooterModuleDescriptor, NoOpModuleDescriptor, NotificationRecipientModuleDescriptor, NotificationTypeModuleDescriptor, PlanDeletionInterceptorActionModuleDescriptor, PlanTriggerModuleDescriptor, PostChainActionModuleDescriptor, PostJobActionModuleDescriptor, PostStageActionModuleDescriptor, PreChainActionModuleDescriptor, PreDeploymentQueuedActionModuleDescriptor, PreJobActionModuleDescriptor, PrePostTaskActionsDescriptor, PreRssExecutionActionModuleDescriptor, PreStageActionModuleDescriptor, QuickFilterRuleTypeModuleDescriptor, ReportCollectorModuleDescriptor, Repository2VcsTypeConverterModuleDescriptor, RepositoryModuleDescriptorImpl, RestartFailedStageActionModuleDescriptor, ResumeManualActionModuleDescriptor, SerializableClassWhitelistProviderModuleDescriptor, SpringComponentModuleDescriptor, StopOnManualActionModuleDescriptor, TaskConditionModuleDescriptorImpl, TaskModuleDescriptorImpl, TaskProcessCommandDecoratorModuleDescriptorImpl, TopNavigationModuleDescriptor, TriggerModuleDescriptorImpl, TriggerReasonModuleDescriptor, UserRenameHandlerModuleDescriptor, VcsRepositoryModuleDescriptorImpl, VcsRepositoryViewerModuleDescriptorImpl, Web2VcsRepositoryViewerConverterModuleDescriptor, WebRepositoryViewerModuleDescriptorImpl, XWorkModuleDescriptor

public abstract class AbstractBambooModuleDescriptor<T>
extends com.atlassian.plugin.descriptors.AbstractModuleDescriptor<T>

Field Summary

Fields inherited from class com.atlassian.plugin.descriptors.AbstractModuleDescriptor

key, moduleClass, moduleClassName, moduleFactory, name, plugin, resources

Constructor Summary

Constructors

Constructor and Description
AbstractBambooModuleDescriptor() Deprecated. since 5.4 use the constructor which requires a ModuleFactory
AbstractBambooModuleDescriptor(com.atlassian.plugin.module.ModuleFactory moduleFactory)

Method Summary

Modifier and Type	Method and Description
void	disabled()
protected String	getElementAsString(org.dom4j.Element element)
protected String	getFreeMarkerResourceLocation(String resourceName)
T	getModule()
protected String	getVelocityResourceLocation(String resourceName)
protected <Z> Z	instantiateClass(Class<Z> clazz)
protected <Z> Z	instantiateSubmodule(String submoduleName, String submoduleClassName, Class<Z> defaultSubmoduleClass)
protected boolean	isMutable() Whether modules of this descriptor are supposed to be mutated by external components.
protected void	postInit(T module) Called during module initialization after InitablePluginModule.init(com.atlassian.plugin.ModuleDescriptor) is called on module.
protected void	preInit(T module) Called during module initialization before InitablePluginModule.init(com.atlassian.plugin.ModuleDescriptor) is called on module.

Methods inherited from class com.atlassian.plugin.descriptors.AbstractModuleDescriptor

assertModuleClassImplements, checkPermissions, destroy, enabled, equals, getCompleteKey, getDescription, getDescriptionKey, getI18nNameKey, getKey, getMinJavaVersion, getModuleClass, getModuleClassName, getName, getParams, getPlugin, getPluginKey, getRequiredPermissions, getResourceDescriptor, getResourceDescriptors, getResourceLocation, getScopeKey, hashCode, init, isBroken, isEnabled, isEnabledByDefault, isSystemModule, loadClass, provideValidationRules, satisfiesMinJavaVersion, setBroken, setPlugin, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.atlassian.plugin.ModuleDescriptor

getDisplayName

Constructor Detail

AbstractBambooModuleDescriptor

public AbstractBambooModuleDescriptor(com.atlassian.plugin.module.ModuleFactory moduleFactory)

AbstractBambooModuleDescriptor

@Deprecated
public AbstractBambooModuleDescriptor()

Deprecated. since 5.4 use the constructor which requires a ModuleFactory

Needed for AbstractBambooModuleDescriptors that require a default constructor.

Method Detail

preInit

protected void preInit(T module)

Called during module initialization before InitablePluginModule.init(com.atlassian.plugin.ModuleDescriptor) is called on module.

Parameters:

module - module to initialize

postInit

protected void postInit(T module)

Called during module initialization after InitablePluginModule.init(com.atlassian.plugin.ModuleDescriptor) is called on module.

Parameters:

module - module to initialize

isMutable

protected boolean isMutable()

Whether modules of this descriptor are supposed to be mutated by external components. By default this returns true, which means a fresh module instance will be created each time getModule() is called.

Subclasses that are safe to cache a singleton instance of module throughout the life span of this descriptor can override this method and return false.

Returns:

true if modules of this descriptor are mutable

getModule

@Nullable
public T getModule()

Specified by:

getModule in interface com.atlassian.plugin.ModuleDescriptor<T>

Specified by:

getModule in class com.atlassian.plugin.descriptors.AbstractModuleDescriptor<T>

disabled

public void disabled()

Specified by:

disabled in interface com.atlassian.plugin.StateAware

Overrides:

disabled in class com.atlassian.plugin.descriptors.AbstractModuleDescriptor<T>

instantiateClass

protected <Z> Z instantiateClass(Class<Z> clazz)

instantiateSubmodule

@NotNull
protected <Z> Z instantiateSubmodule(@NotNull
                                              String submoduleName,
                                              @NotNull
                                              String submoduleClassName,
                                              @Nullable
                                              Class<Z> defaultSubmoduleClass)
                                       throws ClassNotFoundException

Throws:

ClassNotFoundException

getFreeMarkerResourceLocation

@Nullable
protected String getFreeMarkerResourceLocation(@NotNull
                                                         String resourceName)

getVelocityResourceLocation

@Nullable
protected String getVelocityResourceLocation(@NotNull
                                                       String resourceName)

getElementAsString

@Nullable
protected String getElementAsString(org.dom4j.Element element)