retrievevaluebynameiteratorinf.java

来自「这是一个mvc模式」· Java 代码 · 共 37 行

package jsp.tags.dapact.tags.data;

/**
 * Title:        Data Aware Processing And Control Tags
 * Description:  Tag library for the processing and controlling the input and output of data.
 * Copyright:    LGPL (http://www.gnu.org/copyleft/lesser.html)
 * Compile Date: @compile_date@      
 * @author Allen M Servedio
 * @amp_sign@version @VERSION@
 */

/**
 * Interface that should be implemented by classes that want to provide values by name
 * and iterate over a group of data.
 */
public interface RetrieveValueByNameIteratorInf extends RetrieveValueByNameInf
{
  /**
   * This function is called to tell the sub class to advance to the next group of
   * data.
   *
   * @return this function should return <code>true</code> until there is no more data,
   *   then it should return <code>false</code>.
   */
  public boolean next() throws DataException;

  /**
   * This function should be called when processing is done or is aborted (so that sub
   * classes can close their resources). This function should be able to handle multiple
   * calls to it without causing an error (so, it the iterator calls it and then the
   * finalize() method calls it, the only exceptions that should occur are in the first
   * call when it tries to close the resources). Subsequent calls should probably be
   * ignored, unless there is a reason to try again.
   */
  public void close() throws DataException;
}