[ViewVC] Diff of: i-scream/projects/cms/source/server/uk/org/iscream/cms/server/client/Register.java

Comparing projects/cms/source/server/uk/org/iscream/cms/server/client/Register.java (file contents):
Revision 1.1 by ajm, Fri Mar 2 03:56:06 2001 UTC vs.
Revision 1.3 by ajm, Sun Mar 4 05:23:41 2001 UTC

+//---IMPORTS---
+import uk.ac.ukc.iscream.util.*;
-+
+import uk.ac.ukc.iscream.componentmanager.ConfigurationProxy;
+/**
-<
+ * Register class
->
+ * The Register class holds theshold values,
->
+ * the last level of alert for each attribute for a monitor
->
+ * and the time of last alert sent for each alert level for
->
+ * each attribute in this register.
-+
+ * This class is used by monitor classes so they can determine
-+
+ * how often they should send alerts when breaching alert levels.
-+
+ * It also stores (and keeps uptodate (via the configuration proxy)
-+
+ * the threshold values for the monitor.
-+
+ *
+ * @author  $Author$
+ * @version $Id$
+ */
+//---CONSTRUCTORS---
+    /**
-<
+     * Construct a Register
->
+     * Construct a Register with the hostname and monitorName
->
+     * (for obtaining the threshold values), and the number of
->
+     * attributes we are keeping track of.
-<
+     * @param size the size of the register
->
+     * @param hostname the hostname this register is for
->
+     * @param monitorName the monitor this register is for
->
+     * @param numAttributes the number of attributes to track
+     */
-<
+    public Register(int size) {
-<
+        _register = new int[size];
-<
+        for (int x = 0; x < _register.length; x++) {
-<
+            _register[x] = 0;
->
+    public Register(String hostname, String monitorName, int numAttributes) {
->
+        _hostname = hostname;
->
+        _monitorName = monitorName;
->
+        _lastAlertLevels = new int[numAttributes];
->
+        _lastThresholdLevels = new int[numAttributes];
->
+        _lastAlertTimeout = new long[numAttributes];
->
+        _times = new long[numAttributes][Alert.alertLevels.length];
->
+        // initialise the arrays to 0
->
+        for (int x = 0; x < _lastAlertLevels.length; x++) {
->
+            _lastAlertLevels[x] = 0;
->
+            _lastThresholdLevels[x] = 0;
->
+            _lastAlertTimeout[x] = 0;
->
+            for(int y = 0; y < Alert.alertLevels.length; y++) {
->
+                _times[x][y] = 0;
->
+            }
+//---ACCESSOR/MUTATOR METHODS---
-<
+    public int getRegister(int register) {
-<
+        return _register[register];
->
+    /**
->
+     * Gets the last alert level for the
->
+     * given attribute.
->
+     *
->
+     * @param attributeNum the attribute to get
->
+     *
->
+     * @return the last alert level
->
+     */
->
+    public int getLastAlertLevel(int attributeNum) {
->
+        return _lastAlertLevels[attributeNum];
-<
+    public void setRegister(int register, int value) {
-<
+        _register[register] = value;
->
+    /**
->
+     * Sets the last threshold level for the
->
+     * given attribute.
->
+     *
->
+     * @param attributeNum the attribute to set
->
+     * @param level the new last threshold level
->
+     */
->
+    public void setLastThresholdLevel(int attributeNum, int level) {
->
+        _lastThresholdLevels[attributeNum] = level;
-+
-+
+        /**
-+
+     * Gets the last threshold level for the
-+
+     * given attribute.
-+
+     *
-+
+     * @param attributeNum the attribute to get
-+
+     *
-+
+     * @return the last threshold level
-+
+     */
-+
+    public int getLastThresholdLevel(int attributeNum) {
-+
+        return _lastThresholdLevels[attributeNum];
-+
+    }
-+
-+
+    /**
-+
+     * Sets the last alert level for the
-+
+     * given attribute.
-+
+     *
-+
+     * @param attributeNum the attribute to set
-+
+     * @param level the new last alert level
-+
+     */
-+
+    public void setLastAlertLevel(int attributeNum, int level) {
-+
+        _lastAlertLevels[attributeNum] = level;
-+
+    }
-+
-+
+    /**
-+
+     * Gets the time an alert was sent for the
-+
+     * given attribute at the given level.
-+
+     *
-+
+     * @param attributeNum the attribute to get
-+
+     * @param level the alert level to get
-+
+     *
-+
+     * @return the time last sent
-+
+     */
-+
+    public long getTimeLastSent(int attributeNum) {
-+
+        return _times[attributeNum][getLastAlertLevel(attributeNum)];
-+
+    }
-+
-+
+    /**
-+
+     * Gets the time an alert was sent for the
-+
+     * given attribute at the given level.
-+
+     *
-+
+     * @param attributeNum the attribute to get
-+
+     * @param level the alert level to get
-+
+     * @param value the new time
-+
+     */
-+
+    public void setTimeLastSent(int attributeNum, long value) {
-+
+        _times[attributeNum][getLastAlertLevel(attributeNum)] = value;
-+
+    }
-+
-+
+    /**
-+
+     * Gets the threshold value for the given
-+
+     * level of alert.
-+
+     *
-+
+     * If there is no alert threshold for a
-+
+     * given level, this returns -1.0
-+
+     *
-+
+     * @param level the alert level
-+
+     */
-+
+    public double getThreshold(int level) {
-+
+        double threshold = -1.0;
-+
+        String thresholdString = _cp.getProperty("Host." + _hostname, "Monitor." + _monitorName + ".threshold." + Alert.thresholdLevels[level]);
-+
+        if(thresholdString != null) {
-+
+            try {
-+
+                threshold = Double.parseDouble(thresholdString);
-+
+            } catch (NumberFormatException e) {
-+
+                // -1.0 means we don't use an alert level
-+
+                threshold = -1.0;
-+
+            }
-+
+        }
-+
+        return threshold;
-+
+    }
-+
-+
+    /**
-+
+     * Gets the alert timeout value for the given
-+
+     * level of alert.  This value is in millis,
-+
+     * and is converted from the value in the config,
-+
+     * which should be seconds.
-+
+     *
-+
+     * Note that this is dependant on the threshold value
-+
+     * given, the timeout is obatined from the config, then
-+
+     * divided by the threshold value, this allows alerts to
-+
+     * progress faster should a higher threshold value be passed
-+
+     *
-+
+     * If there is no alert timeout for a
-+
+     * given level, this returns -1.0
-+
+     *
-+
+     * @param level the alert level
-+
+     * @param thresholdLevel the threshold leve we are on
-+
+     */
-+
+    public long getAlertTimeout(int level, int attributeNum) {
-+
+        long timeout = 0;
-+
+        String timeoutString = _cp.getProperty("Host." + _hostname, "Monitor." + _monitorName + ".alertTimeout." + Alert.alertLevels[level]);
-+
+        if(timeoutString != null) {
-+
+            try {
-+
+                int threshold = getLastThresholdLevel(attributeNum);
-+
+                if (threshold > 0) {
-+
+                    timeout = (Long.parseLong(timeoutString) / threshold) * 1000;
-+
+                }
-+
+            } catch (NumberFormatException e) {
-+
+                // -1.0 means we don't use this value
-+
+                timeout = 0;
-+
+            }
-+
+        }
-+
+        return timeout;
-+
+    }
-+
-+
+    /**
-+
+     * Either advances to the next alert level, or if
-+
+     * the maximum alert level has been reached, simply returns
-+
+     * that.
-+
+     *
-+
+     * @param attributeNum the attribute to get next alert for
-+
+     */
-+
+    public int getNextAlertLevel(int attributeNum) {
-+
+        if((getLastAlertLevel(attributeNum) + 1) > (Alert.alertLevels.length - 1)) {
-+
+            return getLastAlertLevel(attributeNum);
-+
+        }
-+
+        return getLastAlertLevel(attributeNum) + 1;
-+
+    }
-+
+    /**
-+
+     * Gets the timeout value of the last alert
-+
+     * sent
-+
+     *
-+
+     * @param attrubuteNum the attribute to get the last timeout for
-+
+     * @return the last timeout value
-+
+     */
-+
+    public long getLastAlertTimeout(int attributeNum) {
-+
+        return _lastAlertTimeout[attributeNum];
-+
+    }
-+
-+
+    /**
-+
+     * Sets the timeout value of the last alert
-+
+     * sent
-+
+     *
-+
+     * @param attrubuteNum the attribute to get the last timeout for
-+
+     * @param timeout the new value
-+
+     */
-+
+    public void setLastAlertTimeout(int attributeNum, long timeout) {
-+
+        _lastAlertTimeout[attributeNum] = timeout;
-+
+    }
-+
-+
+    /**
-+
+     * Advances the alert level to the next one up.
-+
+     *
-+
+     * @param attributeNum the attribute to advance the alert for
-+
+     */
-+
+    public void escalateAlert(int attributeNum) {
-+
+        setLastAlertLevel(attributeNum, getNextAlertLevel(attributeNum));
-+
+    }
-+
+//---ATTRIBUTES---
-<
+    private int[] _register;
->
+    /**
->
+     * The host this register is for
->
+     */
->
+    private String _hostname;
->
->
+    /**
->
+     * The monitor this register is for
->
+     */
->
+    private String _monitorName;
->
->
+    /**
->
+     * An array of last alert levels for
->
+     * each attribute this register is looking
->
+     * after.
->
+     */
->
+    private int[] _lastAlertLevels;
->
->
+    /**
->
+     * An array of last threshold levels for
->
+     * each attribute this register is looking
->
+     * after.
->
+     */
->
+    private int[] _lastThresholdLevels;
->
->
+    /**
->
+     * An array of last alert timeout levels for
->
+     * each attribute this register is looking
->
+     * after.
->
+     */
->
+    private long[] _lastAlertTimeout;
->
->
+    /**
->
+     * An array of arrays containing
->
+     * time an alert of each level
->
+     * was last sent for each attribute.
->
+     */
->
+    private long[][] _times;
->
->
+    /**
->
+     * A reference to the configuration proxy in use
->
+     */
->
+    private ConfigurationProxy _cp = ConfigurationProxy.getInstance();
+//---STATIC ATTRIBUTES---

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines
->
+Changed lines

Comparing projects/cms/source/server/uk/org/iscream/cms/server/client/Register.java (file contents): Revision 1.1 by ajm, Fri Mar 2 03:56:06 2001 UTC vs. Revision 1.3 by ajm, Sun Mar 4 05:23:41 2001 UTC

Diff Legend

Comparing projects/cms/source/server/uk/org/iscream/cms/server/client/Register.java (file contents):
Revision 1.1 by ajm, Fri Mar 2 03:56:06 2001 UTC vs.
Revision 1.3 by ajm, Sun Mar 4 05:23:41 2001 UTC