1 /*_############################################################################ 2 _## 3 _## SNMP4J - CounterListener.java 4 _## 5 _## Copyright 2003-2007 Frank Fock and Jochen Katz (SNMP4J.org) 6 _## 7 _## Licensed under the Apache License, Version 2.0 (the "License"); 8 _## you may not use this file except in compliance with the License. 9 _## 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 22 23 24 25 package org.snmp4j.event; 26 27 import java.util.EventListener; 28 // for JavaDoc 29 import org.snmp4j.security.SecurityModel; 30 import org.snmp4j.mp.MessageProcessingModel; 31 32 /** 33 * The <code>CounterListener</code> interface has to be implemented by listener 34 * for {@link CounterEvent} events. By implementing this method, an object is 35 * able to be informed by a {@link MessageProcessingModel}, 36 * {@link SecurityModel}, or other objects about conditions causing 37 * certain counters to be incremented. 38 * 39 * @author Frank Fock 40 * @version 1.0 41 */ 42 public interface CounterListener extends EventListener { 43 44 /** 45 * Increment the supplied counter instance and return the current value 46 * (after incrementation) in the event object if the event receiver is the 47 * maintainer of the counter value. 48 * @param event 49 * a <code>CounterEvent</code> instance. 50 */ 51 void incrementCounter(CounterEvent event); 52 53 } 54