Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
com.atlassian.plugin.Plugin.EnabledMetricsSource since 4.0.0, to be removed in 5.0.0: Methods in this interface are now provided directly by Plugin.
com.atlassian.plugin.Plugin.Resolvable since 4.0.0, to be removed in 5.0.0: Methods in this interface are now provided directly by Plugin.
com.atlassian.plugin.PluginArtifact.AllowsReference since 4.0.0, to be removed in 5.0.0: Equivalent functionality is now provided directly by PluginArtifact.getReferenceMode().

Deprecated Classes

Class and Description
com.atlassian.plugin.event.events.BeforePluginDisabledEvent since 4.0.0. Use PluginDisablingEvent instead.
com.atlassian.plugin.event.events.BeforePluginModuleDisabledEvent since 4.0.0. Use PluginModuleDisablingEvent instead.

Deprecated Fields

Field and Description
com.atlassian.plugin.Plugin.NAME_COMPARATOR since 2.2.0. This comparator only takes into account the plugin name and assumes it is not null, yet a) that constraint is not validated anywhere in plugin loading and b) the plugin could have used the i18n name, and only the application can resolve that to a name useful for comparisons.

Deprecated Methods

Method and Description
com.atlassian.plugin.Plugin.close() Since 2.2.0, use Plugin.uninstall() instead
com.atlassian.plugin.factories.PluginFactory.create(DeploymentUnit, ModuleDescriptorFactory) Since 2.2.0, use PluginFactory.create(PluginArtifact, ModuleDescriptorFactory) instead
com.atlassian.plugin.ModuleDescriptor.destroy(Plugin) The plugin parameter is redundant. Override ModuleDescriptor.destroy().
com.atlassian.plugin.PluginController.enablePlugin(String) since 2.5.0, use {#link enablePlugins(String... keys)} instead
com.atlassian.plugin.PluginAccessor.getDynamicPluginClass(String) since 0.21 this method is not used, use PluginAccessor.getPlugin(String).getClassLoader().loadClass(String)
com.atlassian.plugin.PluginAccessor.getEnabledModuleDescriptorsByClass(Class<D>, boolean) Since 2.3.0, use #getEnabledModuleDescriptorsByClass(Class) instead
com.atlassian.plugin.PluginAccessor.getEnabledModuleDescriptorsByType(String) since 0.17, use PluginAccessor.getModuleDescriptors(com.atlassian.plugin.predicate.ModuleDescriptorPredicate) with an appropriate predicate instead.
com.atlassian.plugin.PluginAccessor.getEnabledModulesByClassAndDescriptor(Class<ModuleDescriptor<M>>[], Class<M>) since 0.17, use PluginAccessor.getModules(com.atlassian.plugin.predicate.ModuleDescriptorPredicate) with an appropriate predicate instead.
com.atlassian.plugin.PluginAccessor.getEnabledModulesByClassAndDescriptor(Class<ModuleDescriptor<M>>, Class<M>) since 0.17, use PluginAccessor.getModules(com.atlassian.plugin.predicate.ModuleDescriptorPredicate) with an appropriate predicate instead.
com.atlassian.plugin.PluginInformation.getMaxVersion() Since 2.2.0
com.atlassian.plugin.PluginInformation.getMinVersion() Since 2.2.0
com.atlassian.plugin.PluginAccessor.getPluginResourceAsStream(String, String) since 0.21 this method is not used, use PluginAccessor.getPlugin(String).getClassLoader().getResourceAsStream(String)
com.atlassian.plugin.Plugin.getRequiredPlugins() Use Plugin.getDependencies() instead. Since 4.0
com.atlassian.plugin.loaders.LoaderUtils.getResourceDescriptors(Element) use Resources.fromXml(org.dom4j.Element)
com.atlassian.plugin.Resources.getResourceDescriptors(String)
com.atlassian.plugin.Resourced.getResourceDescriptors(String) since 2.5.0 use Resourced.getResourceDescriptors() and filter as required
com.atlassian.plugin.PluginController.installPlugin(PluginArtifact) Since 2.3.0, use PluginController.installPlugins(PluginArtifact...) instead
com.atlassian.plugin.Plugin.isEnabled() since 2.2.0, use Plugin.getPluginState() instead
com.atlassian.plugin.Plugin.isSystemPlugin() since 2.6.0 use com.atlassian.plugin.metadata.PluginMetadataManager#isSystemProvided(Plugin)} instead.
com.atlassian.plugin.Plugin.setEnabled(boolean) Since 2.2.0, use Plugin.enable() or Plugin.disable() instead
com.atlassian.plugin.PluginInformation.setMaxVersion(float) Since 2.2.0
com.atlassian.plugin.PluginInformation.setMinVersion(float) Since 2.2.0
com.atlassian.plugin.Plugin.setSystemPlugin(boolean) since 2.6.0 provide com.atlassian.plugin.metadata.PluginMetadataManager with information about the plugin instead. There is no way to programatically set this value now.

Deprecated Constructors

Constructor and Description
com.atlassian.plugin.Resources(Iterable<ResourceDescriptor>) Since 3.0.1, use Resources.fromXml(org.dom4j.Element) instead. This will lazily create the ResourceDescriptors from the Element, for a memory saving.