com.atlassian.plugin
Interface RevertablePluginInstaller

All Superinterfaces:

PluginInstaller

All Known Implementing Classes:

FilePluginInstaller

public interface RevertablePluginInstaller
extends PluginInstaller

A type of PluginInstaller that supports reverting plugin artifacts installed during the current running. Specifically, it is used during upgrades of plugins that use modules that require a restart, and therefore, is of no use to environments that have no such descriptors. Only plugins that were installed while the current instance has existed are eligible to be reverted. In other words, no state is persisted across restarts.

Since:

2.5.0

Method Summary

void	clearBackups() Clears any backed up artifacts from the previous run.
void	revertInstalledPlugin(java.lang.String pluginKey) Reverts a plugin artifact that was installed to its original state.

Methods inherited from interface com.atlassian.plugin.PluginInstaller

installPlugin

Method Detail

revertInstalledPlugin

void revertInstalledPlugin(java.lang.String pluginKey)

Reverts a plugin artifact that was installed to its original state. If the artifact had already existed before it was upgraded, the old artifact should be returned to its place. If the artifact hadn't existed previously, then the installed plugin artifact should just be deleted. Calling this method after multiple installs or upgrades for a given plugin key during an instance will simple restore the original artifact, if any.

Parameters:

pluginKey - The plugin key to revert

clearBackups

void clearBackups()

Clears any backed up artifacts from the previous run.