Package hudson

Class ClassicPluginStrategy

java.lang.Object

hudson.ClassicPluginStrategy

All Implemented Interfaces:

ExtensionPoint, PluginStrategy

public class ClassicPluginStrategy
extends Object
implements PluginStrategy

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor	Description
ClassicPluginStrategy(PluginManager pluginManager)

Method Summary

Modifier and Type	Method	Description
protected ClassLoader	createClassLoader(String name, List<File> paths, ClassLoader parent, Attributes atts)	Creates a classloader that can load all the specified jar files and delegate to the given parent.
protected ClassLoader	createClassLoader(List<File> paths, ClassLoader parent)	Deprecated. since 2.459 use createClassLoader(String, List, ClassLoader, Attributes)
protected ClassLoader	createClassLoader(List<File> paths, ClassLoader parent, Attributes atts)	Deprecated. since 2.459 use createClassLoader(String, List, ClassLoader, Attributes)
PluginWrapper	createPluginWrapper(File archive)	Creates a plugin wrapper, which provides a management interface for the plugin
<T> List<ExtensionComponent<T>>	findComponents(Class<T> type, Hudson hudson)	Find components of the given type using the assigned strategy.
static List<PluginWrapper.Dependency>	getImpliedDependencies(String pluginName, String jenkinsVersion)	Deprecated. since 2.163
String	getShortName(File archive)	Finds the plugin name without actually unpacking anything PluginStrategy.createPluginWrapper(java.io.File) would.
void	initializeComponents(PluginWrapper plugin)	Optionally start services provided by the plugin.
void	load(PluginWrapper wrapper)	Loads the plugin and starts it.
void	startPlugin(PluginWrapper plugin)
void	updateDependency(PluginWrapper depender, PluginWrapper dependee)	Called when a plugin is installed, but there was already a plugin installed which optionally depended on that plugin.

Methods inherited from class java.lang.Object

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

Constructor Details

ClassicPluginStrategy

public ClassicPluginStrategy(PluginManager pluginManager)

Method Details

getShortName

public String getShortName(File archive)
                    throws IOException

Description copied from interface: PluginStrategy

Finds the plugin name without actually unpacking anything PluginStrategy.createPluginWrapper(java.io.File) would. Needed by PluginManager.dynamicLoad(java.io.File) to decide whether such a plugin is already installed.

Specified by:

getShortName in interface PluginStrategy

Returns:

the PluginWrapper.getShortName()

Throws:

IOException

createPluginWrapper

public PluginWrapper createPluginWrapper(File archive)
                                  throws IOException

Description copied from interface: PluginStrategy

Creates a plugin wrapper, which provides a management interface for the plugin

Specified by:

createPluginWrapper in interface PluginStrategy

Parameters:

archive - Either a directory that points to a pre-exploded plugin, or an jpi file, or an jpl file.

Throws:

IOException

getImpliedDependencies

@Deprecated
@NonNull
public static List<PluginWrapper.Dependency> getImpliedDependencies(String pluginName,
 String jenkinsVersion)

Deprecated.

since 2.163

See Also:

• DetachedPluginsUtil.getImpliedDependencies(String, String)

createClassLoader

@Deprecated(since="2.459")
protected ClassLoader createClassLoader(List<File> paths,
 ClassLoader parent)
                                 throws IOException

Deprecated.

since 2.459 use createClassLoader(String, List, ClassLoader, Attributes)

Throws:

IOException

createClassLoader

@Deprecated(since="2.459")
protected ClassLoader createClassLoader(List<File> paths,
 ClassLoader parent,
 Attributes atts)
                                 throws IOException

Deprecated.

since 2.459 use createClassLoader(String, List, ClassLoader, Attributes)

Throws:

IOException

createClassLoader

protected ClassLoader createClassLoader(String name,
 List<File> paths,
 ClassLoader parent,
 Attributes atts)
                                 throws IOException

Creates a classloader that can load all the specified jar files and delegate to the given parent.

Throws:

IOException

Since:

2.459

initializeComponents

public void initializeComponents(PluginWrapper plugin)

Description copied from interface: PluginStrategy

Optionally start services provided by the plugin. Should be called when all plugins are loaded.

Specified by:

initializeComponents in interface PluginStrategy

findComponents

public <T> List<ExtensionComponent<T>> findComponents(Class<T> type,
 Hudson hudson)

Description copied from interface: PluginStrategy

Find components of the given type using the assigned strategy.

Specified by:

findComponents in interface PluginStrategy

Parameters:

type - The component type

hudson - The Hudson scope

Returns:

Sequence of components

load

public void load(PluginWrapper wrapper)
          throws IOException

Description copied from interface: PluginStrategy

Loads the plugin and starts it.

This should be done after all the classloaders are constructed for all the plugins, so that dependencies can be properly loaded by plugins.

Specified by:

load in interface PluginStrategy

Throws:

IOException

startPlugin

public void startPlugin(PluginWrapper plugin)
                 throws Exception

Throws:

Exception

updateDependency

public void updateDependency(PluginWrapper depender,
 PluginWrapper dependee)

Description copied from interface: PluginStrategy

Called when a plugin is installed, but there was already a plugin installed which optionally depended on that plugin. The class loader of the existing depending plugin should be updated to load classes from the newly installed plugin.

Specified by:

updateDependency in interface PluginStrategy

Parameters:

depender - plugin depending on dependee.

dependee - newly loaded plugin.