Deprecated API

Contents

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

Deprecated Interfaces

Interface and Description
com.atlassian.plugin.AutowireCapablePlugin Since 2.5.0, use ContainerManagedPlugin instead. getContainerAccessor provides access to the container.
com.atlassian.plugin.impl.DynamicPlugin since 2.2.0, use a wrapping plugin based on AbstractDelegatingPlugin instead
com.atlassian.plugin.predicate.ModulePredicate since 2.2 unused
com.atlassian.plugin.PluginManager since 2006-09-26 the preferred technique is to use the interfaces that this on e extends directly.
com.atlassian.plugin.osgi.spring.SpringContainerAccessor since 3.0, just use ContainerAccessor directly

Deprecated Classes

Class and Description
com.atlassian.plugin.servlet.util.ClassLoaderStack Moved to atlassian-plugins-core: com.atlassian.plugin.util.ClassLoaderStack. This impl delegates to the new impl.
com.atlassian.plugin.util.concurrent.CopyOnWriteMap since 2.5.0 please use the CopyOnWriteMap instead as it has some important features and some bug fixes. This version is no longer maintained.
com.atlassian.plugin.DefaultPluginManager Since 2.2.0, use DefaultPluginManager instead
com.atlassian.plugin.servlet.util.LazyLoadedReference since 2.5.0 use LazyReference directly instead.
com.atlassian.plugin.descriptors.ResourcedModuleDescriptor All module descriptors now have resources. Use AbstractModuleDescriptor instead.
com.atlassian.plugin.servlet.ResourceUrlParser Since 2.2

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.
com.atlassian.plugin.PluginManager.PLUGIN_DESCRIPTOR_FILENAME since 2.2 - Please use Descriptor#FILENAME instead.
com.atlassian.plugin.descriptors.AbstractModuleDescriptor.singleton since 2.2.0

Deprecated Methods

Method and Description
com.atlassian.plugin.servlet.ResourceDownloadUtils.addCachingHeaders(HttpServletRequest, HttpServletResponse) Please use ResourceDownloadUtils.addPublicCachingHeaders(HttpServletRequest, HttpServletResponse) or ResourceDownloadUtils.addPrivateCachingHeaders(HttpServletRequest, HttpServletResponse) instead.
com.atlassian.plugin.manager.DefaultPluginManager.addPlugin(PluginLoader, Plugin) Since 2.0.2, use #addPlugins(PluginLoader,Collection...) instead
com.atlassian.plugin.AutowireCapablePlugin.autowire(Class) Since 2.5.0, use com.atlassian.plugin.module.ContainerManagedPlugin.getContainerAccessor() instead.
com.atlassian.plugin.AutowireCapablePlugin.autowire(Class, AutowireCapablePlugin.AutowireStrategy) Since 2.5.0, use com.atlassian.plugin.module.ContainerManagedPlugin.getContainerAccessor() instead.
com.atlassian.plugin.AutowireCapablePlugin.autowire(Object) Since 2.5.0, use com.atlassian.plugin.module.ContainerManagedPlugin.getContainerAccessor() instead.
com.atlassian.plugin.AutowireCapablePlugin.autowire(Object, AutowireCapablePlugin.AutowireStrategy) Since 2.5.0, use com.atlassian.plugin.module.ContainerManagedPlugin.getContainerAccessor() instead.
com.atlassian.plugin.osgi.spring.SpringContainerAccessor.autowireBean(Object, AutowireCapablePlugin.AutowireStrategy) Since 2.5.0, use the createBean method instead.
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.factories.AbstractPluginFactory.create(DeploymentUnit, ModuleDescriptorFactory) Since 2.2.0, use PluginFactory.create(com.atlassian.plugin.PluginArtifact, com.atlassian.plugin.ModuleDescriptorFactory) instead
com.atlassian.plugin.factories.LegacyDynamicPluginFactory.createPlugin(DeploymentUnit, PluginClassLoader) Since 2.2.0, use LegacyDynamicPluginFactory.createPlugin(PluginArtifact,PluginClassLoader) instead
com.atlassian.plugin.util.FileUtils.deleteDir(File) Since 2.0.0. Use Commons IO FileUtils.deleteDirectory(java.io.File) instead.
com.atlassian.plugin.ModuleDescriptor.destroy(Plugin) The plugin parameter is redundant. Override ModuleDescriptor.destroy().
com.atlassian.plugin.descriptors.AbstractModuleDescriptor.destroy(Plugin)
com.atlassian.plugin.PluginController.enablePlugin(String) since 2.5.0, use {#link enablePlugins(String... keys)} instead
com.atlassian.plugin.manager.DefaultPluginManager.enablePlugin(String) since 2.5.0, use {#link enablePlugins(String... keys)} instead
com.atlassian.plugin.osgi.util.OsgiHeaderUtil.findReferredPackages(List) Since 2.7.0, use OsgiHeaderUtil.findReferredPackageNames(java.util.List) instead.
com.atlassian.plugin.osgi.util.OsgiHeaderUtil.findReferredPackages(List, Map) Since 2.7.0, use OsgiHeaderUtil.findReferredPackageVersions(java.util.List, java.util.Map) instead.
com.atlassian.plugin.impl.DefaultDynamicPlugin.getDeploymentUnit() Since 2.2.0, use DefaultDynamicPlugin.getPluginArtifact() 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, 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.manager.DefaultPluginManager.getEnabledModuleDescriptorsByType(String) since 0.17, use DefaultPluginManager.getModuleDescriptors(com.atlassian.plugin.predicate.ModuleDescriptorPredicate) with an appropriate predicate instead.
com.atlassian.plugin.PluginAccessor.getEnabledModulesByClassAndDescriptor(Class>[], Class) since 0.17, use PluginAccessor.getModules(com.atlassian.plugin.predicate.ModuleDescriptorPredicate) with an appropriate predicate instead.
com.atlassian.plugin.manager.DefaultPluginManager.getEnabledModulesByClassAndDescriptor(Class>[], Class) since 0.17, use DefaultPluginManager.getModules(com.atlassian.plugin.predicate.ModuleDescriptorPredicate) with an appropriate predicate instead.
com.atlassian.plugin.PluginAccessor.getEnabledModulesByClassAndDescriptor(Class>, Class) since 0.17, use PluginAccessor.getModules(com.atlassian.plugin.predicate.ModuleDescriptorPredicate) with an appropriate predicate instead.
com.atlassian.plugin.manager.DefaultPluginManager.getEnabledModulesByClassAndDescriptor(Class>, Class) since 0.17, use DefaultPluginManager.getModules(com.atlassian.plugin.predicate.ModuleDescriptorPredicate) with an appropriate predicate instead.
com.atlassian.plugin.servlet.ServletModuleManager.getFilters(FilterLocation, String, FilterConfig) Since 2.5.0, use ServletModuleManager.getFilters(FilterLocation,String,FilterConfig,FilterDispatcherCondition) instead
com.atlassian.plugin.PluginInformation.getMaxVersion() Since 2.2.0
com.atlassian.plugin.PluginInformation.getMinVersion() Since 2.2.0
com.atlassian.plugin.osgi.factory.descriptor.ComponentModuleDescriptor.getModuleClassName() - BEWARE that this is a temporary method that will not exist for long. Deprecated since 2.3.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.impl.AbstractPlugin.getResourceDescriptor(String, String)
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.servlet.descriptors.ServletModuleDescriptor.getServlet() Since 2.0.0, use ServletModuleDescriptor.getModule()
com.atlassian.plugin.module.PrefixDelegatingModuleFactory.guessModuleClass(String, ModuleDescriptor) Since 2.5.0
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.impl.AbstractPlugin.isEnabled()
com.atlassian.plugin.descriptors.AbstractModuleDescriptor.isSingleton() Since 2.2.0
com.atlassian.plugin.descriptors.AbstractModuleDescriptor.isSingletonByDefault() Since 2.2.0
com.atlassian.plugin.Plugin.isSystemPlugin() since 2.6.0 use PluginMetadataManager.isSystemProvided(Plugin)} instead.
com.atlassian.plugin.parsers.DescriptorParser.isSystemPlugin() The parser will set the SystemPlugin flag within the configurePlugin() method, so there is no need to use this externally. See PLUG-415. Deprecated since 2.3.0
com.atlassian.plugin.descriptors.AbstractModuleDescriptor.loadClass(Plugin, Element) Since 2.1.0, use AbstractModuleDescriptor.loadClass(Plugin,String) instead
com.atlassian.plugin.servlet.ResourceDownloadUtils.serveFileImpl(HttpServletResponse, InputStream) Since 2.0. Use IOUtils.copy(InputStream, OutputStream) instead. The method calling this should be responsible for closing streams and flushing if necessary.
com.atlassian.plugin.manager.DefaultPluginManager.setDescriptorParserFactory(DescriptorParserFactory) Since 2.0.0.beta2
com.atlassian.plugin.Plugin.setEnabled(boolean) Since 2.2.0, use Plugin.enable() or Plugin.disable() instead
com.atlassian.plugin.impl.AbstractPlugin.setEnabled(boolean)
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 PluginMetadataManager with information about the plugin instead. There is no way to programatically set this value now.
com.atlassian.plugin.loaders.ScanningPluginLoader.shutDown() Since 2.0.0, shutdown will automatically occur when the plugin framework is shutdown
com.atlassian.plugin.util.FileUtils.toFile(URL) Since 3.0. Use Commons IO FileUtils.toFile(java.net.URL) instead.

Deprecated Constructors

Constructor and Description
com.atlassian.plugin.DefaultModuleDescriptorFactory() Since 2.2.0, use DefaultModuleDescriptorFactory.DefaultModuleDescriptorFactory(HostContainer) instead
com.atlassian.plugin.osgi.container.impl.DefaultOsgiPersistentCache(File, String)
com.atlassian.plugin.manager.DefaultPluginPersistentState() create PluginPersistentState instances using the PluginPersistentState.Builder
com.atlassian.plugin.manager.DefaultPluginPersistentState(Map) create PluginPersistentState instances using the PluginPersistentState.Builder
com.atlassian.plugin.manager.DefaultPluginPersistentState(PluginPersistentState)
com.atlassian.plugin.osgi.container.felix.FelixOsgiContainerManager(File, PackageScannerConfiguration, HostComponentProvider, PluginEventManager) Since 2.2.0, use FelixOsgiContainerManager.FelixOsgiContainerManager(OsgiPersistentCache,PackageScannerConfiguration,HostComponentProvider,PluginEventManager) instead
com.atlassian.plugin.osgi.container.felix.FelixOsgiContainerManager(URL, File, PackageScannerConfiguration, HostComponentProvider, PluginEventManager) Since 2.2.0, use FelixOsgiContainerManager.FelixOsgiContainerManager(URL, OsgiPersistentCache,PackageScannerConfiguration,HostComponentProvider,PluginEventManager) instead
com.atlassian.plugin.classloader.PluginsClassLoader(ClassLoader, PluginAccessor) Since 2.5.0, use PluginsClassLoader.PluginsClassLoader(ClassLoader, PluginAccessor, PluginEventManager) instead
com.atlassian.plugin.Resources(Iterable) Since 3.0.1, use Resources.fromXml(org.dom4j.Element) instead. This will lazily create the ResourceDescriptors from the Element, for a memory saving.
com.atlassian.plugin.loaders.SinglePluginLoader(InputStream) since 2.2 use the version that passes a URL instead. Not used by the plugins system.