org.opennms.netmgt.eventd.processor
Class EventExpander

java.lang.Object
  org.opennms.netmgt.eventd.processor.EventExpander

All Implemented Interfaces:

EventProcessor, org.springframework.beans.factory.InitializingBean

public final class EventExpander
extends Object
implements EventProcessor, org.springframework.beans.factory.InitializingBean

This class is responsible for looking up the matching evenconf entry for an event and loading info from the eventconf match to the event. This class is also responsible for the event parm expansion

Notes on event parm expansion:

The list of elements that can have a %element% or %parms[*]% in their value are : descr, logmsg, operinstr, autoaction, operaction(/menu), tticket

The list of elements that can occur as a %element% are : uei, source, nodeid, time, host, interface, snmphost, service, snmp, id, idtext, version, specific, generic, community, severity, operinstr, mouseovertext, parm[values-all], parm[names-all], parm[all], parm[ ], parm[##], parm[# ]

 
  Expansions are made so that 
  - %element% is replaced by the value of the element
    -i.e a 'xxx %uei%'  would expand to 'xxx <eventuei>'
  - %parm[values-all]% is replaced by a space-separated list of all parm values
    -i.e a 'xxx %parm[values-all]%'  would expand to 'xxx parmVal1 parmVal2 ..'
  - %parm[names-all]% is replaced by a space-separated list of all parm names 
    -i.e a 'xxx %parm[names-all]%'  would expand to 'xxx parmName1 parmName2 ..'
  - %parm[all]% is replaced by a space-separated list of all parmName="parmValue"
     -i.e a 'xxx %parm[all]%'  would expand to 'xxx parmName1="parmVal1" parmName2="parmVal2" ..'
  - %parm[<name>]% is replaced by the value of the parameter named 'name', if present
  - %parm[#<num>]% is replaced by the value of the parameter number 'num', if present
  - %parm[##]% is replaced by the number of parameters 
  
 

Author:

Brian Weaver , Sowmya Nataraj , OpenNMS

Constructor Summary

EventExpander()
The default trap UEI - if the trap lookup into the 'event.conf' fails, the trap event is loaded with information from this default UEI

Method Summary

void	afterPropertiesSet()
void	expandEvent(Event e) This method is invoked to check and configure a received event.
EventConfDao	getEventConfDao()
void	process(Header eventHeader, Event event)
void	setEventConfDao(EventConfDao eventConfDao)

Methods inherited from class java.lang.Object

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

Constructor Detail

EventExpander

public EventExpander()

The default trap UEI - if the trap lookup into the 'event.conf' fails, the trap event is loaded with information from this default UEI

Method Detail

afterPropertiesSet

public void afterPropertiesSet()

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

expandEvent

public void expandEvent(Event e)

This method is invoked to check and configure a received event. The event configuration manager is consulted to find the appropriate configuration that is used to expand the event. In addition, the security parameters from the configuration manager is consulted to ensure that secure files are cleared out if necessary.

Any secure fields that exists in the incomming event are cleared during expansion.

Parameters:

e - The event to expand if necesary.

process

public void process(Header eventHeader,
                    Event event)

Specified by:

process in interface EventProcessor

getEventConfDao

public EventConfDao getEventConfDao()

setEventConfDao

public void setEventConfDao(EventConfDao eventConfDao)