org.opennms.netmgt.utils

Class NodeLabelJDBCImpl

java.lang.Object

org.opennms.netmgt.utils.NodeLabelJDBCImpl

All Implemented Interfaces:

NodeLabel

public class NodeLabelJDBCImpl
extends Object
implements NodeLabel

This class contains convenience functions for retrieving and modifying the label associated with a managed node. The 'node' table contains a 'nodelabel' and 'nodelabelsource' field. The 'nodelabel' is a user-friendly name associated with the node. This name can be user-defined (via the WEB UI) or can be auto-generated based on what OpenNMS knows about the node and its interfaces. The 'nodelabelsource' field is a single character flag which indicates what the source for the node label was.

 Valid values for node label source are: 'U' User defined 'H' Primary
 interface's IP host name 'S' Node's MIB-II sysName 'A' Primary interface's IP
 address

 

Author:

Mike , OpenNMS

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_NODE_LABEL_LENGTH Maximum length for node label
static String	PROP_PRIMARY_INTERFACE_SELECT_METHOD The property string in the properties file which specifies the method to use for determining which interface is primary on a multi-interface box.

Constructor Summary

Constructors

Constructor and Description
NodeLabelJDBCImpl() Default constructor
NodeLabelJDBCImpl(String nodeLabel, OnmsNode.NodeLabelSource nodeLabelSource) Constructor

Method Summary

Methods

Modifier and Type	Method and Description
void	assignLabel(int nodeID, NodeLabelJDBCImpl nodeLabel) Deprecated. Use a NodeDao#update(org.opennms.netmgt.model.OnmsNode) method call instead
void	assignLabel(int nodeID, NodeLabelJDBCImpl nodeLabel, Connection dbConnection) Deprecated. Use a NodeDao#update(org.opennms.netmgt.model.OnmsNode) method call instead
NodeLabelJDBCImpl	computeLabel(int nodeID) Deprecated. Update this to use modern DAO methods instead of raw SQL
NodeLabelJDBCImpl	computeLabel(int nodeID, Connection dbConnection) Deprecated. Update this to use modern DAO methods instead of raw SQL
static NodeLabel	getInstance()
String	getLabel() Returns the node label .
OnmsNode.NodeLabelSource	getSource() Returns the node label source flag .
NodeLabelJDBCImpl	retrieveLabel(int nodeID) Deprecated. Use a NodeDao#load(Integer) method call instead
NodeLabelJDBCImpl	retrieveLabel(int nodeID, Connection dbConnection) Deprecated. Use a NodeDao#load(Integer) method call instead
String	toString() This method is responsible for returning a String object which represents the content of this NodeLabel.

Methods inherited from class java.lang.Object

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

Field Detail

MAX_NODE_LABEL_LENGTH

public static final int MAX_NODE_LABEL_LENGTH

Maximum length for node label

See Also:

Constant Field Values

PROP_PRIMARY_INTERFACE_SELECT_METHOD

public static final String PROP_PRIMARY_INTERFACE_SELECT_METHOD

The property string in the properties file which specifies the method to use for determining which interface is primary on a multi-interface box.

See Also:

Constant Field Values

Constructor Detail

NodeLabelJDBCImpl

public NodeLabelJDBCImpl()

Default constructor

NodeLabelJDBCImpl

public NodeLabelJDBCImpl(String nodeLabel,
                 OnmsNode.NodeLabelSource nodeLabelSource)

Constructor

Parameters:

nodeLabel - Node label

nodeLabelSource - Flag indicating source of node label

Method Detail

getInstance

public static NodeLabel getInstance()

getLabel

public String getLabel()

Returns the node label .

Specified by:

getLabel in interface NodeLabel

Returns:

node label

getSource

public OnmsNode.NodeLabelSource getSource()

Returns the node label source flag .

Specified by:

getSource in interface NodeLabel

Returns:

node label source flag

retrieveLabel

public NodeLabelJDBCImpl retrieveLabel(int nodeID)
                                throws SQLException

Deprecated. Use a NodeDao#load(Integer) method call instead

This method queries the 'node' table for the value of the 'nodelabel' and 'nodelabelsource' fields for the node with the provided nodeID. A NodeLabel object is returned initialized with the retrieved values. WARNING: A properly instantiated and initialized Vault class object is required prior to calling this method. This method will initially only be called from the WEB UI.

Specified by:

retrieveLabel in interface NodeLabel

Parameters:

nodeID - Unique identifier of the node to be updated.

Returns:

Object containing label and source values.

Throws:

SQLException - if any.

retrieveLabel

public NodeLabelJDBCImpl retrieveLabel(int nodeID,
                              Connection dbConnection)
                                throws SQLException

Deprecated. Use a NodeDao#load(Integer) method call instead

This method queries the 'node' table for the value of the 'nodelabel' and 'nodelabelsource' fields for the node with the provided nodeID. A NodeLabel object is returned initialized with the retrieved values.

Specified by:

retrieveLabel in interface NodeLabel

Parameters:

nodeID - Unique ID of node whose label info is to be retrieved

dbConnection - SQL database connection

Returns:

object initialized with node label & source flag

Throws:

SQLException - if any.

assignLabel

public void assignLabel(int nodeID,
               NodeLabelJDBCImpl nodeLabel)
                 throws SQLException

Deprecated. Use a NodeDao#update(org.opennms.netmgt.model.OnmsNode) method call instead

This method updates the 'nodelabel' and 'nodelabelsource' fields of the 'node' table for the specified nodeID. A database connection is retrieved from the Vault. WARNING: A properly instantiated and initialized Vault class object is required prior to calling this method. This method will initially only be called from the WEB UI.

Specified by:

assignLabel in interface NodeLabel

Parameters:

nodeID - Unique identifier of the node to be updated.

nodeLabel - Object containing label and source values.

Throws:

SQLException - if any.

assignLabel

public void assignLabel(int nodeID,
               NodeLabelJDBCImpl nodeLabel,
               Connection dbConnection)
                 throws SQLException

Deprecated. Use a NodeDao#update(org.opennms.netmgt.model.OnmsNode) method call instead

This method updates the 'nodelabel' and 'nodelabelsource' fields of the 'node' table for the specified nodeID. If nodeLabel parameter is NULL the method will first call computeLabel() and use the resulting NodeLabel object to update the database.

Specified by:

assignLabel in interface NodeLabel

Parameters:

nodeID - Unique identifier of the node to be updated.

nodeLabel - Object containing label and source values.

dbConnection - SQL database connection

Throws:

SQLException - if any.

computeLabel

public NodeLabelJDBCImpl computeLabel(int nodeID)
                               throws SQLException

Deprecated. Update this to use modern DAO methods instead of raw SQL

This method determines what label should be associated with a particular node. A database connection is retrieved from the Vault. WARNING: A properly instantiated and initialized Vault class object is required prior to calling this method. This method will initially only be called from the WEB UI.

Specified by:

computeLabel in interface NodeLabel

Parameters:

nodeID - Unique identifier of the node to be updated.

Returns:

NodeLabel Object containing label and source values

Throws:

SQLException - if any.

computeLabel

public NodeLabelJDBCImpl computeLabel(int nodeID,
                             Connection dbConnection)
                               throws SQLException

Deprecated. Update this to use modern DAO methods instead of raw SQL

This method determines what label should be associated with a particular node. Algorithm for determining a node's label is as follows: 1) If node has a NetBIOS name associated with it, the NetBIOS name is used as the node's label. 2) If no NetBIOS name available, retrieve all the 'ipinterface' table entries associated with the node with an 'isManaged' field value of 'M' 3) Find the primary interface where "primary" is defined as the managed interface with the smallest IP address (each IP address is converted to an integer value -- the IP address with the smallest integer value wins). 4) IF the primary interface's IP host name is known it becomes the node's label. ELSE IF the node's MIB-II sysName value is known it becomes the node's label ELSE the primary interface's IP address becomes the node's label. NOTE: If for some reason a node has no "managed" interfaces null is returned for the NodeLabel.

Specified by:

computeLabel in interface NodeLabel

Parameters:

nodeID - Unique identifier of the node to be updated.

dbConnection - SQL database connection

Returns:

NodeLabel Object containing label and source values or null if node does not have a primary interface.

Throws:

SQLException - if any.

toString

public String toString()

This method is responsible for returning a String object which represents the content of this NodeLabel. Primarily used for debugging purposes.

Specified by:

toString in interface NodeLabel

Overrides:

toString in class Object

Returns:

String which represents the content of this NodeLabel