org.opennms.netmgt.model.events

Class EventUtils

java.lang.Object

org.opennms.netmgt.model.events.EventUtils

public abstract class EventUtils
extends Object

Abstract EventUtils class.

Version:

$Id: $

Author:

ranger

Constructor Summary

Constructors

Constructor and Description
EventUtils()

Method Summary

Modifier and Type	Method and Description
static void	checkInterface(Event e) Ensures the given event has an interface
static void	checkInterface(IEvent e)
static void	checkNodeId(Event e) Ensures that the given Event has a node id
static void	checkNodeId(IEvent e)
static void	checkService(Event e) Ensures that the given event has a service parameter
static void	checkService(IEvent e)
static Event	createApplicationDeletedEvent(String source, int applicationId, String applicationName) Constructs a applicationDeleted Event for a given application id and name
static Event	createAssetInfoChangedEvent(String source, long nodeId, long txNo) Construct a deleteNode event for the given nodeId.
static Event	createDeleteInterfaceEvent(String source, long nodeId, String ipAddr, int ifIndex, long txNo) Constructs a deleteInterface event for the given nodeId, ipAddress (or ifIndex) pair.
static Event	createDeleteNodeEvent(String source, long nodeId, long txNo)
static Event	createDeleteServiceEvent(String source, long nodeId, String ipAddr, String service, long txNo) Constructs a deleteService event for the given nodeId, ipAddress, serviceName triple.
static Event	createInterfaceDeletedEvent(String source, int nodeId, InetAddress addr) Construct an interfaceDeleted event for an interface.
static Event	createNodeAddedEvent(String source, int nodeId, String nodeLabel, OnmsNode.NodeLabelSource labelSource) createNodeAddedEvent
static Event	createNodeCategoryMembershipChangedEvent(String source, Integer nodeId, String nodeLabel, String[] categoriesAdded, String[] categoriesDeleted)
static Event	createNodeDeletedEvent(String source, int nodeId, String hostName, String nodeLabel, OnmsMonitoringLocation nodeLocation, String nodeForeignId, String nodeForeignSource, OnmsIpInterface nodePrimaryInterface) This method is responsible for generating a nodeDeleted event and sending it to eventd..
static Event	createNodeGainedInterfaceEvent(String source, int nodeId, InetAddress ifaddr) createNodeGainedInterfaceEvent
static Event	createNodeGainedServiceEvent(String source, int nodeId, InetAddress ifaddr, String service, String nodeLabel, OnmsNode.NodeLabelSource labelSource, String sysName, String sysDescr) createNodeGainedServiceEvent
static Event	createNodeLocationChangedEvent(String source, Integer nodeId, String nodeLabel, String prevLocation, String currentLocation) createNodeLocationChangedEvent
static Event	createNodeUpdatedEvent(String source, Integer nodeId, String nodeLabel, OnmsNode.NodeLabelSource labelSource, String rescanExisting) createNodeUpdatedEvent
static Event	createServiceDeletedEvent(String source, int nodeId, InetAddress addr, String service) Constructs a serviceDeleted Event for the nodeId, ipAddr, serviceName triple
static boolean	eventsMatch(Event e1, Event e2) eventsMatch
static boolean	eventsMatch(IEvent e1, IEvent e2) eventsMatch
static int	getIntParm(Event e, String parmName, int defaultValue) Retrieve the value associated with an event parameter and parse it to an int.
static int	getIntParm(IEvent e, String parmName, int defaultValue)
static long	getLongParm(Event e, String parmName, long defaultValue) Retrieve the value associated with an event parameter and parse it to a long.
static String	getParm(Event e, String parmName) Return the value of an event parameter of null if it does not exist.
static String	getParm(Event e, String parmName, String defaultValue) Retrieve a parameter from and event, returning defaultValue of the parameter is not set.
static String	getParm(IEvent e, String parmName)
static String	getParm(IEvent e, String parmName, String defaultValue)
static boolean	isNonIpInterface(String intf) Is the given interface a non-IP interface
static void	requireParm(Event e, String parmName) Throw an exception if an event does have the required parameter
static void	requireParm(IEvent e, String parmName)
static String	toString(Collection<Parm> parms)
static String	toString(Event event) toString
static String	toString(Snmp snmp) toString
static String	toString(Value value) toString

Methods inherited from class java.lang.Object

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

Constructor Detail

EventUtils

public EventUtils()

Method Detail

createNodeAddedEvent

public static Event createNodeAddedEvent(String source,
                                         int nodeId,
                                         String nodeLabel,
                                         OnmsNode.NodeLabelSource labelSource)

createNodeAddedEvent

Parameters:

source - a String object.

nodeId - a int.

nodeLabel - a String object.

labelSource - a String object.

Returns:

a Event object.

createNodeGainedInterfaceEvent

public static Event createNodeGainedInterfaceEvent(String source,
                                                   int nodeId,
                                                   InetAddress ifaddr)

createNodeGainedInterfaceEvent

Parameters:

source - a String object.

nodeId - a int.

ifaddr - a InetAddress object.

Returns:

a Event object.

createNodeGainedServiceEvent

public static Event createNodeGainedServiceEvent(String source,
                                                 int nodeId,
                                                 InetAddress ifaddr,
                                                 String service,
                                                 String nodeLabel,
                                                 OnmsNode.NodeLabelSource labelSource,
                                                 String sysName,
                                                 String sysDescr)

createNodeGainedServiceEvent

Parameters:

source - a String object.

nodeId - a int.

ifaddr - a InetAddress object.

service - a String object.

nodeLabel - a String object.

labelSource - a String object.

sysName - a String object.

sysDescr - a String object.

Returns:

a Event object.

createNodeDeletedEvent

public static Event createNodeDeletedEvent(String source,
                                           int nodeId,
                                           String hostName,
                                           String nodeLabel,
                                           OnmsMonitoringLocation nodeLocation,
                                           String nodeForeignId,
                                           String nodeForeignSource,
                                           OnmsIpInterface nodePrimaryInterface)

This method is responsible for generating a nodeDeleted event and sending it to eventd..

Parameters:

source - A string representing the source of the event

nodeId - Nodeid of the node got deleted.

hostName - the Host server name.

nodeLabel - the node label of the deleted node.

Returns:

a Event object.

createInterfaceDeletedEvent

public static Event createInterfaceDeletedEvent(String source,
                                                int nodeId,
                                                InetAddress addr)

Construct an interfaceDeleted event for an interface.

Parameters:

source - the source of the event

nodeId - the nodeId of the node the interface resides in

ipAddr - the ipAdddr of the event

Returns:

an Event represent an interfaceDeleted event for the given interface

createServiceDeletedEvent

public static Event createServiceDeletedEvent(String source,
                                              int nodeId,
                                              InetAddress addr,
                                              String service)

Constructs a serviceDeleted Event for the nodeId, ipAddr, serviceName triple

Parameters:

source - the source of the event

nodeId - the nodeId that the service resides on

ipAddr - the interface that the service resides on

service - the name of the service that was deleted

Returns:

an Event that represents the serviceDeleted event for the give triple

createApplicationDeletedEvent

public static Event createApplicationDeletedEvent(String source,
                                                  int applicationId,
                                                  String applicationName)

Constructs a applicationDeleted Event for a given application id and name

Parameters:

source - the source of the event

applicationId - the id of the deleted application

applicationName - the name of the deleted application

Returns:

an Event that represents the applicationDeleted event for the given id and name

getLongParm

public static long getLongParm(Event e,
                               String parmName,
                               long defaultValue)

Retrieve the value associated with an event parameter and parse it to a long. If the value can not be found, return a default value.

Parameters:

e - the Event to retrieve the parameter from

parmName - the name of the parameter to retrieve

defaultValue - the value to return if the paramter can not be retrieved or parsed

Returns:

the value of the parameter as a long

getIntParm

public static int getIntParm(Event e,
                             String parmName,
                             int defaultValue)

Retrieve the value associated with an event parameter and parse it to an int. If the value can not be found, return a default value.

Parameters:

e - the Event to retrieve the parameter from

parmName - the name of the parameter to retrieve

defaultValue - the value to return if the paramter can not be retrieved or parsed

Returns:

the value of the parameter as a long

getParm

public static String getParm(Event e,
                             String parmName,
                             String defaultValue)

Retrieve a parameter from and event, returning defaultValue of the parameter is not set.

Parameters:

e - The Event to retrieve the parameter from

parmName - the name of the parameter to retrieve

defaultValue - the default value to return if the parameter is not set

Returns:

the value of the parameter, or defalutValue if the parameter is not set

getParm

public static String getParm(Event e,
                             String parmName)

Return the value of an event parameter of null if it does not exist.

Parameters:

e - the Event to get the parameter for

parmName - the name of the parameter to retrieve

Returns:

the value of the parameter, or null of the parameter is not set

createNodeUpdatedEvent

public static Event createNodeUpdatedEvent(String source,
                                           Integer nodeId,
                                           String nodeLabel,
                                           OnmsNode.NodeLabelSource labelSource,
                                           String rescanExisting)

createNodeUpdatedEvent

Parameters:

source - a String object.

nodeId - a Integer object.

nodeLabel - a String object.

labelSource - a String object.

rescanExisting - a String object.

Returns:

a Event object.

createNodeLocationChangedEvent

public static Event createNodeLocationChangedEvent(String source,
                                                   Integer nodeId,
                                                   String nodeLabel,
                                                   String prevLocation,
                                                   String currentLocation)

createNodeLocationChangedEvent

Parameters:

source - a String object.

nodeId - a Integer object.

nodeLabel - a String object.

prevLocation - a String object.

currentLocation - a String object.

Returns:

a Event object.

createNodeCategoryMembershipChangedEvent

public static Event createNodeCategoryMembershipChangedEvent(String source,
                                                             Integer nodeId,
                                                             String nodeLabel,
                                                             String[] categoriesAdded,
                                                             String[] categoriesDeleted)

toString

public static String toString(Event event)

toString

Parameters:

event - a Event object.

Returns:

a String object.

toString

public static String toString(Collection<Parm> parms)

toString

public static String toString(Value value)

toString

Parameters:

value - a Value object.

Returns:

a String object.

toString

public static String toString(Snmp snmp)

toString

Parameters:

snmp - a Snmp object.

Returns:

a String object.

eventsMatch

public static boolean eventsMatch(Event e1,
                                  Event e2)

eventsMatch

Parameters:

e1 - a Event object.

e2 - a Event object.

Returns:

a boolean.

eventsMatch

public static boolean eventsMatch(IEvent e1,
                                  IEvent e2)

eventsMatch

Parameters:

e1 - a IEvent object.

e2 - a IEvent object.

Returns:

a boolean.

checkInterface

public static void checkInterface(Event e)
                           throws InsufficientInformationException

Ensures the given event has an interface

Parameters:

e - the event

Throws:

org.opennms.netmgt.capsd.InsufficientInformationException - if an interface is not available

InsufficientInformationException

isNonIpInterface

public static boolean isNonIpInterface(String intf)

Is the given interface a non-IP interface

Parameters:

intf - the interface

Returns:

true/false

checkNodeId

public static void checkNodeId(Event e)
                        throws InsufficientInformationException

Ensures that the given Event has a node id

Parameters:

e - the event

Throws:

org.opennms.netmgt.capsd.InsufficientInformationException - if a node id is not available

InsufficientInformationException

checkService

public static void checkService(Event e)
                         throws InsufficientInformationException

Ensures that the given event has a service parameter

Parameters:

e - the event to check

Throws:

org.opennms.netmgt.capsd.InsufficientInformationException - if the event does not have a service

InsufficientInformationException

createDeleteInterfaceEvent

public static Event createDeleteInterfaceEvent(String source,
                                               long nodeId,
                                               String ipAddr,
                                               int ifIndex,
                                               long txNo)

Constructs a deleteInterface event for the given nodeId, ipAddress (or ifIndex) pair.

Parameters:

source - the source for the event

nodeId - the nodeId of the node that owns the interface

ipAddr - the ipAddress of the interface being deleted

ifIndex - the ifIndex of the interface being deleted

txNo - the transaction number to use for processing this event

Returns:

an Event representing a deleteInterface event for the given nodeId, ipaddr

createDeleteNodeEvent

public static Event createDeleteNodeEvent(String source,
                                          long nodeId,
                                          long txNo)

createAssetInfoChangedEvent

public static Event createAssetInfoChangedEvent(String source,
                                                long nodeId,
                                                long txNo)

Construct a deleteNode event for the given nodeId.

Parameters:

source - the source for the event

nodeId - the node to be deleted.

txNo - the transaction number associated with deleting the node

Returns:

an Event object representing a delete node event.

createDeleteServiceEvent

public static Event createDeleteServiceEvent(String source,
                                             long nodeId,
                                             String ipAddr,
                                             String service,
                                             long txNo)

Constructs a deleteService event for the given nodeId, ipAddress, serviceName triple.

Parameters:

source - the source for the event

nodeId - the nodeId of the node that service resides on

ipAddr - the ipAddress of the interface the service resides on

service - the service that is being deleted

txNo - the transaction number to use for processing this event

Returns:

an Event representing a deleteInterface event for the given nodeId, ipaddr

requireParm

public static void requireParm(Event e,
                               String parmName)
                        throws InsufficientInformationException

Throw an exception if an event does have the required parameter

Parameters:

e - the event the parameter must reside on

parmName - a String object.

Throws:

org.opennms.netmgt.capsd.InsufficientInformationException - if the paramter is not set on the event or if its value has no content

InsufficientInformationException

getParm

public static String getParm(IEvent e,
                             String parmName)

getParm

public static String getParm(IEvent e,
                             String parmName,
                             String defaultValue)

requireParm

public static void requireParm(IEvent e,
                               String parmName)
                        throws InsufficientInformationException

Throws:

InsufficientInformationException

checkInterface

public static void checkInterface(IEvent e)
                           throws InsufficientInformationException

Throws:

InsufficientInformationException

checkNodeId

public static void checkNodeId(IEvent e)
                        throws InsufficientInformationException

Throws:

InsufficientInformationException

checkService

public static void checkService(IEvent e)
                         throws InsufficientInformationException

Throws:

InsufficientInformationException

getIntParm

public static int getIntParm(IEvent e,
                             String parmName,
                             int defaultValue)