https://openjdk.java.net/ 
/*
 * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package javax.sql;

import java.sql.*;


An object that contains information about the columns in a RowSet object. This interface is an extension of the ResultSetMetaData interface with methods for setting the values in a RowSetMetaData object. When a RowSetReader object reads data into a RowSet object, it creates a RowSetMetaData object and initializes it using the methods in the RowSetMetaData interface. Then the reader passes the RowSetMetaData object to the rowset. 
 The methods in this interface are invoked internally when an application calls the method RowSet.execute; an application programmer would not use them directly. 
Since:1.4
/**
 * An object that contains information about the columns in a
 * {@code RowSet} object.  This interface is
 * an extension of the {@code ResultSetMetaData} interface with
 * methods for setting the values in a {@code RowSetMetaData} object.
 * When a {@code RowSetReader} object reads data into a {@code RowSet}
 * object, it creates a {@code RowSetMetaData} object and initializes it
 * using the methods in the {@code RowSetMetaData} interface.  Then the
 * reader passes the {@code RowSetMetaData} object to the rowset.
 * <P>
 * The methods in this interface are invoked internally when an application
 * calls the method {@code RowSet.execute}; an application
 * programmer would not use them directly.
 *
 * @since 1.4
 */

public interface RowSetMetaData extends ResultSetMetaData {

  
Sets the number of columns in the RowSet object to the given number. 
Params:
  • columnCount – the number of columns in the RowSet object
Throws:
/**
   * Sets the number of columns in the {@code RowSet} object to
   * the given number.
   *
   * @param columnCount the number of columns in the {@code RowSet} object
   * @throws SQLException if a database access error occurs
   */
  void setColumnCount(int columnCount) throws SQLException;

  
Sets whether the designated column is automatically numbered, The default is for a RowSet object's columns not to be automatically numbered. 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • property – true if the column is automatically numbered; false if it is not
Throws:
/**
   * Sets whether the designated column is automatically numbered,
   * The default is for a {@code RowSet} object's
   * columns not to be automatically numbered.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param property {@code true} if the column is automatically
   *                 numbered; {@code false} if it is not
   *
   * @throws SQLException if a database access error occurs
   */
  void setAutoIncrement(int columnIndex, boolean property) throws SQLException;

  
Sets whether the designated column is case sensitive. The default is false. 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • property – true if the column is case sensitive; false if it is not
Throws:
/**
   * Sets whether the designated column is case sensitive.
   * The default is {@code false}.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param property {@code true} if the column is case sensitive;
   *                 {@code false} if it is not
   *
   * @throws SQLException if a database access error occurs
   */
  void setCaseSensitive(int columnIndex, boolean property) throws SQLException;

  
Sets whether the designated column can be used in a where clause. The default is false. 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • property – true if the column can be used in a WHERE clause; false if it cannot
Throws:
/**
   * Sets whether the designated column can be used in a where clause.
   * The default is {@code false}.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param property {@code true} if the column can be used in a
   *                 {@code WHERE} clause; {@code false} if it cannot
   *
   * @throws SQLException if a database access error occurs
   */
  void setSearchable(int columnIndex, boolean property) throws SQLException;

  
Sets whether the designated column is a cash value. The default is false. 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • property – true if the column is a cash value; false if it is not
Throws:
/**
   * Sets whether the designated column is a cash value.
   * The default is {@code false}.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param property {@code true} if the column is a cash value;
   *                 {@code false} if it is not
   *
   * @throws SQLException if a database access error occurs
   */
  void setCurrency(int columnIndex, boolean property) throws SQLException;

  
Sets whether the designated column's value can be set to NULL. The default is ResultSetMetaData.columnNullableUnknown 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • property – one of the following constants: ResultSetMetaData.columnNoNulls, ResultSetMetaData.columnNullable, or ResultSetMetaData.columnNullableUnknown
Throws:
/**
   * Sets whether the designated column's value can be set to
   * {@code NULL}.
   * The default is {@code ResultSetMetaData.columnNullableUnknown}
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param property one of the following constants:
   *                 {@code ResultSetMetaData.columnNoNulls},
   *                 {@code ResultSetMetaData.columnNullable}, or
   *                 {@code ResultSetMetaData.columnNullableUnknown}
   *
   * @throws SQLException if a database access error occurs
   */
  void setNullable(int columnIndex, int property) throws SQLException;

  
Sets whether the designated column is a signed number. The default is false. 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • property – true if the column is a signed number; false if it is not
Throws:
/**
   * Sets whether the designated column is a signed number.
   * The default is {@code false}.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param property {@code true} if the column is a signed number;
   *                 {@code false} if it is not
   *
   * @throws SQLException if a database access error occurs
   */
  void setSigned(int columnIndex, boolean property) throws SQLException;

  
Sets the designated column's normal maximum width in chars to the given int. 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • size – the normal maximum number of characters for
          the designated column
Throws:
/**
   * Sets the designated column's normal maximum width in chars to the
   * given {@code int}.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param size the normal maximum number of characters for
   *           the designated column
   *
   * @throws SQLException if a database access error occurs
   */
  void setColumnDisplaySize(int columnIndex, int size) throws SQLException;

  
Sets the suggested column title for use in printouts and displays, if any, to the given String. 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • label – the column title
Throws:
/**
   * Sets the suggested column title for use in printouts and
   * displays, if any, to the given {@code String}.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param label the column title
   * @throws SQLException if a database access error occurs
   */
  void setColumnLabel(int columnIndex, String label) throws SQLException;

  
Sets the name of the designated column to the given String. 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • columnName – the designated column's name
Throws:
/**
   * Sets the name of the designated column to the given {@code String}.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param columnName the designated column's name
   * @throws SQLException if a database access error occurs
   */
  void setColumnName(int columnIndex, String columnName) throws SQLException;

  
Sets the name of the designated column's table's schema, if any, to the given String. 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • schemaName – the schema name
Throws:
/**
   * Sets the name of the designated column's table's schema, if any, to
   * the given {@code String}.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param schemaName the schema name
   * @throws SQLException if a database access error occurs
   */
  void setSchemaName(int columnIndex, String schemaName) throws SQLException;

  
Sets the designated column's number of decimal digits to the given int. 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • precision – the total number of decimal digits
Throws:
/**
   * Sets the designated column's number of decimal digits to the
   * given {@code int}.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param precision the total number of decimal digits
   * @throws SQLException if a database access error occurs
   */
  void setPrecision(int columnIndex, int precision) throws SQLException;

  
Sets the designated column's number of digits to the right of the decimal point to the given int. 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • scale – the number of digits to right of decimal point
Throws:
/**
   * Sets the designated column's number of digits to the
   * right of the decimal point to the given {@code int}.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param scale the number of digits to right of decimal point
   * @throws SQLException if a database access error occurs
   */
  void setScale(int columnIndex, int scale) throws SQLException;

  
Sets the designated column's table name, if any, to the given String. 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • tableName – the column's table name
Throws:
/**
   * Sets the designated column's table name, if any, to the given
   * {@code String}.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param tableName the column's table name
   * @throws SQLException if a database access error occurs
   */
  void setTableName(int columnIndex, String tableName) throws SQLException;

  
Sets the designated column's table's catalog name, if any, to the given String. 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • catalogName – the column's catalog name
Throws:
/**
   * Sets the designated column's table's catalog name, if any, to the given
   * {@code String}.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param catalogName the column's catalog name
   * @throws SQLException if a database access error occurs
   */
  void setCatalogName(int columnIndex, String catalogName) throws SQLException;

  
Sets the designated column's SQL type to the one given.

Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • SQLType – the column's SQL type
Throws:
See Also:
/**
   * Sets the designated column's SQL type to the one given.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param SQLType the column's SQL type
   * @throws SQLException if a database access error occurs
   * @see Types
   */
  void setColumnType(int columnIndex, int SQLType) throws SQLException;

  
Sets the designated column's type name that is specific to the data source, if any, to the given String. 
Params:
  • columnIndex – the first column is 1, the second is 2, ...
  • typeName – data source specific type name.
Throws:
/**
   * Sets the designated column's type name that is specific to the
   * data source, if any, to the given {@code String}.
   *
   * @param columnIndex the first column is 1, the second is 2, ...
   * @param typeName data source specific type name.
   * @throws SQLException if a database access error occurs
   */
  void setColumnTypeName(int columnIndex, String typeName) throws SQLException;

}