com.atlassian.plugin.osgi.factory
Class OsgiPlugin

java.lang.Object
  com.atlassian.plugin.impl.AbstractPlugin
      com.atlassian.plugin.osgi.factory.OsgiPlugin

All Implemented Interfaces:

AutowireCapablePlugin, ContainerManagedPlugin, Plugin, PluginArtifactBackedPlugin, Resourced, java.lang.Comparable<Plugin>

public class OsgiPlugin
extends AbstractPlugin
implements AutowireCapablePlugin, ContainerManagedPlugin

Plugin that wraps an OSGi bundle that does contain a plugin descriptor. The actual bundle is not created until the AbstractPlugin.install() method is invoked. Any attempt to access a method that requires a bundle will throw an IllegalPluginStateException. This class uses a OsgiPluginHelper to represent different behaviors of key methods in different states. OsgiPluginUninstalledHelper implements the methods when the plugin hasn't yet been installed into the OSGi container, while OsgiPluginInstalledHelper implements the methods when the bundle is available. This leaves this class to manage the PluginState and interactions with the event system.

Nested Class Summary

Nested classes/interfaces inherited from interface com.atlassian.plugin.AutowireCapablePlugin

AutowireCapablePlugin.AutowireStrategy

Field Summary

static java.lang.String	ATLASSIAN_PLUGIN_KEY Manifest key for the Atlassian plugin key entry
static java.lang.String	REMOTE_PLUGIN_KEY Manifest key denoting Atlassian remote plugins

Fields inherited from interface com.atlassian.plugin.Plugin

NAME_COMPARATOR, VERSION_1, VERSION_2, VERSION_3

Constructor Summary

OsgiPlugin(java.lang.String key, OsgiContainerManager mgr, PluginArtifact artifact, PluginArtifact originalPluginArtifact, PluginEventManager pluginEventManager)

Method Summary

<T> T	autowire(java.lang.Class<T> clazz) Creates and autowires the class, preferring constructor inject, then falling back to private field and setter
<T> T	autowire(java.lang.Class<T> clazz, AutowireCapablePlugin.AutowireStrategy autowireStrategy) Creates and autowires the class
void	autowire(java.lang.Object instance) Autowires the instance using plugin container's default injection algorithm
void	autowire(java.lang.Object instance, AutowireCapablePlugin.AutowireStrategy autowireStrategy) Autowires the instance
protected void	disableInternal() Disables the plugin by changing the bundle state back to resolved
protected PluginState	enableInternal() Enables the plugin by setting the OSGi bundle state to enabled.
org.osgi.framework.Bundle	getBundle()
java.lang.ClassLoader	getClassLoader() Get the classloader for the plugin.
ContainerAccessor	getContainerAccessor()
java.util.Date	getDateInstalled() The date this plugin was installed into the system, is the same as the loaded date for non artifact backed plugins
InstallationMode	getInstallationMode() Gets the installation mode
PluginArtifact	getPluginArtifact()
java.util.Set<java.lang.String>	getRequiredPlugins() Determines which plugins are required for this one to operate based on tracing the "wires" or packages that are imported by this plugin.
java.net.URL	getResource(java.lang.String name) Retrieve the URL of the resource from the plugin.
java.io.InputStream	getResourceAsStream(java.lang.String name) Load a given resource from the plugin.
protected void	installInternal() Installs the plugin artifact into OSGi
boolean	isDeleteable() Should the plugin file be deleted on unistall?
boolean	isDynamicallyLoaded() Whether or not this plugin is loaded dynamically at runtime.
boolean	isUninstallable() Whether or not this plugin can be 'uninstalled'.
<T> java.lang.Class<T>	loadClass(java.lang.String clazz, java.lang.Class<?> callingClass) Get the plugin to load a specific class.
void	onPluginContainerFailed(PluginContainerFailedEvent event) Called when the plugin container for the bundle has failed to be created.
void	onPluginContainerRefresh(PluginContainerRefreshedEvent event) Called when the plugin container for the bundle has been created or refreshed.
void	onPluginFrameworkShutdownEvent(PluginFrameworkShutdownEvent event)
void	onPluginFrameworkStartedEvent(PluginFrameworkStartedEvent event)
void	onServiceDependencyWaitEnded(PluginServiceDependencyWaitEndedEvent event)
void	onServiceDependencyWaitEnded(PluginServiceDependencyWaitTimedOutEvent event)
void	onServiceDependencyWaitStarting(PluginServiceDependencyWaitStartingEvent event)
java.lang.String	toString()
protected void	uninstallInternal() Uninstalls the bundle from the OSGi container

Methods inherited from class com.atlassian.plugin.impl.AbstractPlugin

addModuleDescriptor, close, compareAndSetPluginState, compareTo, containsSystemModule, disable, enable, getActivePermissions, getDateLoaded, getI18nNameKey, getKey, getLog, getModuleDescriptor, getModuleDescriptors, getModuleDescriptorsByModuleClass, getName, getPluginInformation, getPluginState, getPluginsVersion, getResourceDescriptor, getResourceDescriptors, getResourceDescriptors, getResourceLocation, hasAllPermissions, install, isBundledPlugin, isEnabled, isEnabledByDefault, isSystemPlugin, removeModuleDescriptor, setEnabled, setEnabledByDefault, setI18nNameKey, setKey, setName, setPluginInformation, setPluginState, setPluginsVersion, setResources, setSystemPlugin, uninstall

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.atlassian.plugin.Plugin

addModuleDescriptor, close, containsSystemModule, disable, enable, getActivePermissions, getDateLoaded, getI18nNameKey, getKey, getModuleDescriptor, getModuleDescriptors, getModuleDescriptorsByModuleClass, getName, getPluginInformation, getPluginState, getPluginsVersion, hasAllPermissions, install, isBundledPlugin, isEnabled, isEnabledByDefault, isSystemPlugin, setEnabled, setEnabledByDefault, setI18nNameKey, setKey, setName, setPluginInformation, setPluginsVersion, setResources, setSystemPlugin, uninstall

Methods inherited from interface com.atlassian.plugin.Resourced

getResourceDescriptor, getResourceDescriptors, getResourceDescriptors, getResourceLocation

Methods inherited from interface java.lang.Comparable

compareTo

Field Detail

ATLASSIAN_PLUGIN_KEY

public static final java.lang.String ATLASSIAN_PLUGIN_KEY

Manifest key for the Atlassian plugin key entry

See Also:

Constant Field Values

REMOTE_PLUGIN_KEY

public static final java.lang.String REMOTE_PLUGIN_KEY

Manifest key denoting Atlassian remote plugins

See Also:

Constant Field Values

Constructor Detail

OsgiPlugin

public OsgiPlugin(java.lang.String key,
                  OsgiContainerManager mgr,
                  PluginArtifact artifact,
                  PluginArtifact originalPluginArtifact,
                  PluginEventManager pluginEventManager)

Method Detail

getBundle

public org.osgi.framework.Bundle getBundle()
                                    throws IllegalPluginStateException

Returns:

The active bundle

Throws:

IllegalPluginStateException - if the bundle hasn't been created yet

getInstallationMode

public InstallationMode getInstallationMode()

Description copied from interface: Plugin

Gets the installation mode

Specified by:

getInstallationMode in interface Plugin

Overrides:

getInstallationMode in class AbstractPlugin

Returns:

the plugin's installation mode, local or remote.

isUninstallable

public boolean isUninstallable()

Description copied from interface: Plugin

Whether or not this plugin can be 'uninstalled'.

Specified by:

isUninstallable in interface Plugin

Returns:

true

isDynamicallyLoaded

public boolean isDynamicallyLoaded()

Description copied from interface: Plugin

Whether or not this plugin is loaded dynamically at runtime.

Specified by:

isDynamicallyLoaded in interface Plugin

Returns:

true

isDeleteable

public boolean isDeleteable()

Description copied from interface: Plugin

Should the plugin file be deleted on unistall?

Specified by:

isDeleteable in interface Plugin

Returns:

true

getDateInstalled

public java.util.Date getDateInstalled()

Description copied from interface: Plugin

The date this plugin was installed into the system, is the same as the loaded date for non artifact backed plugins

Specified by:

getDateInstalled in interface Plugin

Overrides:

getDateInstalled in class AbstractPlugin

Returns:

The date this plugin was installed into the system

getPluginArtifact

public PluginArtifact getPluginArtifact()

Specified by:

getPluginArtifact in interface PluginArtifactBackedPlugin

Returns:

the original, unprocessed or transformed PluginArtifact used to create this plugin instance. Cannot be null.

loadClass

public <T> java.lang.Class<T> loadClass(java.lang.String clazz,
                                        java.lang.Class<?> callingClass)
                             throws java.lang.ClassNotFoundException,
                                    IllegalPluginStateException

Description copied from interface: Plugin

Get the plugin to load a specific class.

Specified by:

loadClass in interface Plugin

Type Parameters:

T - The class type

Parameters:

clazz - The name of the class to be loaded

callingClass - The class calling the loading (used to help find a classloader)

Returns:

The class instance, loaded from the OSGi bundle

Throws:

java.lang.ClassNotFoundException - If the class cannot be found

IllegalPluginStateException - if the bundle hasn't been created yet

getResource

public java.net.URL getResource(java.lang.String name)
                         throws IllegalPluginStateException

Description copied from interface: Plugin

Retrieve the URL of the resource from the plugin.

Specified by:

getResource in interface Plugin

Parameters:

name - The resource name

Returns:

The resource URL, null if not found

Throws:

IllegalPluginStateException - if the bundle hasn't been created yet

getResourceAsStream

public java.io.InputStream getResourceAsStream(java.lang.String name)
                                        throws IllegalPluginStateException

Description copied from interface: Plugin

Load a given resource from the plugin. Plugins that are loaded dynamically will need to implement this in a way that loads the resource from the same context as the plugin. Static plugins can just pull them from their own classloader.

Specified by:

getResourceAsStream in interface Plugin

Parameters:

name - The name of the resource to be loaded.

Returns:

Null if not found

Throws:

IllegalPluginStateException - if the bundle hasn't been created yet

getClassLoader

public java.lang.ClassLoader getClassLoader()
                                     throws IllegalPluginStateException

Description copied from interface: Plugin

Get the classloader for the plugin.

Specified by:

getClassLoader in interface Plugin

Returns:

The classloader to load classes and resources from the bundle

Throws:

IllegalPluginStateException - if the bundle hasn't been created yet

onPluginContainerFailed

public void onPluginContainerFailed(PluginContainerFailedEvent event)
                             throws IllegalPluginStateException

Called when the plugin container for the bundle has failed to be created. This means the bundle is still active, but the plugin container is not available, so for our purposes, the plugin shouldn't be enabled.

Parameters:

event - The plugin container failed event

Throws:

IllegalPluginStateException - If the plugin key hasn't been set yet

onPluginFrameworkStartedEvent

public void onPluginFrameworkStartedEvent(PluginFrameworkStartedEvent event)

onPluginFrameworkShutdownEvent

public void onPluginFrameworkShutdownEvent(PluginFrameworkShutdownEvent event)

onServiceDependencyWaitStarting

public void onServiceDependencyWaitStarting(PluginServiceDependencyWaitStartingEvent event)

onServiceDependencyWaitEnded

public void onServiceDependencyWaitEnded(PluginServiceDependencyWaitEndedEvent event)

onServiceDependencyWaitEnded

public void onServiceDependencyWaitEnded(PluginServiceDependencyWaitTimedOutEvent event)

onPluginContainerRefresh

public void onPluginContainerRefresh(PluginContainerRefreshedEvent event)
                              throws IllegalPluginStateException

Called when the plugin container for the bundle has been created or refreshed. If this is the first time the context has been refreshed, then it is a new context. Otherwise, this means that the bundle has been reloaded, usually due to a dependency upgrade.

Parameters:

event - The event

Throws:

IllegalPluginStateException - If the plugin key hasn't been set yet

autowire

public <T> T autowire(java.lang.Class<T> clazz)
           throws IllegalPluginStateException

Creates and autowires the class, preferring constructor inject, then falling back to private field and setter

Specified by:

autowire in interface AutowireCapablePlugin

Parameters:

clazz - The class to create

Returns:

The created and wired bean

Throws:

IllegalPluginStateException - if the bundle hasn't been created yet

autowire

public <T> T autowire(java.lang.Class<T> clazz,
                      AutowireCapablePlugin.AutowireStrategy autowireStrategy)
           throws IllegalPluginStateException

Creates and autowires the class

Specified by:

autowire in interface AutowireCapablePlugin

Parameters:

clazz - The class to create

autowireStrategy - The autowire strategy

Returns:

The created and wired bean

Throws:

IllegalPluginStateException - if the bundle hasn't been created yet

autowire

public void autowire(java.lang.Object instance)
              throws java.lang.IllegalStateException

Autowires the instance using plugin container's default injection algorithm

Specified by:

autowire in interface AutowireCapablePlugin

Parameters:

instance - The object to inject

Throws:

IllegalPluginStateException - if the bundle hasn't been created yet

java.lang.IllegalStateException

autowire

public void autowire(java.lang.Object instance,
                     AutowireCapablePlugin.AutowireStrategy autowireStrategy)
              throws IllegalPluginStateException

Autowires the instance

Specified by:

autowire in interface AutowireCapablePlugin

Parameters:

instance - The object to autowire

autowireStrategy - The autowire strategy, must not be constructor

Throws:

IllegalPluginStateException - if the bundle hasn't been created yet

getRequiredPlugins

public java.util.Set<java.lang.String> getRequiredPlugins()
                                                   throws IllegalPluginStateException

Determines which plugins are required for this one to operate based on tracing the "wires" or packages that are imported by this plugin. Bundles that provide those packages are determined to be required plugins.

Specified by:

getRequiredPlugins in interface Plugin

Overrides:

getRequiredPlugins in class AbstractPlugin

Returns:

A set of bundle symbolic names, or plugin keys. Empty set if none.

Throws:

IllegalPluginStateException

Since:

2.2.0

toString

public java.lang.String toString()

Overrides:

toString in class AbstractPlugin

installInternal

protected void installInternal()
                        throws IllegalPluginStateException

Installs the plugin artifact into OSGi

Overrides:

installInternal in class AbstractPlugin

Throws:

IllegalPluginStateException - if the bundle hasn't been created yet

enableInternal

protected PluginState enableInternal()
                              throws OsgiContainerException,
                                     IllegalPluginStateException

Enables the plugin by setting the OSGi bundle state to enabled.

Overrides:

enableInternal in class AbstractPlugin

Returns:

PluginState.ENABLEDif the container is being refreshed or PluginState.ENABLING if we are waiting on a plugin container (first time being activated, as all subsequent times are considered refreshes)

Throws:

OsgiContainerException - If the underlying OSGi system threw an exception or we tried to enable the bundle when it was in an invalid state

IllegalPluginStateException - if the bundle hasn't been created yet

disableInternal

protected void disableInternal()
                        throws OsgiContainerException,
                               IllegalPluginStateException

Disables the plugin by changing the bundle state back to resolved

Overrides:

disableInternal in class AbstractPlugin

Throws:

OsgiContainerException - If the OSGi system threw an exception

IllegalPluginStateException - if the bundle hasn't been created yet

uninstallInternal

protected void uninstallInternal()
                          throws OsgiContainerException,
                                 IllegalPluginStateException

Uninstalls the bundle from the OSGi container

Overrides:

uninstallInternal in class AbstractPlugin

Throws:

OsgiContainerException - If the underlying OSGi system threw an exception

IllegalPluginStateException - if the bundle hasn't been created yet

getContainerAccessor

public ContainerAccessor getContainerAccessor()

Specified by:

getContainerAccessor in interface ContainerManagedPlugin

Returns:

The object to use to access the plugin's container