org.opennms.netmgt.poller.remote
Interface PollerBackEnd

All Known Implementing Classes:

DefaultPollerBackEnd, ExceptionProtectedPollerBackEnd, ServerUnreachableAdaptor

public interface PollerBackEnd

PollerBackEnd interface.

Version:

$Id: $

Author:

Mathew Brozowski

Method Summary

void	checkForDisconnectedMonitors() checkForDisconnectedMonitors
void	configurationUpdated() configurationUpdated
Collection<OnmsMonitoringLocationDefinition>	getMonitoringLocations() Return the set of available MonitoringLocationDefinitions
String	getMonitorName(int locationMonitorId) Get monitor name
PollerConfiguration	getPollerConfiguration(int locationMonitorId) Gets the poller configuration assigned to this monitoring location
Collection<ServiceMonitorLocator>	getServiceMonitorLocators(DistributionContext context) Get service monitor locators for creating serviceMonitors for the poller.
OnmsLocationMonitor.MonitorStatus	pollerCheckingIn(int locationMonitorId, Date currentConfigurationVersion) Checkin with the backend to let it know that the poller is still alive and to find out if there are any configuration changes.
boolean	pollerStarting(int locationMonitorId, Map<String,String> pollerDetails) Notifies the backend that a registered poller is starting
void	pollerStopping(int locationMonitorId) Notifies the backend that a registered poller is stopping
int	registerLocationMonitor(String monitoringLocationId) Register a new location monitor
void	reportResult(int locationMonitorID, int serviceId, PollStatus status) Report a poll result from the client to the server.

Method Detail

getMonitoringLocations

Collection<OnmsMonitoringLocationDefinition> getMonitoringLocations()

Return the set of available MonitoringLocationDefinitions

Returns:

a Collection object.

registerLocationMonitor

int registerLocationMonitor(String monitoringLocationId)

Register a new location monitor

Parameters:

monitoringLocationId - the id of the monitoredLocation to associate with this location monitor

Returns:

the id of the new locations monitor

getMonitorName

String getMonitorName(int locationMonitorId)

Get monitor name

Parameters:

locationMonitorId - a int.

Returns:

a String object.

getServiceMonitorLocators

Collection<ServiceMonitorLocator> getServiceMonitorLocators(DistributionContext context)

Get service monitor locators for creating serviceMonitors for the poller.

Parameters:

context - a DistributionContext object.

Returns:

a Collection object.

pollerStarting

boolean pollerStarting(int locationMonitorId,
                       Map<String,String> pollerDetails)

Notifies the backend that a registered poller is starting

Parameters:

locationMonitorId - the id of the requesting location monitor

pollerDetails - TODO

Returns:

a boolean.

pollerStopping

void pollerStopping(int locationMonitorId)

Notifies the backend that a registered poller is stopping

Parameters:

locationMonitorId - the id of the requesting location monitor

pollerCheckingIn

OnmsLocationMonitor.MonitorStatus pollerCheckingIn(int locationMonitorId,
                                                   Date currentConfigurationVersion)

Checkin with the backend to let it know that the poller is still alive and to find out if there are any configuration changes.

Parameters:

locationMonitorId - the id of the location monitor that is checking in

currentConfigurationVersion - the version of the configuration that the location monitor is currently using

Returns:

true if the configuration should be updated.

getPollerConfiguration

PollerConfiguration getPollerConfiguration(int locationMonitorId)

Gets the poller configuration assigned to this monitoring location

Parameters:

locationMonitorId - the id of the requesting location monitor

Returns:

the PollerConfiguration for the indicicated location monitor

reportResult

void reportResult(int locationMonitorID,
                  int serviceId,
                  PollStatus status)

Report a poll result from the client to the server.

Parameters:

locationMonitorID - the id of the location monitor that did the poll

serviceId - the id of the service that was polled

status - a PollStatus object.

configurationUpdated

void configurationUpdated()

configurationUpdated

checkForDisconnectedMonitors

void checkForDisconnectedMonitors()

checkForDisconnectedMonitors