KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > snmp4j > agent > mo > MOChangeListener


1 /*_############################################################################
2   _##
3   _## SNMP4J-Agent - MOChangeListener.java
4   _##
5   _## Copyright (C) 2005-2007 Frank Fock (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 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 }
73
Popular Tags