org.opennms.netmgt.collection.api

Interface CollectionResource

All Superinterfaces:

CollectionVisitable, Persistable, ResourceIdentifier

All Known Implementing Classes:

AbstractCollectionResource, AliasedResource, CollectionResourceWrapper, GenericIndexResource, IfInfo, LatencyCollectionResource, NodeInfo, SnmpCollectionResource

public interface CollectionResource
extends ResourceIdentifier, CollectionVisitable, Persistable

CollectionResource interface.

Version:

$Id: $

Author:

ranger

Field Summary

Fields

Modifier and Type	Field and Description
static String	RESOURCE_TYPE_IF
static String	RESOURCE_TYPE_LATENCY
static String	RESOURCE_TYPE_NODE

Method Summary

Modifier and Type	Method and Description
String	getInstance() Returns the name of the instance this CollectionResource represents.
String	getInterfaceLabel() Returns a unique label for each resource depending on resource type.
ResourcePath	getParent() Returns the name of the parent resource.
String	getResourceTypeName() Returns a string which indicates what type of resource.
TimeKeeper	getTimeKeeper() Returns a not-null TimeKeeper instance when this resource requires to use a special timestamp when updating RRDs/JRBs.
String	getUnmodifiedInstance() Returns the unmodified instance string this CollectionResource represents.
boolean	rescanNeeded() rescanNeeded

Methods inherited from interface org.opennms.netmgt.collection.api.ResourceIdentifier

getOwnerName, getPath

Methods inherited from interface org.opennms.netmgt.collection.api.CollectionVisitable

visit

Methods inherited from interface org.opennms.netmgt.collection.api.Persistable

shouldPersist

Field Detail

RESOURCE_TYPE_NODE

static final String RESOURCE_TYPE_NODE

See Also:

Constant Field Values

RESOURCE_TYPE_IF

static final String RESOURCE_TYPE_IF

See Also:

Constant Field Values

RESOURCE_TYPE_LATENCY

static final String RESOURCE_TYPE_LATENCY

See Also:

Constant Field Values

Method Detail

rescanNeeded

boolean rescanNeeded()

rescanNeeded

Returns:

a boolean.

getResourceTypeName

String getResourceTypeName()

Returns a string which indicates what type of resource. Will be one of "node" for the node level resource "if" for network interface resources "*" for all other resource types defined in the relevant config files, e.g. hrStorage

Returns:

a String object.

getParent

ResourcePath getParent()

Returns the name of the parent resource.

Returns:

a String object.

getInstance

String getInstance()

Returns the name of the instance this CollectionResource represents. For node level resources, this will be null to indicate the default instance. For interface level resources, some label unique to the node (ifIndex probably). For Generic resources (e.g. the SNMP GenericIndexResource), this will be some identifying label, probably the index in the table. This value is used by the StorageStrategy implementations to figure out the label for the resource which is used in constructing its RRD directory.

Returns:

a String object.

getUnmodifiedInstance

String getUnmodifiedInstance()

Returns the unmodified instance string this CollectionResource represents.

Returns:

a String object.

getInterfaceLabel

String getInterfaceLabel()

Returns a unique label for each resource depending on resource type. This label is the same label used when constructing the resource ID.

Returns:

a String object.

getTimeKeeper

TimeKeeper getTimeKeeper()

Returns a not-null TimeKeeper instance when this resource requires to use a special timestamp when updating RRDs/JRBs. If the resource doesn't need a special TimeKeeper it should return null.

Returns:

a TimeKeeper object or null to indicate that DefaultTimeKeeper should be used.