Real-Time Java AOCS Framework v1.0 API Specification

RtjAocsFramework.Factories
Class FailureRecoveryFactory

java.lang.Object
  |
  +--RtjAocsFramework.Factories.FailureRecoveryFactory
Direct Known Subclasses:
JbedSmmFailureRecoveryFactory

public abstract class FailureRecoveryFactory
extends Object

Framework-level factory for failure recovery management components. This factory implements methods to create (without configuring) the failure recovery manager and create commonly used recovery action and recovery strategy components.

Copyright: see the Copyright Notice.

Version:
1.0
Author:
V. Cechticky/A. Pasetti (ETH-Zurich)

Constructor Summary
FailureRecoveryFactory()
          Create (without configuring) the failure recovery manager.
 
Method Summary
 FailureRecoveryManager getFailureRecoveryManager()
          Return the failure recovery manager
 RecoveryStrategy makeLocalRecoveryActions(FailureEventRepository fev, int maxNumberOfRecoveryListeners)
          Create and return a recovery strategy that inspects a failure event repository and executes all the recovery actions associated to the failure events in the repository.
 RecoveryAction makeModeChangeRecoveryAction(ModeManager mm, short newMode)
          Create and return a mode change recovery action.
 RecoveryAction makeNullRecoveryAction()
          Create and return a null recovery action.
 RecoveryStrategy makeSystemResetOnConfigurationError(ConfigurationEventRepository cev, FailureEventRepository fev, int maxNumberOfRecoveryListeners)
          Create and return a recovery strategy to reset the application if one or more configuration events are found in the configuration event repository.
 RecoveryStrategy makeSystemResetOnTooManyFailures(FailureEventRepository fev, int n, int maxNumberOfRecoveryListeners)
          Create and return a recovery strategy to reset the application if the number of failure events in a failure event repository exceeds a certain threhold.
 RecoveryAction makeSystemResetRecoveryAction()
          Create and return a system reset recovery action.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

FailureRecoveryFactory

public FailureRecoveryFactory()
Create (without configuring) the failure recovery manager.

Method Detail

getFailureRecoveryManager

public FailureRecoveryManager getFailureRecoveryManager()
Return the failure recovery manager


makeNullRecoveryAction

public RecoveryAction makeNullRecoveryAction()
Create and return a null recovery action.


makeSystemResetRecoveryAction

public RecoveryAction makeSystemResetRecoveryAction()
Create and return a system reset recovery action.


makeModeChangeRecoveryAction

public RecoveryAction makeModeChangeRecoveryAction(ModeManager mm,
                                                   short newMode)
Create and return a mode change recovery action.

Parameters:
mm - mode manager whose mode must be changed by the recovery action
newMode - target mode for the recovery action

makeSystemResetOnTooManyFailures

public RecoveryStrategy makeSystemResetOnTooManyFailures(FailureEventRepository fev,
                                                         int n,
                                                         int maxNumberOfRecoveryListeners)
Create and return a recovery strategy to reset the application if the number of failure events in a failure event repository exceeds a certain threhold.

Parameters:
fev - the failure event repository
n - the threshold for the number of failure events in the repository
maxNumberOfRecoveryListeners - maximum number of listeners to recovery events

makeSystemResetOnConfigurationError

public RecoveryStrategy makeSystemResetOnConfigurationError(ConfigurationEventRepository cev,
                                                            FailureEventRepository fev,
                                                            int maxNumberOfRecoveryListeners)
Create and return a recovery strategy to reset the application if one or more configuration events are found in the configuration event repository.

Parameters:
cev - the configuration event repository
maxNumberOfRecoveryListeners - maximum number of listeners to recovery events

makeLocalRecoveryActions

public RecoveryStrategy makeLocalRecoveryActions(FailureEventRepository fev,
                                                 int maxNumberOfRecoveryListeners)
Create and return a recovery strategy that inspects a failure event repository and executes all the recovery actions associated to the failure events in the repository.

Parameters:
fev - the failure event repository
maxNumberOfRecoveryListeners - maximum number of listeners to recovery events

Real-Time Java AOCS Framework v1.0 API Specification

Real-Time Java AOCS Framework project home page

Automatic Control Laboratory, ETH Zuerich
Physikstrasse 3
CH-8092 Zuerich, Switzerland