datalist.java

以前写的通用数据库接口

package util.database.datalist;

/**
 * DataList
 *
 * 通用的接口，表示一个查询结果(ResultSet或者RowSet)的集和。
 * @author Michael Zeng
 * @version 1.0 September 20, 2002
 */
public interface DataList
{
    /**
     * 取出指定位置查询结果中的字段值，放到一个字符串数组中并返回。
     * 功能类似于java.util.List.get(int)
     *
     * @param index 查询结果的索引
     * @return String[] 结果中的字段值数组
     *
     * @throws Exception
     */
    public String[] get(int index) throws Exception;

    /**
     * 检查查询结果的集和是否为空集合
     *
     * @return boolean true表示空集合
     * @throws Exception
     */
    public boolean isEmpty() throws Exception;

    /**
     * 检查是否还有下一个查询结果
     *
     * @return boolean true表示有下一个
     * @throws Exception
     */
    public boolean hasNext() throws Exception;

    /**
     * 检查在指定位置上是否有查询结果
     *
     * @param index 查询结果的索引
     * @return boolean true表示有查询结果
     * @throws Exception
     */
    public boolean isElementExist(int index) throws Exception;

    /**
     * 把游标放到指定的位置上,功能类似于java.sql.ResultSet.absolute(int)
     *
     * @param index 指定的位置，从0开始
     * @return boolean true表示操作成功
     * @throws Exception
     */
    public boolean absolute(int index) throws Exception;

    /**
     * 把游标放到查询结果的最前面,功能类似于java.sql.ResultSet.beforeFirst()
     *
     * @throws Exception
     */
    public void beforeFirst() throws Exception;

    /**
     * 把游标放到查询结果的第一个,功能类似于java.sql.ResultSet.first()
     *
     * @return boolean true表示移动成功
     * @throws Exception
     */
    public boolean first() throws Exception;

    /**
     * 把游标放到查询结果的最后一个,功能类似于java.sql.ResultSet.last()
     *
     * @return boolean true表示移动成功
     * @throws Exception
     */
    public boolean last() throws Exception;

    /**
     * 取得整个查询结果的大小,功能类似于java.util.List.size()
     *
     * @return size 查询结果的大小
     * @throws Exception
     */
    public int size() throws Exception;

    /**
     * 提供一个可以遍历查询结果的对象，功能类似于java.util.List.iterator()
     *
     * @return DataListIterator 可以遍历查询结果的对象
     * @throws Exception
     */
    public DataListIterator iterator() throws Exception;


}