ITable.java

  1. /*
  2.  *
  3.  * The DbUnit Database Testing Framework
  4.  * Copyright (C)2002-2004, DbUnit.org
  5.  *
  6.  * This library is free software; you can redistribute it and/or
  7.  * modify it under the terms of the GNU Lesser General Public
  8.  * License as published by the Free Software Foundation; either
  9.  * version 2.1 of the License, or (at your option) any later version.
  10.  *
  11.  * This library is distributed in the hope that it will be useful,
  12.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14.  * Lesser General Public License for more details.
  15.  *
  16.  * You should have received a copy of the GNU Lesser General Public
  17.  * License along with this library; if not, write to the Free Software
  18.  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  19.  *
  20.  */

  21. package org.dbunit.dataset;


  22. /**
  23.  * A table represents a collection of tabular data.
  24.  *
  25.  * @author Manuel Laflamme
  26.  * @version $Revision$
  27.  * @since Feb 17, 2002
  28.  */
  29. public interface ITable
  30. {
  31.     public static final Object NO_VALUE = new Object();

  32.     /**
  33.      * Returns this table metadata.
  34.      */
  35.     public ITableMetaData getTableMetaData();

  36.     /**
  37.      * Returns this table row count.
  38.      */
  39.     public int getRowCount();

  40.     /**
  41.      * Returns this table value for the specified row and column.
  42.      * @param row The row index, starting with 0
  43.      * @param column The name of the column
  44.      * @return The value
  45.      *
  46.      * @throws NoSuchColumnException if specified column name do not exist in
  47.      * this table
  48.      * @throws RowOutOfBoundsException if specified row is less than zero or
  49.      * equals or greater than <code>getRowCount</code>
  50.      */
  51.     public Object getValue(int row, String column) throws DataSetException;
  52. }