01: /*_############################################################################
02: _##
03: _## SNMP4J - CounterListener.java
04: _##
05: _## Copyright (C) 2003-2008 Frank Fock and Jochen Katz (SNMP4J.org)
06: _##
07: _## Licensed under the Apache License, Version 2.0 (the "License");
08: _## you may not use this file except in compliance with the License.
09: _## You may obtain a copy of the License at
10: _##
11: _## http://www.apache.org/licenses/LICENSE-2.0
12: _##
13: _## Unless required by applicable law or agreed to in writing, software
14: _## distributed under the License is distributed on an "AS IS" BASIS,
15: _## WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16: _## See the License for the specific language governing permissions and
17: _## limitations under the License.
18: _##
19: _##########################################################################*/
20:
21: package org.snmp4j.event;
22:
23: import java.util.EventListener; // for JavaDoc
24: import org.snmp4j.security.SecurityModel;
25: import org.snmp4j.mp.MessageProcessingModel;
26:
27: /**
28: * The <code>CounterListener</code> interface has to be implemented by listener
29: * for {@link CounterEvent} events. By implementing this method, an object is
30: * able to be informed by a {@link MessageProcessingModel},
31: * {@link SecurityModel}, or other objects about conditions causing
32: * certain counters to be incremented.
33: *
34: * @author Frank Fock
35: * @version 1.0
36: */
37: public interface CounterListener extends EventListener {
38:
39: /**
40: * Increment the supplied counter instance and return the current value
41: * (after incrementation) in the event object if the event receiver is the
42: * maintainer of the counter value.
43: * @param event
44: * a <code>CounterEvent</code> instance.
45: */
46: void incrementCounter(CounterEvent event);
47:
48: }
|