GigaSpaces XAP 8.0 API

org.openspaces.admin.alert
Interface AlertManager

All Superinterfaces:
AdminAware

public interface AlertManager
extends AdminAware

The AlertManager is a manager for configuring of alerts, firing of alerts, and registering for alert events.

The alert manager provides two options for configuration of alert configurations - as bulk or one by one. The AlertConfiguration is the main interface of an alert configuration - a configuration based on String key-value property pairs.

To configure with a bulk of alert configurations, the configure(AlertConfiguration[]) method can be used. These configurations can be extracted from a resource using an AlertConfigurationParser. The parser AlertConfigurationParser.parse() returns an array of AlertConfiguration. The XmlAlertConfigurationParser can be used to parse the alerts.xml configuration file located under config/alerts.

To Register/Unregister for alert events (of all types), use the AlertTriggeredEventManager to add/remove AlertTriggeredEventListeners.

The triggerAlert(Alert) method call allows alert triggers to 'fire' an alert and trigger an event to be sent to all registered alert event listeners.

Since:
8.0
Author:
Moran Avigdor

Method Summary
 void configure(AlertConfiguration... configurations)
          Define an alert configuration for a 'bulk' of configurations.
 void disableAlert(Class<? extends AlertConfiguration> clazz)
          Disables a previously enabled alert.
 void enableAlert(Class<? extends AlertConfiguration> clazz)
          Enable a previously set alert configuration.
 AlertTriggeredEventManager getAlertTriggered()
           
<T extends AlertConfiguration>
T
getConfig(Class<T> clazz)
          Get the currently set alert configuration.
 boolean isAlertEnabled(Class<? extends AlertConfiguration> clazz)
           
 boolean removeConfig(Class<? extends AlertConfiguration> clazz)
          Removes a previously set alert configuration.
 void setConfig(AlertConfiguration config)
          Defines an alert configuration.
 void triggerAlert(Alert alert)
          Trigger an alert event for registered alert event listeners.
 
Methods inherited from interface org.openspaces.admin.AdminAware
getAdmin
 

Method Detail

configure

void configure(AlertConfiguration... configurations)
               throws AlertConfigurationException
Define an alert configuration for a 'bulk' of configurations. Overrides all previously set properties for any of the alerts.

See the XmlAlertConfigurationParser which can be used to parse the default alerts.xml configuration file located under config/alerts.

If AlertConfiguration.isEnabled() returns true it is equivalent to calling (for a predefined alert) disableAlert(Class), followed by setConfig(AlertConfiguration) followed by enableAlert(Class).

If it returns false it is equivalent to calling (for a predefined alert) disableAlert(Class) followed by setConfig(AlertConfiguration).

if an alert configuration was not previously set, the current setting will be used.

Parameters:
configurations - the alert configurations (as varargs).
Throws:
AlertConfigurationException - if the alert is already enabled (need to disable it first).
See Also:
AlertConfigurationParser

setConfig

void setConfig(AlertConfiguration config)
               throws AlertConfigurationException
Defines an alert configuration. Overrides all previously set properties for this alert.

The AlertConfiguration.isEnabled() is ignored. To enable, call enableAlert(Class). To perform both operations in a single call, use configure(AlertConfiguration[]).

An exception is raised if the alert is already enabled.

Parameters:
config - the alert configuration
Throws:
AlertConfigurationException - if the alert is already enabled (need to disable it first).

enableAlert

void enableAlert(Class<? extends AlertConfiguration> clazz)
                 throws AlertConfigurationException
Enable a previously set alert configuration. From this point, alerts will be triggered.

If the alert is already enabled, the request is silently ignored.

Parameters:
clazz - the class of the alert configuration
Throws:
AlertConfigurationException - if the alert can't be enabled for any of the following reasons:
  • if the configuration was not previously set.
  • in the event of misconfiguration (such as failure to set an essential property).
  • if initialization fails.

disableAlert

void disableAlert(Class<? extends AlertConfiguration> clazz)
                  throws AlertConfigurationException
Disables a previously enabled alert. The configuration remains, but alerts will no longer be triggered. The alert can be enabled at a later time, based on previously set configuration.

If the alert is already disabled, the request is silently ignored.

Parameters:
clazz - the class of the alert configuration
Throws:
AlertConfigurationException - if the alert configuration was not previously set.

isAlertEnabled

boolean isAlertEnabled(Class<? extends AlertConfiguration> clazz)
Parameters:
clazz - the class of the alert configuration
Returns:
true if the alert is already enabled, false if the alert is disabled or if it's configuration was not found.

removeConfig

boolean removeConfig(Class<? extends AlertConfiguration> clazz)
                     throws AlertConfigurationException
Removes a previously set alert configuration.

An exception is raised if the alert is currently enabled. Disable the alert prior to this call.

Parameters:
clazz - the class of the alert configuration
Returns:
true if removed ,false if it did not exist in the first place.
Throws:
AlertConfigurationException - if the alert configuration can't be removed for any of the following reasons:
  • if the alert is currently enabled (need to disable it first).
  • if the configuration was not previously set

getConfig

<T extends AlertConfiguration> T getConfig(Class<T> clazz)
                                       throws AlertConfigurationException
Get the currently set alert configuration.

Parameters:
clazz - the class of the alert configuration
Returns:
The alert configuration implementation object set with the configuration properties.
Throws:
AlertConfigurationException - if the alert configuration was not previously set.

triggerAlert

void triggerAlert(Alert alert)
Trigger an alert event for registered alert event listeners.

Parameters:
alert - an alert.

getAlertTriggered

AlertTriggeredEventManager getAlertTriggered()
Returns:
the alert event manager to register/unregister for alert events.

GigaSpaces XAP 8.0 API

Copyright © GigaSpaces.