View Javadoc
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.datatype;
22  
23  /**
24   * A factory for creating {@link DataType}.
25   *
26   * @author Manuel Laflamme
27   * @since May 17, 2003
28   * @version $Revision$
29   */
30  public interface IDataTypeFactory
31  {
32      /**
33       * Returns the DataType object that corresponds to the specified
34       * {@link java.sql.Types}.
35       *
36       * @param sqlType SQL type from {@link java.sql.Types}
37       * @param sqlTypeName Data source dependent type name
38       */
39      public DataType createDataType(int sqlType, String sqlTypeName) throws DataTypeException;
40  
41      /**
42       * Returns the DataType object that corresponds to the specified
43       * {@link java.sql.Types} and regards the given tableName and columnName.
44       * When a {@link org.dbunit.dataset.datatype.ToleratedDeltaMap.ToleratedDelta} has been set 
45       * for a tableName.columnName set then this method automatically creates the correct 
46       * datatype that honours the tolerance value in the assertion.
47       *
48       * @param sqlType SQL type from {@link java.sql.Types}
49       * @param sqlTypeName Data source dependent type name
50       * @param tableName The database table for which the type is created
51       * @param columnName The database column in the given table for which the type is created
52       * 
53       * @since 2.3.0
54       */
55      public DataType createDataType(int sqlType, String sqlTypeName, String tableName, String columnName) 
56      	throws DataTypeException;
57  
58  }