01: /*_############################################################################
02: _##
03: _## SNMP4J-Agent - MOChangeListener.java
04: _##
05: _## Copyright (C) 2005-2007 Frank Fock (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.agent.mo;
22:
23: import java.util.*;
24:
25: /**
26: * A <code>MOChangeListener</code> is informed about changes and change attempts
27: * of managed objects. By changing the deny reason member of the supplied
28: * event object changes can also be canceled.
29: *
30: * @author Frank Fock
31: * @version 1.0
32: */
33: public interface MOChangeListener extends EventListener {
34:
35: /**
36: * A ManagedObject change is being prepared. To cancel preparation set the
37: * deny reason to a SNMPv2/v3 error status.
38: * @param changeEvent
39: * the change event object.
40: */
41: void beforePrepareMOChange(MOChangeEvent changeEvent);
42:
43: /**
44: * A change has been prepared. Setting the deny reason of the supplied event
45: * object will be ignored.
46: * @param changeEvent
47: * the change event object.
48: */
49: void afterPrepareMOChange(MOChangeEvent changeEvent);
50:
51: /**
52: * A ManagedObject change is being committed. To cancel the commit phase set
53: * the deny reason to a SNMPv2/v3 error status.
54: * <p>
55: * NOTE: Canceling the commit phase must be avoided. Setting a deny reason
56: * has only an effect if {@link MOChangeEvent#isDeniable()} returns
57: * <code>true</code>. Otherwise, you will need to throw an exception.
58: *
59: * @param changeEvent
60: * the change event object.
61: */
62: void beforeMOChange(MOChangeEvent changeEvent);
63:
64: /**
65: * A change has been committed. Setting the deny reason of the supplied event
66: * object will be ignored.
67: * @param changeEvent
68: * the change event object.
69: */
70: void afterMOChange(MOChangeEvent changeEvent);
71:
72: }
|