KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > sapia > util > cursor > CursorListener


1 package org.sapia.util.cursor;
2
3 /**
4  * @author Yanick Duchesne
5  *
6  * <dl>
7  * <dt><b>Copyright: </b>
8  * <dd>Copyright &#169; 2002-2004 <a HREF="http://www.sapia-oss.org">Sapia Open
9  * Source Software </a>. All Rights Reserved.</dd>
10  * </dt>
11  * <dt><b>License: </b>
12  * <dd>Read the license.txt file of the jar or visit the <a
13  * HREF="http://www.sapia-oss.org/license.html">license page </a> at the Sapia
14  * OSS web site</dd>
15  * </dt>
16  * </dl>
17  */
18 public interface CursorListener {
19
20   /**
21    * This method is called by the <code>Cursor</code> to which this instance
22    * is associated on the call to the <code>next()</code> method (on the
23    * cursor). This allows this method to actually initialize the state of the
24    * returned object before it is handed over to the client application.
25    * <p>
26    * For example, the given object might be some lazily initializable place
27    * holder that is kept in place of the original object, in order to spare
28    * resources.
29    *
30    * @param next
31    * the "next" <code>Object</code>.
32    */
33   public void onNext(Object JavaDoc next) throws Exception JavaDoc;
34
35 }
36
Popular Tags