java.lang.Object | |
↳ | com.atlassian.plugin.impl.AbstractDelegatingPlugin |
Delegating plugin that supports easy wrapping
[Expand]
Inherited Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From interface
com.atlassian.plugin.Plugin
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Creates and autowires a class with a specific autowire strategy
| |||||||||||
Creates and autowires a class using the default strategy.
| |||||||||||
Autowires an existing object with a specific autowire strategy
| |||||||||||
Autowires an existing object using the default strategy.
| |||||||||||
Free any resources held by this plugin.
| |||||||||||
Disables the plugin.
| |||||||||||
Enables the plugin.
| |||||||||||
Get the classloader for the plugin.
| |||||||||||
The date this plugin was loaded into the system.
| |||||||||||
Returns the i18nKey used to get an internationalised name for this plugin.
| |||||||||||
Get the
ModuleDescriptor for a particular key. | |||||||||||
Get the
Collection of descriptors . | |||||||||||
Get the
descriptors whose module class implements or is assignable from the supplied Class . | |||||||||||
Returns the non-localised name of this plugin if defined.
| |||||||||||
Returns this plugin's current state.
| |||||||||||
Gets the version of the plugins system to handle this plugin
| |||||||||||
Retrieve the URL of the resource from the plugin.
| |||||||||||
Load a given resource from the plugin.
| |||||||||||
Get a
ResourceDescriptor of a particular type and name. | |||||||||||
Get a
List of all the descriptors
. | |||||||||||
Get a list of all
descriptors of a particular
type. | |||||||||||
Get a
ResourceLocation of a particular type and name. | |||||||||||
Installs the plugin into any internal, managing container.
| |||||||||||
Whether the plugin is a "bundled" plugin that can't be removed.
| |||||||||||
Should the plugin file be deleted on unistall?
| |||||||||||
Whether or not this plugin is loaded dynamically at runtime.
| |||||||||||
Whether the plugin is a "system" plugin that shouldn't be made visible to the user.
| |||||||||||
Whether or not this plugin can be 'uninstalled'.
| |||||||||||
Get the plugin to load a specific class.
| |||||||||||
Sets the i18nKey used to get an internationalised name for this plugin.
| |||||||||||
Sets the non-localised name of this plugin.
| |||||||||||
Sets the version of the plugins system
| |||||||||||
Uninstalls the plugin from any internal container.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
From interface
com.atlassian.plugin.AutowireCapablePlugin
| |||||||||||
From interface
com.atlassian.plugin.Plugin
| |||||||||||
From interface
com.atlassian.plugin.Resourced
| |||||||||||
From interface
java.lang.Comparable
|
Creates and autowires a class with a specific autowire strategy
clazz | The class to create |
---|---|
autowireStrategy | The autowire strategy |
UnsupportedOperationException | If the underlying delegate doesn't
implement AutowireCapablePlugin |
---|
Creates and autowires a class using the default strategy.
clazz | The class to create |
---|
UnsupportedOperationException | If the underlying delegate doesn't
implement AutowireCapablePlugin |
---|
Autowires an existing object with a specific autowire strategy
instance | The object to autowire |
---|---|
autowireStrategy | The autowire strategy, must not be constructor |
UnsupportedOperationException | If the underlying delegate doesn't
implement AutowireCapablePlugin |
---|
Autowires an existing object using the default strategy.
instance | The object to inject |
---|
UnsupportedOperationException | If the underlying delegate doesn't
implement AutowireCapablePlugin |
---|
Free any resources held by this plugin. To be called during uninstallation of the Plugin
.
Get the classloader for the plugin.
The date this plugin was loaded into the system.
Returns the i18nKey used to get an internationalised name for this plugin.
This corresponds to the value of the i18n-name-key
field in the plugin's XML configuration file.
You would expect a plugin developer to fill in one of either name
, or i18n-name-key
,
but the framework does no validation and makes no guarantees that this is the case.
Get the ModuleDescriptor
for a particular key. Returns null if the plugin does not exist.
Note: The getModule()
may throw ClassCastException if the expected type is incorrect.
key | the String complete key of the module, in the form "org.example.plugin:module-key". |
---|
ModuleDescriptor
of the expected type.
Get the Collection
of descriptors
.
The iteration order of the collection is the order that the modules will be enabled, and should be the same order that the modules appear in the plugin descriptor.
Get the descriptors
whose module class implements or is assignable from the supplied Class
.
Note: The getModule()
may throw ClassCastException if the expected type is incorrect.
Normally this method would not be supplied with anything other than Object
or <?>, unless you are
confident in the super type of the module classes this Plugin
provides.
moduleClass | the super class the descriptors return. |
---|
List
of descriptors
of the expected type.
Returns the non-localised name of this plugin if defined.
This corresponds to the value of the name
field in the plugin's XML configuration file.
You would expect a plugin developer to fill in one of either name
, or i18n-name-key
,
but the framework does no validation and makes no guarantees that this is the case.
Returns this plugin's current state.
Gets the version of the plugins system to handle this plugin
Retrieve the URL of the resource from the plugin.
path | the name of the resource to be loaded |
---|
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.
name | The name of the resource to be loaded. |
---|
Get a ResourceDescriptor
of a particular type and name.
Get a List
of all the descriptors
.
Note: since 2.2 this list must be immutable, previously modifying this list could modify the underlying list.
Get a list of all descriptors
of a particular
type.
Note: since 2.2 this list must be immutable, previously this list was modifiable but modifications would not be reflected in the underlying list.
Get a ResourceLocation
of a particular type and name.
Whether the plugin is a "bundled" plugin that can't be removed.
true
if this plugin is a "bundled" plugin.
Should the plugin file be deleted on unistall?
true
if this plugin file should be deleted on unistall.
Whether or not this plugin is loaded dynamically at runtime.
true
if this plugin is loaded dynamically at runtime.
Whether the plugin is a "system" plugin that shouldn't be made visible to the user.
true
if this plugin is a "system" plugin.
Whether or not this plugin can be 'uninstalled'.
true
if this plugin can be 'uninstalled'.
Get the plugin to load a specific class.
clazz | The name of the class to be loaded |
---|---|
callingClass | The class calling the loading (used to help find a classloader) |
ClassNotFoundException |
---|
Sets the i18nKey used to get an internationalised name for this plugin.
i18nNameKey | the i18n Name Key. |
---|
Sets the non-localised name of this plugin.
name | the name. |
---|
Sets the version of the plugins system
version | The version |
---|
Uninstalls the plugin from any internal container. This method will be called on every shutdown. Unless an
exception is thrown, the plugin should be in the UNINSTALLED
state. If the plugin is already
in the UNINSTALLED
state, nothing will happen.