org.rhq.core.pluginapi.upgrade
Interface ResourceUpgradeFacet<T extends ResourceComponent<?>>

public interface ResourceUpgradeFacet<T extends ResourceComponent<?>>

This interface is to be implemented by discovery classes if they want to support upgrading the existing resources to a new format needed by an updated resource component. This is useful for example in the case when a new version of plugin redefined a resource key generation algorithm and wants to upgrade the legacy resources to use the new format.

Method Summary

ResourceUpgradeReport

upgrade(ResourceUpgradeContext<T> inventoriedResource) Specifies what data should change on the provided resource to upgrade it to the current version.

Method Detail

upgrade

ResourceUpgradeReport upgrade(ResourceUpgradeContext<T> inventoriedResource)

Specifies what data should change on the provided resource to upgrade it to the current version.

Parameters:

inventoriedResource - a context representing the resource to be upgraded

Returns:

a report specifying what aspects of the resource should be changed or null if there is nothing to upgrade