PluginWrapper (Jenkins core 2.163 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 dependants 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.
`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()` Get the list of components that depend on this plugin.
`List<PluginWrapper.Dependency>`	`getDependencies()`
`List<String>`	`getDependencyErrors()`
`List<String>`	`getDerivedDependencyErrors()`
`String`	`getDisplayName()`
`URL`	`getIndexPage()` Returns the URL of the index page jelly script.
`UpdateSite.Plugin`	`getInfo()` returns the `UpdateSite.Plugin` object, or null.
`String`	`getLongName()` Returns a one-line descriptive name of this plugin.
`Manifest`	`getManifest()`
`String`	`getMinimumJavaVersion()` Returns the minimum Java version of this plugin, as specified in the plugin metadata.
`Set<String>`	`getOptionalDependants()`
`List<PluginWrapper.Dependency>`	`getOptionalDependencies()`
`List<String>`	`getOriginalDependencyErrors()`
`Plugin`	`getPlugin()` Gets the instance of `Plugin` contributed by this plugin.
`String`	`getPluginClass()`
`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()` Does this plugin have anything that depends on it.
`boolean`	`hasDependencies()` Does this plugin depend on any other plugins.
`boolean`	`hasDerivedDependencyErrors()`
`boolean`	`hasLicensesXml()`
`boolean`	`hasOptionalDependants()` 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.
`boolean`	`isActive()` Returns true if this plugin is enabled for this session.
`boolean`	`isBundled()`
`boolean`	`isDeleted()` Returns true if this plugin is deleted.
`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> dependants)` Set the list of components that depend on this plugin.
`void`	`setHasCycleDependency(boolean hasCycle)`
`void`	`setOptionalDependants(Set<String> optionalDependants)` 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()
```
  - setDependants
```
public void setDependants(@Nonnull
                          Set<String> dependants)
```
    Set the list of components that depend on this plugin.
    
    Parameters:
    
    dependants - The list of components that depend on this plugin.
  - setOptionalDependants
```
public void setOptionalDependants(@Nonnull
                                  Set<String> optionalDependants)
```
    Set the list of components that depend optionally on this plugin.
    
    Parameters:
    
    optionalDependants - The list of components that depend optionally on this plugin.
  - getDependants
```
@Nonnull
public Set<String> getDependants()
```
    Get the list of components that depend on this plugin.
    
    Returns:
    
    The list of components that depend on this plugin.
  - getOptionalDependants
```
@Nonnull
public Set<String> getOptionalDependants()
```
    Returns:
    
    The list of components that depend optionally on this plugin.
  - hasDependants
```
public boolean hasDependants()
```
    Does this plugin have anything that depends on it.
    
    Returns:
    
    true if something (Jenkins core, or another plugin) depends on this plugin, otherwise false.
  - hasOptionalDependants
```
public boolean hasOptionalDependants()
```
    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.
  - hasDependencies
```
public boolean hasDependencies()
```
    Does this plugin depend on any other plugins.
    
    Returns:
    
    true if this plugin depends on other plugins, otherwise false.
  - 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()
```
  - 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.
  - 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
public String getLongName()
```
    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:
    
    TODO
    
    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 dependants 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()
```
  - 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.
  - 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

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

setDependants

setOptionalDependants

getDependants

getOptionalDependants

hasDependants

hasOptionalDependants

hasDependencies

getDisplayName

getApi

getIndexPage

getDependencies

getOptionalDependencies

getShortName

getPlugin

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

compareTo

isDowngradable

getBackupFile

getBackupVersion

isPinningForcingOldVersion

doMakeEnabled

doMakeDisabled

doPin

doUnpin

doDoUninstall