01: /*_############################################################################
02: _##
03: _## SNMP4J-AgentX - PingListener.java
04: _##
05: _## Copyright (C) 2005-2007 Frank Fock (SNMP4J.org)
06: _##
07: _## This program is free software; you can redistribute it and/or modify
08: _## it under the terms of the GNU General Public License version 2 as
09: _## published by the Free Software Foundation.
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
14: _## GNU General Public License for more details.
15: _##
16: _## You should have received a copy of the GNU General Public License
17: _## along with this program; if not, write to the Free Software
18: _## Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
19: _## MA 02110-1301 USA
20: _##
21: _##########################################################################*/
22:
23: package org.snmp4j.agent.agentx.event;
24:
25: import java.util.EventListener;
26:
27: /**
28: * A <code>PingListener</code> is interested in receiving PingEvent objects
29: * to control the ability of an AgentX peer (session) of processing requests.
30: *
31: * @author Frank Fock
32: * @version 1.0
33: */
34: public interface PingListener extends EventListener {
35:
36: /**
37: * A AgentX ping PDU has been sent and probably a corresponding response
38: * received.
39: * @param event
40: * the PingEvent generated. Depending on the ping history and local
41: * constraints a listener may set the closeSession and resetSession
42: * attributes to indicate that the session is no longer functional
43: * and should be closed or resetted.
44: */
45: void pinged(PingEvent event);
46:
47: }
|