01: /**
02: * The XMOJO Project 5
03: * Copyright © 2003 XMOJO.org. All rights reserved.
04:
05: * NO WARRANTY
06:
07: * BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR
08: * THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
09: * OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
10: * PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
11: * OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
12: * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
13: * TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE
14: * LIBRARY PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
15: * REPAIR OR CORRECTION.
16:
17: * IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
18: * ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE
19: * THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
20: * GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
21: * USE OR INABILITY TO USE THE LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF
22: * DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
23: * PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE),
24: * EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
25: * SUCH DAMAGES.
26: **/package javax.management.monitor;
27:
28: /**
29: * Exposes the remote management interface of the string monitor MBean.
30: */
31: public abstract interface StringMonitorMBean extends MonitorMBean {
32: /**
33: * This method gets the value of the derived gauge. The derived gauge is
34: * either the exact value of the observed attribute, or the difference
35: * between the two consecutive observed values of the attribute.
36: *
37: * @return An instance of java.lang.String giving the value of the derived gauge.
38: */
39: public String getDerivedGauge();
40:
41: /**
42: * This method gets the value of the derived gauge time stamp. The derived
43: * gauge time stamp is the value(in the nearest miliseconds) when the
44: * notification was triggered.
45: *
46: * @return long value representing the time the notification was triggered.
47: */
48: public long getDerivedGaugeTimeStamp();
49:
50: /**
51: * This method sets the differing notification's on/off switch value.
52: *
53: * @return The differing notification's on/off switch value.
54: */
55: public boolean getNotifyDiffer();
56:
57: /**
58: * This method sets the differing notification's on/off switch value.
59: *
60: * @param value - The differing notification's on/off switch value.
61: */
62: public void setNotifyDiffer(boolean value);
63:
64: /**
65: * This method gets the matching notification's on/off switch value.
66: *
67: * @return The matching notification's on/off switch value.
68: */
69:
70: public boolean getNotifyMatch();
71:
72: /**
73: * This method sets the matching notification's on/off switch value.
74: *
75: * @param value - The matching notification's on/off switch value.
76: */
77: public void setNotifyMatch(boolean value);
78:
79: /**
80: * This method gets the string to compare with the observed attribute.
81: *
82: * @return the String to be compared.
83: */
84: public String getStringToCompare();
85:
86: /**
87: * This method sets the string to compare with the observed attribute.
88: *
89: * @param value The String Value to be compared.
90: *
91: * @exception java.lang.IllegalArgumentException - The specified string
92: * to compare is null.
93: */
94: public void setStringToCompare(String value)
95: throws IllegalArgumentException;
96: }
|