AbstractEventUtil (OpenNMS 14.0.0 API)

java.lang.Object
- org.opennms.netmgt.eventd.AbstractEventUtil

All Implemented Interfaces:

EventUtil

Direct Known Subclasses:

EventUtilDaoImpl, EventUtilJdbcImpl
```
public abstract class AbstractEventUtil
extends Object
implements EventUtil
```
EventUtil is used primarily for the event parm expansion - has methods used by all the event components to send in the event and the element to expanded and have the 'expanded' value sent back

Author:

Sowmya Kumaraswamy , Brain Weaver , OpenNMS

Field Summary

Fields
Modifier and Type	Field and Description
`protected static String`	`ASSET_BEGIN` The string that starts the expansion for an asset field - used to lookup values of asset fields by their names
`protected static String`	`ASSET_END_SUFFIX` The string that ends the expansion of a parm
`protected static char`	`ATTRIB_DELIM` The values and the corresponding attributes of an element are added delimited by ATTRIB_DELIM
`protected static char`	`NAME_VAL_DELIM` For expansion of the '%parms[all]%' - the parm name and value are added as delimiter separated list of ' = ' strings
`protected static String`	`NUM_PARMS_STR` The string that should be expanded to the number of parms
`protected static String`	`PARM_BEGIN` The string that starts the expansion for a parm - used to lookup values of parameters by their names
`protected static int`	`PARM_BEGIN_LENGTH` The length of PARM_BEGIN
`protected static String`	`PARM_END_SUFFIX` The string that ends the expansion of a parm
`protected static String`	`PARM_NAME_NUMBERED_PREFIX` The string that starts a request for the name of a numbered parm
`protected static int`	`PARM_NAME_NUMBERED_PREFIX_LENGTH` The length of PARM_NAME_NUMBERED_PREFIX
`protected static String`	`PARM_NUM_PREFIX` The string that starts a parm number - used to lookup values of parameters by their position
`protected static int`	`PARM_NUM_PREFIX_LENGTH` The length of PARM_NUM_PREFIX
`protected static String`	`PARMS_ALL` The string that should be expanded to a list of all parms
`protected static String`	`PARMS_NAMES` The string that should be expanded to a list of all parm names
`protected static String`	`PARMS_VALUES` The string that should be expanded to a list of all parm values
`protected static char`	`PERCENT` The '%' sign used to indicate parms to be expanded
`protected static char`	`SPACE_DELIM`
`protected static String`	`TAG_DESCR` The event descr xml tag
`protected static String`	`TAG_DPNAME` The event dpname xml tag
`protected static String`	`TAG_EVENT_DB_ID` The Event ID xml
`protected static String`	`TAG_HOST` The event host xml tag
`protected static String`	`TAG_IFALIAS` The reverse DNS lookup of the interface
`protected static String`	`TAG_IFINDEX` The event ifindex xml tag
`protected static String`	`TAG_INTERFACE` The event interface xml tag
`protected static String`	`TAG_INTERFACE_RESOLVE` The reverse DNS lookup of the interface
`protected static String`	`TAG_LOGMSG` The event logmsg xml tag
`protected static String`	`TAG_MOUSEOVERTEXT` The event mouseovertext xml tag
`protected static String`	`TAG_NODEID` The event nodeid xml tag
`protected static String`	`TAG_NODELABEL` The event nodelabel xml tag
`protected static String`	`TAG_OPERINSTR` The event operinstruct xml tag
`protected static String`	`TAG_PERCENT_SIGN` Substitute the actual percent sign
`protected static String`	`TAG_SERVICE` The event service xml tag
`protected static String`	`TAG_SEVERITY` The event severity xml tag
`protected static String`	`TAG_SHORT_TIME` The event time xml tag, short format
`protected static String`	`TAG_SNMP` The SNMP xml tag
`protected static String`	`TAG_SNMP_COMMUNITY` The event snmp community xml tag
`protected static String`	`TAG_SNMP_GENERIC` The event snmp generic xml tag
`protected static String`	`TAG_SNMP_ID` The event snmp id xml tag
`protected static String`	`TAG_SNMP_IDTEXT` The event snmp idtext xml tag
`protected static String`	`TAG_SNMP_SPECIFIC` The event snmp specific xml tag
`protected static String`	`TAG_SNMP_VERSION` The event snmp version xml tag
`protected static String`	`TAG_SNMPHOST` The event snmp host xml tag
`protected static String`	`TAG_SOURCE` The event source xml tag
`protected static String`	`TAG_TIME` The event time xml tag
`protected static Object`	`TAG_TTICKET_ID`
`protected static String`	`TAG_UEI` The UEI xml tag

Constructor Summary

Constructors
Constructor and Description

AbstractEventUtil()

Constructors
Constructor and Description
`AbstractEventUtil()`

Method Summary

Methods
Modifier and Type	Method and Description
`static String`	`escape(String inStr, char delimchar)` This method is used to escape required values from strings that may contain those values.
`void`	`expandMapValues(Map<String,String> map, Event event)` expandMapValues
`String`	`expandParms(String inp, Event event)` Expand the value if it has parms in one of the following formats - %element% values are expanded to have the value of the element where 'element' is an element in the event DTD - %parm[values-all]% is expanded to a delimited list of all parmblock values - %parm[names-all]% is expanded to a list of all parm names - %parm[all]% is expanded to a full dump of all parmblocks - %parm[name]% is expanded to the value of the parameter named 'name' - %parm[ ]% is replaced by the value of the parameter named 'name', if present - %parm[# ]% is replaced by the value of the parameter number 'num', if present - %parm[##]% is replaced by the number of parameters
`String`	`expandParms(String inp, Event event, Map<String,Map<String,String>> decode)` Expand the value if it has parms in one of the following formats - %element% values are expanded to have the value of the element where 'element' is an element in the event DTD - %parm[values-all]% is expanded to a delimited list of all parmblock values - %parm[names-all]% is expanded to a list of all parm names - %parm[all]% is expanded to a full dump of all parmblocks - %parm[name]% is expanded to the value of the parameter named 'name' - %parm[ ]% is replaced by the value of the parameter named 'name', if present - %parm[# ]% is replaced by the value of the parameter number 'num', if present - %parm[##]% is replaced by the number of parameters
`protected static String`	`getAllParamValues(Event event)` Helper method.
`protected static String`	`getAllParmNames(Event event)` Helper method.
`protected static String`	`getAllParmValues(Event event)` Helper method.
`abstract String`	`getAssetFieldValue(String parm, long nodeId)` Helper method.
`abstract String`	`getIfAlias(long nodeId, String ipaddr)` Retrieve ifAlias from the snmpinterface table of the database given a particular nodeId and ipAddr.
`static EventUtil`	`getInstance()`
`String`	`getNamedParmValue(String parm, Event event)` Helper method.
`abstract String`	`getNodeLabel(long nodeId)` Retrieve nodeLabel from the node table of the database given a particular nodeId.
`protected static String`	`getNumParmName(String parm, Event event)` Helper method.
`protected static String`	`getNumParmValue(String parm, Event event)` Helper method.
`String`	`getValueOfParm(String parm, Event event)` Get the value of the parm for the event
`static String`	`splitAndExtract(String src, String sep, int offset, boolean doRange, int rangeLen)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.opennms.netmgt.eventd.EventUtil
getHardwareFieldValue

- Field Detail
  - TAG_EVENT_DB_ID
```
protected static final String TAG_EVENT_DB_ID
```
    The Event ID xml
    
    See Also:
    Constant Field Values
  - TAG_UEI
```
protected static final String TAG_UEI
```
    The UEI xml tag
    
    See Also:
    Constant Field Values
  - TAG_SOURCE
```
protected static final String TAG_SOURCE
```
    The event source xml tag
    
    See Also:
    Constant Field Values
  - TAG_DESCR
```
protected static final String TAG_DESCR
```
    The event descr xml tag
    
    See Also:
    Constant Field Values
  - TAG_LOGMSG
```
protected static final String TAG_LOGMSG
```
    The event logmsg xml tag
    
    See Also:
    Constant Field Values
  - TAG_TIME
```
protected static final String TAG_TIME
```
    The event time xml tag
    
    See Also:
    Constant Field Values
  - TAG_SHORT_TIME
```
protected static final String TAG_SHORT_TIME
```
    The event time xml tag, short format
    
    See Also:
    Constant Field Values
  - TAG_DPNAME
```
protected static final String TAG_DPNAME
```
    The event dpname xml tag
    
    See Also:
    Constant Field Values
  - TAG_NODEID
```
protected static final String TAG_NODEID
```
    The event nodeid xml tag
    
    See Also:
    Constant Field Values
  - TAG_NODELABEL
```
protected static final String TAG_NODELABEL
```
    The event nodelabel xml tag
    
    See Also:
    Constant Field Values
  - TAG_HOST
```
protected static final String TAG_HOST
```
    The event host xml tag
    
    See Also:
    Constant Field Values
  - TAG_INTERFACE
```
protected static final String TAG_INTERFACE
```
    The event interface xml tag
    
    See Also:
    Constant Field Values
  - TAG_IFINDEX
```
protected static final String TAG_IFINDEX
```
    The event ifindex xml tag
    
    See Also:
    Constant Field Values
  - TAG_INTERFACE_RESOLVE
```
protected static final String TAG_INTERFACE_RESOLVE
```
    The reverse DNS lookup of the interface
    
    See Also:
    Constant Field Values
  - TAG_IFALIAS
```
protected static final String TAG_IFALIAS
```
    The reverse DNS lookup of the interface
    
    See Also:
    Constant Field Values
  - TAG_SNMP_ID
```
protected static final String TAG_SNMP_ID
```
    The event snmp id xml tag
    
    See Also:
    Constant Field Values
  - TAG_SNMP
```
protected static final String TAG_SNMP
```
    The SNMP xml tag
    
    See Also:
    Constant Field Values
  - TAG_SNMP_IDTEXT
```
protected static final String TAG_SNMP_IDTEXT
```
    The event snmp idtext xml tag
    
    See Also:
    Constant Field Values
  - TAG_SNMP_VERSION
```
protected static final String TAG_SNMP_VERSION
```
    The event snmp version xml tag
    
    See Also:
    Constant Field Values
  - TAG_SNMP_SPECIFIC
```
protected static final String TAG_SNMP_SPECIFIC
```
    The event snmp specific xml tag
    
    See Also:
    Constant Field Values
  - TAG_SNMP_GENERIC
```
protected static final String TAG_SNMP_GENERIC
```
    The event snmp generic xml tag
    
    See Also:
    Constant Field Values
  - TAG_SNMP_COMMUNITY
```
protected static final String TAG_SNMP_COMMUNITY
```
    The event snmp community xml tag
    
    See Also:
    Constant Field Values
  - TAG_SNMPHOST
```
protected static final String TAG_SNMPHOST
```
    The event snmp host xml tag
    
    See Also:
    Constant Field Values
  - TAG_SERVICE
```
protected static final String TAG_SERVICE
```
    The event service xml tag
    
    See Also:
    Constant Field Values
  - TAG_SEVERITY
```
protected static final String TAG_SEVERITY
```
    The event severity xml tag
    
    See Also:
    Constant Field Values
  - TAG_OPERINSTR
```
protected static final String TAG_OPERINSTR
```
    The event operinstruct xml tag
    
    See Also:
    Constant Field Values
  - TAG_MOUSEOVERTEXT
```
protected static final String TAG_MOUSEOVERTEXT
```
    The event mouseovertext xml tag
    
    See Also:
    Constant Field Values
  - TAG_TTICKET_ID
```
protected static final Object TAG_TTICKET_ID
```
  - ASSET_BEGIN
```
protected static final String ASSET_BEGIN
```
    The string that starts the expansion for an asset field - used to lookup values of asset fields by their names
    
    See Also:
    Constant Field Values
  - ASSET_END_SUFFIX
```
protected static final String ASSET_END_SUFFIX
```
    The string that ends the expansion of a parm
    
    See Also:
    Constant Field Values
  - PERCENT
```
protected static final char PERCENT
```
    The '%' sign used to indicate parms to be expanded
    
    See Also:
    Constant Field Values
  - PARMS_NAMES
```
protected static final String PARMS_NAMES
```
    The string that should be expanded to a list of all parm names
    
    See Also:
    Constant Field Values
  - PARMS_VALUES
```
protected static final String PARMS_VALUES
```
    The string that should be expanded to a list of all parm values
    
    See Also:
    Constant Field Values
  - PARMS_ALL
```
protected static final String PARMS_ALL
```
    The string that should be expanded to a list of all parms
    
    See Also:
    Constant Field Values
  - PARM_BEGIN
```
protected static final String PARM_BEGIN
```
    The string that starts the expansion for a parm - used to lookup values of parameters by their names
    
    See Also:
    Constant Field Values
  - PARM_BEGIN_LENGTH
```
protected static final int PARM_BEGIN_LENGTH
```
    The length of PARM_BEGIN
    
    See Also:
    Constant Field Values
  - NUM_PARMS_STR
```
protected static final String NUM_PARMS_STR
```
    The string that should be expanded to the number of parms
    
    See Also:
    Constant Field Values
  - PARM_NUM_PREFIX
```
protected static final String PARM_NUM_PREFIX
```
    The string that starts a parm number - used to lookup values of parameters by their position
    
    See Also:
    Constant Field Values
  - PARM_NUM_PREFIX_LENGTH
```
protected static final int PARM_NUM_PREFIX_LENGTH
```
    The length of PARM_NUM_PREFIX
    
    See Also:
    Constant Field Values
  - PARM_NAME_NUMBERED_PREFIX
```
protected static final String PARM_NAME_NUMBERED_PREFIX
```
    The string that starts a request for the name of a numbered parm
    
    See Also:
    Constant Field Values
  - PARM_NAME_NUMBERED_PREFIX_LENGTH
```
protected static final int PARM_NAME_NUMBERED_PREFIX_LENGTH
```
    The length of PARM_NAME_NUMBERED_PREFIX
    
    See Also:
    Constant Field Values
  - PARM_END_SUFFIX
```
protected static final String PARM_END_SUFFIX
```
    The string that ends the expansion of a parm
    
    See Also:
    Constant Field Values
  - NAME_VAL_DELIM
```
protected static final char NAME_VAL_DELIM
```
    For expansion of the '%parms[all]%' - the parm name and value are added as delimiter separated list of ' = ' strings
    
    See Also:
    Constant Field Values
  - SPACE_DELIM
```
protected static final char SPACE_DELIM
```
    See Also:
    Constant Field Values
  - ATTRIB_DELIM
```
protected static final char ATTRIB_DELIM
```
    The values and the corresponding attributes of an element are added delimited by ATTRIB_DELIM
    
    See Also:
    Constant Field Values
  - TAG_PERCENT_SIGN
```
protected static final String TAG_PERCENT_SIGN
```
    Substitute the actual percent sign
    
    See Also:
    Constant Field Values
- Constructor Detail
  - AbstractEventUtil
```
public AbstractEventUtil()
```
- Method Detail
  - getInstance
```
public static EventUtil getInstance()
```
  - escape
```
public static String escape(String inStr,
            char delimchar)
```
    This method is used to escape required values from strings that may contain those values. If the passed string contains the passed value then the character is reformatted into its %dd format.
    
    Parameters:
    inStr - string that might contain the delimiter
    delimchar - delimiter to escape
    
    Returns:
    The string with the delimiter escaped as in URLs
    See Also:
    ATTRIB_DELIM
  - getValueOfParm
```
public final String getValueOfParm(String parm,
                    Event event)
```
    Get the value of the parm for the event
    
    Specified by:
    
    getValueOfParm in interface EventUtil
    
    Parameters:
    parm - the parm for which value is needed from the event
    event - the event whose parm value is required
    
    Returns:
    value of the event parm/element
  - getAllParmValues
```
protected static String getAllParmValues(Event event)
```
    Helper method.
    
    Parameters:
    event -
    
    Returns:
    All event parameter values as a String.
  - getAllParmNames
```
protected static String getAllParmNames(Event event)
```
    Helper method.
    
    Parameters:
    event -
    
    Returns:
    The names of all the event parameters.
  - getAllParamValues
```
protected static String getAllParamValues(Event event)
```
    Helper method.
    
    Parameters:
    event -
    
    Returns:
    All event parameter values as a String
  - getNumParmName
```
protected static String getNumParmName(String parm,
                    Event event)
```
    Helper method.
    
    Parameters:
    parm -
    event -
    
    Returns:
    The name of a parameter based on its ordinal position in the event's list of parameters
  - splitAndExtract
```
public static String splitAndExtract(String src,
                     String sep,
                     int offset,
                     boolean doRange,
                     int rangeLen)
```
  - getNumParmValue
```
protected static String getNumParmValue(String parm,
                     Event event)
```
    Helper method.
    
    Parameters:
    parm -
    event -
    
    Returns:
    The value of a parameter based on its ordinal position in the event's list of parameters
  - getNamedParmValue
```
public final String getNamedParmValue(String parm,
                       Event event)
```
    Helper method.
    
    Specified by:
    
    getNamedParmValue in interface EventUtil
    
    Parameters:
    parm - a String object.
    event - a Event object.
    
    Returns:
    A parameter's value as a String using the parameter's name..
  - expandMapValues
```
public final void expandMapValues(Map<String,String> map,
                   Event event)
```
    expandMapValues
    
    Specified by:
    
    expandMapValues in interface EventUtil
    
    Parameters:
    map - a Map object.
    event - a Event object.
  - expandParms
```
public final String expandParms(String inp,
                 Event event)
```
    Expand the value if it has parms in one of the following formats - %element% values are expanded to have the value of the element where 'element' is an element in the event DTD - %parm[values-all]% is expanded to a delimited list of all parmblock values - %parm[names-all]% is expanded to a list of all parm names - %parm[all]% is expanded to a full dump of all parmblocks - %parm[name]% is expanded to the value of the parameter named 'name' - %parm[ ]% is replaced by the value of the parameter named 'name', if present - %parm[# ]% is replaced by the value of the parameter number 'num', if present - %parm[##]% is replaced by the number of parameters
    
    Specified by:
    
    expandParms in interface EventUtil
    
    Parameters:
    inp - the input string in which parm values are to be expanded
    event - a Event object.
    
    Returns:
    expanded value if the value had any parameter to expand, null otherwise
  - expandParms
```
public final String expandParms(String inp,
                 Event event,
                 Map<String,Map<String,String>> decode)
```
    Expand the value if it has parms in one of the following formats - %element% values are expanded to have the value of the element where 'element' is an element in the event DTD - %parm[values-all]% is expanded to a delimited list of all parmblock values - %parm[names-all]% is expanded to a list of all parm names - %parm[all]% is expanded to a full dump of all parmblocks - %parm[name]% is expanded to the value of the parameter named 'name' - %parm[ ]% is replaced by the value of the parameter named 'name', if present - %parm[# ]% is replaced by the value of the parameter number 'num', if present - %parm[##]% is replaced by the number of parameters
    
    Specified by:
    
    expandParms in interface EventUtil
    
    Parameters:
    inp - the input string in which parm values are to be expanded
    decode - the varbind decode for this
    event - a Event object.
    
    Returns:
    expanded value if the value had any parameter to expand, null otherwise
  - getNodeLabel
```
public abstract String getNodeLabel(long nodeId)
                             throws SQLException
```
    Retrieve nodeLabel from the node table of the database given a particular nodeId.
    
    Specified by:
    
    getNodeLabel in interface EventUtil
    
    Parameters:
    nodeId - Node identifier
    
    Returns:
    nodeLabel Retreived nodeLabel
    
    Throws:
    
    SQLException - if database error encountered
  - getIfAlias
```
public abstract String getIfAlias(long nodeId,
                String ipaddr)
                           throws SQLException
```
    Retrieve ifAlias from the snmpinterface table of the database given a particular nodeId and ipAddr.
    
    Specified by:
    
    getIfAlias in interface EventUtil
    
    Parameters:
    nodeId - Node identifier
    ipAddr - Interface IP address
    
    Returns:
    ifAlias Retreived ifAlias
    
    Throws:
    
    SQLException - if database error encountered
  - getAssetFieldValue
```
public abstract String getAssetFieldValue(String parm,
                        long nodeId)
```
    Helper method.
    
    Specified by:
    
    getAssetFieldValue in interface EventUtil
    
    Parameters:
    parm -
    event -
    
    Returns:
    The value of an asset field based on the nodeid of the event

Class AbstractEventUtil

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.opennms.netmgt.eventd.EventUtil

Field Detail

TAG_EVENT_DB_ID

TAG_UEI

TAG_SOURCE

TAG_DESCR

TAG_LOGMSG

TAG_TIME

TAG_SHORT_TIME

TAG_DPNAME

TAG_NODEID

TAG_NODELABEL

TAG_HOST

TAG_INTERFACE

TAG_IFINDEX

TAG_INTERFACE_RESOLVE

TAG_IFALIAS

TAG_SNMP_ID

TAG_SNMP

TAG_SNMP_IDTEXT

TAG_SNMP_VERSION

TAG_SNMP_SPECIFIC

TAG_SNMP_GENERIC

TAG_SNMP_COMMUNITY

TAG_SNMPHOST

TAG_SERVICE

TAG_SEVERITY

TAG_OPERINSTR

TAG_MOUSEOVERTEXT

TAG_TTICKET_ID

ASSET_BEGIN

ASSET_END_SUFFIX

PERCENT

PARMS_NAMES

PARMS_VALUES

PARMS_ALL

PARM_BEGIN

PARM_BEGIN_LENGTH

NUM_PARMS_STR

PARM_NUM_PREFIX

PARM_NUM_PREFIX_LENGTH

PARM_NAME_NUMBERED_PREFIX

PARM_NAME_NUMBERED_PREFIX_LENGTH

PARM_END_SUFFIX

NAME_VAL_DELIM

SPACE_DELIM

ATTRIB_DELIM

TAG_PERCENT_SIGN

Constructor Detail

AbstractEventUtil

Method Detail

getInstance

escape

getValueOfParm

getAllParmValues

getAllParmNames

getAllParamValues

getNumParmName

splitAndExtract

getNumParmValue

getNamedParmValue

expandMapValues

expandParms

expandParms

getNodeLabel

getIfAlias

getAssetFieldValue