org.rhq.core.pluginapi.inventory

Interface ResourceDiscoveryCallback

public interface ResourceDiscoveryCallback

When another discovery component discovers resources, the discovered details can be funneled through implementations of this callback interface, thus allowing callbacks to tweek details of discovered resources. This is helpful, for example, when one plugin wants to alter the name or description of some other plugin's resource type. This is mainly used when writing plugins that cooperate with each other.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ResourceDiscoveryCallback.DiscoveryCallbackResults

Method Summary

Methods

Modifier and Type	Method and Description
ResourceDiscoveryCallback.DiscoveryCallbackResults	discoveredResources(DiscoveredResourceDetails discoveredDetails) When a resource has been discovered, its discovered resource details are passed to the callback via this method.

Method Detail

discoveredResources

ResourceDiscoveryCallback.DiscoveryCallbackResults discoveredResources(DiscoveredResourceDetails discoveredDetails)
                                                                       throws Exception

When a resource has been discovered, its discovered resource details are passed to the callback via this method. The callback can tweek those details as it sees fit or it can simply leave the details as-is and simply return.

Parameters:

discoveredDetails - resource details that were discovered and can be altered by the callback

Returns:

PROCESSED if the callback has identified the discovered resource and possibly altered the details. VETO if the callback determines that the resource should not go into inventory and these details should be skipped by the plugin container. Otherwise, return UNPROCESSED to let the plugin container know that this callback doesn't recognize the details and they were left as-is. A null return value will be equivalent to UNPROCESSED.

Throws:

Exception