KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > javax > sql > RowSetListener


1 /*
2  * @(#)RowSetListener.java 1.9 03/12/19
3  *
4  * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
5  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
6  */
7
8 package javax.sql;
9
10 /**
11  * An interface that must be implemented by a
12  * component that wants to be notified when a significant
13  * event happens in the life of a <code>RowSet</code> object.
14  * A component becomes a listener by being registered with a
15  * <code>RowSet</code> object via the method <code>RowSet.addRowSetListener</code>.
16  * How a registered component implements this interface determines what it does
17  * when it is notified of an event.
18  *
19  * @since 1.4
20  */
21
22 public interface RowSetListener extends java.util.EventListener JavaDoc {
23
24   /**
25    * Notifies registered listeners that a <code>RowSet</code> object
26    * in the given <code>RowSetEvent</code> object has changed its entire contents.
27    * <P>
28    * The source of the event can be retrieved with the method
29    * <code>event.getSource</code>.
30    *
31    * @param event a <code>RowSetEvent</code> object that contains
32    * the <code>RowSet</code> object that is the source of the event
33    */
34   void rowSetChanged(RowSetEvent JavaDoc event);
35
36   /**
37    * Notifies registered listeners that a <code>RowSet</code> object
38    * has had a change in one of its rows.
39    * <P>
40    * The source of the event can be retrieved with the method
41    * <code>event.getSource</code>.
42    *
43    * @param event a <code>RowSetEvent</code> object that contains
44    * the <code>RowSet</code> object that is the source of the event
45    */
46   void rowChanged(RowSetEvent JavaDoc event);
47
48   /**
49    * Notifies registered listeners that a <code>RowSet</code> object's
50    * cursor has moved.
51    * <P>
52    * The source of the event can be retrieved with the method
53    * <code>event.getSource</code>.
54    *
55    * @param event a <code>RowSetEvent</code> object that contains
56    * the <code>RowSet</code> object that is the source of the event
57    */
58   void cursorMoved(RowSetEvent JavaDoc event);
59 }
60
Popular Tags