PluginWrapper (Jenkins core 2.316 API)

java.lang.Object
- hudson.PluginWrapper

All Implemented Interfaces:

ModelObject, Comparable<PluginWrapper>
```
@ExportedBean
public class PluginWrapper
extends Object
implements Comparable<PluginWrapper>, ModelObject
```
Represents a Jenkins plug-in and associated control information for Jenkins to control Plugin.
A plug-in is packaged into a jar file whose extension is ".jpi" (or ".hpi" for backward compatibility), A plugin needs to have a special manifest entry to identify what it is.
At the runtime, a plugin has two distinct state axis.
1. Enabled/Disabled. If enabled, Jenkins is going to use it next time Jenkins runs. Otherwise the next run will ignore it.
2. Activated/Deactivated. If activated, that means Jenkins is using the plugin in this session. Otherwise it's not.
For example, an activated but disabled plugin is still running but the next time it won't.
Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`PluginWrapper.Dependency`
`static class`	`PluginWrapper.PluginDisableResult` The result of the disablement of a plugin and its dependents plugins.
`static class`	`PluginWrapper.PluginDisableStatus` An enum to hold the status of a disabling action against a plugin.
`static class`	`PluginWrapper.PluginDisableStrategy` The strategies defined for disabling a plugin.
`static class`	`PluginWrapper.PluginWrapperAdministrativeMonitor` Administrative Monitor for failed plugins

Field Summary

Fields
Modifier and Type	Field and Description
`URL`	`baseResourceURL` Base URL for loading static resources from this plugin.
`ClassLoader`	`classLoader` `ClassLoader` for loading classes from this plugin.
`static String`	`MANIFEST_FILENAME` Name of the plugin manifest file (to help find where we parse them.)
`static PluginWrapper.PluginWrapperAdministrativeMonitor`	`NOTICE`
`PluginManager`	`parent` `PluginManager` to which this belongs to.

Constructor Summary

Constructors
Constructor and Description
`PluginWrapper(PluginManager parent, File archive, Manifest manifest, URL baseResourceURL, ClassLoader classLoader, File disableFile, List<PluginWrapper.Dependency> dependencies, List<PluginWrapper.Dependency> optionalDependencies)`

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`int`	`compareTo(PluginWrapper pw)` Sort by short name.
`void`	`disable()` Deprecated.
`PluginWrapper.PluginDisableResult`	`disable(PluginWrapper.PluginDisableStrategy strategy)` Disable this plugin using a strategy.
`org.kohsuke.stapler.HttpResponse`	`doDoUninstall()`
`org.kohsuke.stapler.HttpResponse`	`doMakeDisabled()`
`org.kohsuke.stapler.HttpResponse`	`doMakeEnabled()`
`org.kohsuke.stapler.HttpResponse`	`doPin()` Deprecated.
`org.kohsuke.stapler.HttpResponse`	`doUnpin()` Deprecated.
`void`	`enable()` Enables this plugin next time Jenkins runs.
`List<UpdateSite.Warning>`	`getActiveWarnings()`
`Api`	`getApi()`
`File`	`getBackupFile()` Where is the backup file?
`String`	`getBackupVersion()` returns the version of the backed up plugin, or null if there's no back up.
`Set<String>`	`getDependants()` Deprecated. Please use `getDependents()`.
`List<PluginWrapper.Dependency>`	`getDependencies()` Gets all dependencies of this plugin on other plugins.
`List<String>`	`getDependencyErrors()`
`Set<String>`	`getDependents()` Get the list of components that depend on this plugin.
`List<UpdateSite.Deprecation>`	`getDeprecations()`
`List<String>`	`getDerivedDependencyErrors()`
`String`	`getDisplayName()`
`Set<String>`	`getImpliedDependents()` Get list of implied dependencies.
`URL`	`getIndexPage()` Returns the URL of the index page jelly script.
`UpdateSite.Plugin`	`getInfo()` returns the `UpdateSite.Plugin` object, or null.
`String`	`getLongName()` Deprecated. For most purposes, use `getDisplayName()`.
`List<PluginWrapper.Dependency>`	`getMandatoryDependencies()` Like `getDependencies()` but omits optional dependencies.
`Set<String>`	`getMandatoryDependents()` Like `getDependents()` but excluding optional dependencies.
`Manifest`	`getManifest()`
`String`	`getMinimumJavaVersion()` Returns the minimum Java version of this plugin, as specified in the plugin metadata.
`Set<String>`	`getOptionalDependants()` Deprecated. Please use `getOptionalDependents()`.
`List<PluginWrapper.Dependency>`	`getOptionalDependencies()`
`Set<String>`	`getOptionalDependents()`
`List<String>`	`getOriginalDependencyErrors()`
`Plugin`	`getPlugin()` Gets the instance of `Plugin` contributed by this plugin.
`String`	`getPluginClass()`
`Plugin`	`getPluginOrFail()` Gets the instance of `Plugin` contributed by this plugin.
`String`	`getRequiredCoreVersion()` Returns the required Jenkins core version of this plugin.
`String`	`getShortName()` Returns the short name suitable for URL.
`UpdateSite.Plugin`	`getUpdateInfo()` If the plugin has `an update`, returns the `UpdateSite.Plugin` object.
`String`	`getUrl()` Gets the URL that shows more information about this plugin.
`String`	`getVersion()` Returns the version number of this plugin
`VersionNumber`	`getVersionNumber()` Returns the version number of this plugin
`boolean`	`hasCycleDependency()`
`boolean`	`hasDependants()` Deprecated. Please use `hasDependents()`.
`boolean`	`hasDependencies()` Does this plugin depend on any other plugins.
`boolean`	`hasDependents()` Does this plugin have anything that depends on it.
`boolean`	`hasDerivedDependencyErrors()`
`boolean`	`hasImpliedDependents()`
`boolean`	`hasLicensesXml()`
`boolean`	`hasMandatoryDependencies()` Like `hasDependencies()` but omitting optional dependencies.
`boolean`	`hasMandatoryDependents()` Like `hasDependents()` but excluding optional dependencies.
`boolean`	`hasOptionalDependants()` Deprecated. Please use `hasOptionalDependents()`.
`boolean`	`hasOptionalDependents()` Does this plugin have anything that depends optionally on it.
`boolean`	`hasOriginalDependencyErrors()`
`boolean`	`hasUpdate()` Returns true if this plugin has update in the update center.
`void`	`injectJarsToClasspath(File... jars)` Inject the specified jar file(s) to the plugins classpath.
`boolean`	`isActive()` Returns true if this plugin is enabled for this session.
`boolean`	`isBundled()` Is this plugin bundled in the WAR? Normally false as noted in `PluginManager.loadBundledPlugins()`: this does not apply to “detached” plugins.
`boolean`	`isDeleted()` Returns true if this plugin is deleted.
`boolean`	`isDeprecated()` Is this plugin deprecated?
`boolean`	`isDetached()` Same as `DetachedPluginsUtil.isDetachedPlugin(java.lang.String)`.
`boolean`	`isDowngradable()` returns true if backup of previous version of plugin exists
`boolean`	`isEnabled()` If true, the plugin is going to be activated next time Jenkins runs.
`boolean`	`isOlderThan(VersionNumber v)` Returns true if the version of this plugin is older than the given version.
`boolean`	`isPinned()` Deprecated.
`boolean`	`isPinningForcingOldVersion()` Deprecated.
`void`	`releaseClassLoader()`
`void`	`setDependants(Set<String> dependents)` Deprecated. Please use `setDependents(java.util.Set<java.lang.String>)`.
`void`	`setDependents(Set<String> dependents)` Set the list of components that depend on this plugin.
`void`	`setHasCycleDependency(boolean hasCycle)`
`void`	`setOptionalDependants(Set<String> optionalDependents)` Deprecated. Please use `setOptionalDependents(java.util.Set<java.lang.String>)`.
`void`	`setOptionalDependents(Set<String> optionalDependents)` Set the list of components that depend optionally on this plugin.
`void`	`setPlugin(Plugin plugin)`
`void`	`stop()` Terminates the plugin.
`YesNoMaybe`	`supportsDynamicLoad()` Does this plugin supports dynamic loading?
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - parent
```
public final PluginManager parent
```
    PluginManager to which this belongs to.
  - classLoader
```
public final ClassLoader classLoader
```
    ClassLoader for loading classes from this plugin. Null if disabled.
  - baseResourceURL
```
public final URL baseResourceURL
```
    Base URL for loading static resources from this plugin. Null if disabled. The static resources are mapped under CONTEXTPATH/plugin/SHORTNAME/.
  - NOTICE
```
@Extension
public static final PluginWrapper.PluginWrapperAdministrativeMonitor NOTICE
```
  - MANIFEST_FILENAME
```
public static final String MANIFEST_FILENAME
```
    Name of the plugin manifest file (to help find where we parse them.)
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - PluginWrapper
```
public PluginWrapper(PluginManager parent,
                     File archive,
                     Manifest manifest,
                     URL baseResourceURL,
                     ClassLoader classLoader,
                     File disableFile,
                     List<PluginWrapper.Dependency> dependencies,
                     List<PluginWrapper.Dependency> optionalDependencies)
```
    Parameters:
    
    archive - A .jpi archive file jar file, or a .jpl linked plugin.
    
    manifest - The manifest for the plugin
    
    baseResourceURL - A URL pointing to the resources for this plugin
    
    classLoader - a classloader that loads classes from this plugin and its dependencies
    
    disableFile - if this file exists on startup, the plugin will not be activated
    
    dependencies - a list of mandatory dependencies
    
    optionalDependencies - a list of optional dependencies
- Method Detail
  - getDependencyErrors
```
public List<String> getDependencyErrors()
```
  - getOriginalDependencyErrors
```
@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public List<String> getOriginalDependencyErrors()
```
  - hasOriginalDependencyErrors
```
@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public boolean hasOriginalDependencyErrors()
```
  - getDerivedDependencyErrors
```
@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public List<String> getDerivedDependencyErrors()
```
  - hasDerivedDependencyErrors
```
@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public boolean hasDerivedDependencyErrors()
```
  - setDependents
```
public void setDependents(@NonNull
                          Set<String> dependents)
```
    Set the list of components that depend on this plugin.
    
    Parameters:
    
    dependents - The list of components that depend on this plugin.
  - setDependants
```
@Deprecated
public void setDependants(@NonNull
                                      Set<String> dependents)
```
    Deprecated. Please use setDependents(java.util.Set<java.lang.String>).
  - setOptionalDependents
```
public void setOptionalDependents(@NonNull
                                  Set<String> optionalDependents)
```
    Set the list of components that depend optionally on this plugin.
    
    Parameters:
    
    optionalDependents - The list of components that depend optionally on this plugin.
  - setOptionalDependants
```
@Deprecated
public void setOptionalDependants(@NonNull
                                              Set<String> optionalDependents)
```
    Deprecated. Please use setOptionalDependents(java.util.Set<java.lang.String>).
  - getDependents
```
@NonNull
public Set<String> getDependents()
```
    Get the list of components that depend on this plugin. Note that the list will include elements of getOptionalDependents().
    
    Returns:
    
    The list of components that depend on this plugin.
  - getDependants
```
@Deprecated
 @NonNull
public Set<String> getDependants()
```
    Deprecated. Please use getDependents().
  - getMandatoryDependents
```
@NonNull
public Set<String> getMandatoryDependents()
```
    Like getDependents() but excluding optional dependencies.
    
    Since:
    
    2.181
  - getOptionalDependents
```
@NonNull
public Set<String> getOptionalDependents()
```
    Returns:
    
    The list of components that depend optionally on this plugin.
  - getOptionalDependants
```
@Deprecated
 @NonNull
public Set<String> getOptionalDependants()
```
    Deprecated. Please use getOptionalDependents().
  - hasDependents
```
public boolean hasDependents()
```
    Does this plugin have anything that depends on it. Note that optional dependents are included.
    
    Returns:
    
    true if something (Jenkins core, or another plugin) depends on this plugin, otherwise false.
  - hasMandatoryDependents
```
public boolean hasMandatoryDependents()
```
    Like hasDependents() but excluding optional dependencies.
    
    Since:
    
    2.181
  - hasDependants
```
@Deprecated
public boolean hasDependants()
```
    Deprecated. Please use hasDependents().
  - hasOptionalDependents
```
public boolean hasOptionalDependents()
```
    Does this plugin have anything that depends optionally on it.
    
    Returns:
    
    true if something (Jenkins core, or another plugin) depends optionally on this plugin, otherwise false.
  - hasOptionalDependants
```
@Deprecated
public boolean hasOptionalDependants()
```
    Deprecated. Please use hasOptionalDependents().
  - hasDependencies
```
public boolean hasDependencies()
```
    Does this plugin depend on any other plugins. Note that this include optional dependencies.
    
    Returns:
    
    true if this plugin depends on other plugins, otherwise false.
  - hasMandatoryDependencies
```
public boolean hasMandatoryDependencies()
```
    Like hasDependencies() but omitting optional dependencies.
    
    Since:
    
    2.181
  - isDeprecated
```
@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public boolean isDeprecated()
```
    Is this plugin deprecated?
    
    Returns:
    
    true if and only if an update site reports deprecations for this plugin.
    
    Since:
    
    2.246
  - injectJarsToClasspath
```
@Restricted(value=org.kohsuke.accmod.restrictions.Beta.class)
public void injectJarsToClasspath(File... jars)
                                                                                         throws Exception
```
    Inject the specified jar file(s) to the plugins classpath.
    Warning: This is advanced usage that you should not be needed in 99.9% of all cases, any jar insertion should happen early into the plugins lifecycle to prevent classloading issues in dependent plugins.
    Rather than use this functionality it is to have co-operative behaviour between any consumer of the libraries and load the classes in a separate ClassLoader. you can expose third-party libraries from a dynamic location in various ways, such as:
    - You could split your plugin into two modules:
      
      regular Jenkins plugin code, plus some interface encapsulating access to the lib via a minimal, simplified API
      an implementation of that interface which compiles against a provided static reference copy of the library, and which is packaged in your plugin as a resource (not in WEB-INF/lib/*.jar)
    - with coordination:
      
      dynamically find some JAR(s) on the controller (or perhaps even agent)
      find the bridge JAR in your plugin’s resources area
      create some URLClassLoader loading them both, parented to the plugin ClassLoader
      use reflection to load & instantiate the class of the bridge implementation, casting to the interface from the plugin
    For a concrete example see the database plugin. *
    Throws:
    
    Exception - if the File could not be inserted into the classpath for some reason.
    
    Since:
    
    TODO
  - getDisplayName
```
public String getDisplayName()
```
    Specified by:
    
    getDisplayName in interface ModelObject
  - getApi
```
public Api getApi()
```
  - getIndexPage
```
public URL getIndexPage()
```
    Returns the URL of the index page jelly script.
  - getDependencies
```
@Exported
public List<PluginWrapper.Dependency> getDependencies()
```
    Gets all dependencies of this plugin on other plugins. Note that the list will usually include the members of getOptionalDependencies() (missing optional dependencies will however be omitted).
  - getMandatoryDependencies
```
public List<PluginWrapper.Dependency> getMandatoryDependencies()
```
    Like getDependencies() but omits optional dependencies.
    
    Since:
    
    2.181
  - getOptionalDependencies
```
public List<PluginWrapper.Dependency> getOptionalDependencies()
```
  - getShortName
```
@Exported
public String getShortName()
```
    Returns the short name suitable for URL.
  - getPlugin
```
@CheckForNull
public Plugin getPlugin()
```
    Gets the instance of Plugin contributed by this plugin.
    
    Returns:
    
    Plugin instace or null if it is not present in the plugin instance store.
  - getPluginOrFail
```
@NonNull
public Plugin getPluginOrFail()
                                throws Exception
```
    Gets the instance of Plugin contributed by this plugin.
    
    Throws:
    
    Exception - no plugin in the PluginManager.PluginInstanceStore
  - getUrl
```
@Exported
public String getUrl()
```
    Gets the URL that shows more information about this plugin.
    
    Returns:
    
    null if this information is unavailable.
    
    Since:
    
    1.283
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - getLongName
```
@Exported
 @Deprecated
public String getLongName()
```
    Deprecated. For most purposes, use getDisplayName().
    
    Returns a one-line descriptive name of this plugin.
  - supportsDynamicLoad
```
@Exported
public YesNoMaybe supportsDynamicLoad()
```
    Does this plugin supports dynamic loading?
  - getVersion
```
@Exported
public String getVersion()
```
    Returns the version number of this plugin
  - getRequiredCoreVersion
```
@Exported
 @CheckForNull
public String getRequiredCoreVersion()
```
    Returns the required Jenkins core version of this plugin.
    
    Returns:
    
    the required Jenkins core version of this plugin.
    
    Since:
    
    2.16
  - getMinimumJavaVersion
```
@Exported
 @CheckForNull
public String getMinimumJavaVersion()
```
    Returns the minimum Java version of this plugin, as specified in the plugin metadata. Generally coming from the java.level extracted as MANIFEST's metadata with this addition on the plugins' parent pom.
    
    Since:
    
    2.158
    
    See Also:
    
    maven-hpi-plugin#PR-75
  - getVersionNumber
```
public VersionNumber getVersionNumber()
```
    Returns the version number of this plugin
  - isOlderThan
```
public boolean isOlderThan(VersionNumber v)
```
    Returns true if the version of this plugin is older than the given version.
  - stop
```
public void stop()
```
    Terminates the plugin.
  - releaseClassLoader
```
public void releaseClassLoader()
```
  - enable
```
public void enable()
            throws IOException
```
    Enables this plugin next time Jenkins runs.
    
    Throws:
    
    IOException
  - disable
```
@Deprecated
public void disable()
                         throws IOException
```
    Deprecated.
    
    Disables this plugin next time Jenkins runs. As it doesn't check anything, it's recommended to use the method disable(PluginDisableStrategy)
    
    Throws:
    
    IOException
  - disable
```
@NonNull
public PluginWrapper.PluginDisableResult disable(@NonNull
                                                          PluginWrapper.PluginDisableStrategy strategy)
```
    Disable this plugin using a strategy.
    
    Parameters:
    
    strategy - strategy to use
    
    Returns:
    
    an object representing the result of the disablement of this plugin and its dependents plugins.
  - isActive
```
@Exported
public boolean isActive()
```
    Returns true if this plugin is enabled for this session.
  - hasCycleDependency
```
public boolean hasCycleDependency()
```
  - setHasCycleDependency
```
public void setHasCycleDependency(boolean hasCycle)
```
  - isBundled
```
@Exported
public boolean isBundled()
```
    Is this plugin bundled in the WAR? Normally false as noted in PluginManager.loadBundledPlugins(): this does not apply to “detached” plugins.
  - isEnabled
```
@Exported
public boolean isEnabled()
```
    If true, the plugin is going to be activated next time Jenkins runs.
  - getManifest
```
public Manifest getManifest()
```
  - setPlugin
```
public void setPlugin(Plugin plugin)
```
  - getPluginClass
```
public String getPluginClass()
```
  - hasLicensesXml
```
public boolean hasLicensesXml()
```
  - getUpdateInfo
```
public UpdateSite.Plugin getUpdateInfo()
```
    If the plugin has an update, returns the UpdateSite.Plugin object.
    
    Returns:
    
    This method may return null — for example, the user may have installed a plugin locally developed.
  - getInfo
```
public UpdateSite.Plugin getInfo()
```
    returns the UpdateSite.Plugin object, or null.
  - hasUpdate
```
@Exported
public boolean hasUpdate()
```
    Returns true if this plugin has update in the update center.
    This method is conservative in the sense that if the version number is incomprehensible, it always returns false.
  - isPinned
```
@Exported
 @Deprecated
public boolean isPinned()
```
    Deprecated.
  - isDeleted
```
@Exported
public boolean isDeleted()
```
    Returns true if this plugin is deleted. The plugin continues to function in this session, but in the next session it'll disappear.
  - isDetached
```
@Exported
public boolean isDetached()
```
    Same as DetachedPluginsUtil.isDetachedPlugin(java.lang.String).
    
    Since:
    
    2.185
  - hasImpliedDependents
```
@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public boolean hasImpliedDependents()
```
  - getImpliedDependents
```
@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
 @NonNull
public Set<String> getImpliedDependents()
```
    Get list of implied dependencies.
    
    Since:
    
    2.296
  - compareTo
```
public int compareTo(PluginWrapper pw)
```
    Sort by short name.
    
    Specified by:
    
    compareTo in interface Comparable<PluginWrapper>
  - isDowngradable
```
@Exported
public boolean isDowngradable()
```
    returns true if backup of previous version of plugin exists
  - getBackupFile
```
public File getBackupFile()
```
    Where is the backup file?
  - getBackupVersion
```
@Exported
public String getBackupVersion()
```
    returns the version of the backed up plugin, or null if there's no back up.
  - isPinningForcingOldVersion
```
@Deprecated
public boolean isPinningForcingOldVersion()
```
    Deprecated.
    
    Checks if this plugin is pinned and that's forcing us to use an older version than the bundled one.
  - doMakeEnabled
```
public org.kohsuke.stapler.HttpResponse doMakeEnabled()
                                               throws IOException
```
    Throws:
    
    IOException
  - doMakeDisabled
```
public org.kohsuke.stapler.HttpResponse doMakeDisabled()
                                                throws IOException
```
    Throws:
    
    IOException
  - doPin
```
@Deprecated
public org.kohsuke.stapler.HttpResponse doPin()
                                                   throws IOException
```
    Deprecated.
    
    Throws:
    
    IOException
  - doUnpin
```
@Deprecated
public org.kohsuke.stapler.HttpResponse doUnpin()
                                                     throws IOException
```
    Deprecated.
    
    Throws:
    
    IOException
  - doDoUninstall
```
public org.kohsuke.stapler.HttpResponse doDoUninstall()
                                               throws IOException
```
    Throws:
    
    IOException
  - getActiveWarnings
```
@Restricted(value=org.kohsuke.accmod.restrictions.DoNotUse.class)
public List<UpdateSite.Warning> getActiveWarnings()
```
  - getDeprecations
```
@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public List<UpdateSite.Deprecation> getDeprecations()
```

Class PluginWrapper

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

parent

classLoader

baseResourceURL

NOTICE

MANIFEST_FILENAME

Constructor Detail

PluginWrapper

Method Detail

getDependencyErrors

getOriginalDependencyErrors

hasOriginalDependencyErrors

getDerivedDependencyErrors

hasDerivedDependencyErrors

setDependents

setDependants

setOptionalDependents

setOptionalDependants

getDependents

getDependants

getMandatoryDependents

getOptionalDependents

getOptionalDependants

hasDependents

hasMandatoryDependents

hasDependants

hasOptionalDependents

hasOptionalDependants

hasDependencies

hasMandatoryDependencies

isDeprecated

injectJarsToClasspath

getDisplayName

getApi

getIndexPage

getDependencies

getMandatoryDependencies

getOptionalDependencies

getShortName

getPlugin

getPluginOrFail

getUrl

toString

getLongName

supportsDynamicLoad

getVersion

getRequiredCoreVersion

getMinimumJavaVersion

getVersionNumber

isOlderThan

stop

releaseClassLoader

enable

disable

disable

isActive

hasCycleDependency

setHasCycleDependency

isBundled

isEnabled

getManifest

setPlugin

getPluginClass

hasLicensesXml

getUpdateInfo

getInfo

hasUpdate

isPinned

isDeleted

isDetached

hasImpliedDependents

getImpliedDependents

compareTo

isDowngradable