Configuration notifiers

Applications may install configuration notifiers to respond to configuration events that are raised as the configuration transitions through its life cycle. See the TIBCO BusinessEvents® Extreme Java Developer's Guide for details on how configuration notifiers are installed. Configuration notifiers are associated with a configuration type. Multiple notifiers can be installed for a configuration type. If multiple configuration notifiers are installed, the order in which they are called is undefined.

Configuration notifiers support:

Audit notifier methods should ensure that the configuration state transition being audited can occur successfully. If the state transition cannot occur successfully, either because of invalid configuration data values or the current state of the application, the audit method reports a failure. If an audit fails, the configuration state change does not occur.

Table 9.1. State transition audits

State TransitionDescription
loadConfiguration load audit. This audit occurs after the configuration data is loaded into memory.
activateConfiguration activate audit. This audit method is called when there is no previous version of the configuration data with the specified type and name active.
replaceConfiguration replace audit. This audit method is called when there is a previous version of the specified type and name active.
inactiveConfiguration deactivation audit.
removeConfiguration remove audit.

Following a successful audit (except for load), a notifier method is called to perform application specific behavior associated with the configuration state transition. The application state change methods cannot fail - all validation should have been done by the associated audit method.

Table 9.2. State transition methods

StateDescription
loadConfiguration data successfully loaded.
activeConfiguration activation succeeded. This method is called when there is no previous version of the configuration data with the specified type and name active.
replaceReplace existing configuration data. This method is called when there is a previous version of the specified type and name active.
inactiveConfiguration data successfully deactivated.

Notice that there is no method associated with removing configuration data. Configuration data removal is handled without any application involvement, other than auditing that the configuration data can be removed.