01: /*
02: * hgcommons 7
03: * Hammurapi Group Common Library
04: * Copyright (C) 2003 Hammurapi Group
05: *
06: * This program is free software; you can redistribute it and/or
07: * modify it under the terms of the GNU Lesser General Public
08: * License as published by the Free Software Foundation; either
09: * version 2 of the License, or (at your option) any later version.
10: *
11: * This program is distributed in the hope that it will be useful,
12: * but WITHOUT ANY WARRANTY; without even the implied warranty of
13: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14: * Lesser General Public License for more details.
15: *
16: * You should have received a copy of the GNU Lesser General Public
17: * License along with this library; if not, write to the Free Software
18: * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19: *
20: * URL: http://www.hammurapi.biz/hammurapi-biz/ef/xmenu/hammurapi-group/products/products/hgcommons/index.html
21: * e-Mail: support@hammurapi.biz
22: */
23: package biz.hammurapi.metrics;
24:
25: import java.util.Collection;
26:
27: /**
28: * @author Pavel Vlasov
29: * @version $Revision: 1.5 $
30: */
31: public interface Metric {
32: public interface Measurement {
33: double getValue();
34:
35: long getTime();
36: }
37:
38: /**
39: * @return number of measurements
40: */
41: int getNumber();
42:
43: /**
44: * @return Minimum value
45: */
46: double getMin();
47:
48: /**
49: * @return Maximum value
50: */
51: double getMax();
52:
53: /**
54: * @return Average
55: */
56: double getAvg();
57:
58: /**
59: * @return Sum of values from all measurements
60: */
61: double getTotal();
62:
63: /**
64: * @return average distance from average
65: */
66: double getDeviation();
67:
68: /**
69: * Adds measurement
70: * @param source Source object
71: * @param value value
72: */
73: void add(double value, long time);
74:
75: /**
76: * Adds another metric (aggregates)
77: * @param metric
78: */
79: void add(Metric metric);
80:
81: /**
82: * @return Collection of {@link Measurement}
83: */
84: Collection getMeasurements();
85:
86: String getName();
87: }
|