databasemetadata.java

this gcc-g++-3.3.1.tar.gz is a source file of gcc, you can learn more about gcc through this codes f

/* DatabaseMetaData.java -- Information about the database itself.
   Copyright (C) 1999, 2000, 2001, 2002 Free Software Foundation, Inc.

This file is part of GNU Classpath.

GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
 
GNU Classpath 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 for more details.

You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING.  If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.

Linking this library statically or dynamically with other modules is
making a combined work based on this library.  Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.

As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module.  An independent module is a module which is not derived from
or based on this library.  If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so.  If you do not wish to do so, delete this
exception statement from your version. */

package java.sql;

public interface DatabaseMetaData 
{
  /**
   * It is unknown whether or not the procedure returns a result.
   */
  public static final int procedureResultUnknown = 0;

  /**
   * The procedure does not return a result.
   */
  public static final int procedureNoResult = 1;

  /**
   * The procedure returns a result.
   */
  public static final int procedureReturnsResult = 2;

  /**
   * The column type is unknown.
   */
  public static final int procedureColumnUnknown = 0;

  /**
   * The column type is input.
   */
  public static final int procedureColumnIn = 1;

  /**
   * The column type is input/output.
   */
  public static final int procedureColumnInOut = 2;

  /**
   * The column type is output
   */
  public static final int procedureColumnOut = 4;

  /**
   * The column is used for return values.
   */
  public static final int procedureColumnReturn = 5;

  /**
   * The column is used for storing results
   */
  public static final int procedureColumnResult = 3;

  /**
   * NULL values are not allowed.
   */
  public static final int procedureNoNulls = 0;

  /**
   * NULL values are allowed.
   */
  public static final int procedureNullable = 1;

  /**
   * It is unknown whether or not NULL values are allowed.
   */
  public static final int procedureNullableUnknown = 2;

  /**
   * The column does not allow NULL
   */
  public static final int columnNoNulls = 0;

  /**
   * The column does allow NULL
   */
  public static final int columnNullable = 1;

  /**
   * It is unknown whether or not the column allows NULL
   */
  public static final int columnNullableUnknown = 2;

  /**
   * The best row's scope is only guaranteed to be valid so long as the
   * row is actually being used.
   */
  public static final int bestRowTemporary = 0;

  /**
   * The best row identifier is valid to the end of the transaction.
   */
  public static final int bestRowTransaction = 1;

  /**
   * The best row identifier is valid to the end of the session.
   */
  public static final int bestRowSession = 2;

  /**
   * The best row may or may not be a pseudo-column.
   */
  public static final int bestRowUnknown = 0;

  /**
   * The best row identifier is not a pseudo-column.
   */
  public static final int bestRowNotPseudo = 1;

  /**
   * The best row identifier is a pseudo-column.
   */
  public static final int bestRowPseudo = 2;

  /**
   * It is unknown whether or not the version column is a pseudo-column.
   */
  public static final int versionColumnUnknown = 0;

  /**
   * The version column is not a pseudo-column
   */
  public static final int versionColumnNotPseudo = 1;

  /**
   * The version column is a pseudo-column
   */
  public static final int versionColumnPseudo = 2;

  /**
   * Foreign key changes are cascaded in updates or deletes.
   */
  public static final int importedKeyCascade = 0;

  /**
   * Column may not be updated or deleted in use as a foreign key.
   */
  public static final int importedKeyRestrict = 1;

  /**
   * When primary key is updated or deleted, the foreign key is set to NULL.
   */
  public static final int importedKeySetNull = 2;

  /**
   * If the primary key is a foreign key, it cannot be udpated or deleted.
   */
  public static final int importedKeyNoAction = 3;

  /**
   * If the primary key is updated or deleted, the foreign key is set to
   * a default value.
   */
  public static final int importedKeySetDefault = 4;

  /**
   * Wish I knew what this meant.
   */
  public static final int importedKeyInitiallyDeferred = 5;

  /**
   * Wish I knew what this meant.
   */
  public static final int importedKeyInitiallyImmediate = 6;

  /**
   * Wish I knew what this meant.
   */
  public static final int importedKeyNotDeferrable = 7;

  /**
   * A NULL value is not allowed for this data type.
   */
  public static final int typeNoNulls = 0;

  /**
   * A NULL value is allowed for this data type.
   */
  public static final int typeNullable = 1;

  /**
   * It is unknown whether or not NULL values are allowed for this data type.
   */
  public static final int typeNullableUnknown = 2;

  /**
   * Where clauses are not supported for this type.
   */
  public static final int typePredNone = 0;

  /**
   * Only "WHERE..LIKE" style WHERE clauses are allowed on this data type.
   */
  public static final int typePredChar = 1;

  /**
   * All WHERE clauses except "WHERE..LIKE" style are allowed on this data type.
   */
  public static final int typePredBasic = 2;

  /**
   * Any type of WHERE clause is allowed for this data type.
   */
  public static final int typeSearchable = 3;

  /**
   * This column contains table statistics.
   */
  public static final short tableIndexStatistic = 0;

  /**
   * This table index is clustered.
   */
  public static final short tableIndexClustered = 1;

  /**
   * This table index is hashed.
   */
  public static final short tableIndexHashed = 2;

  /**
   * This table index is of another type.
   */
  public static final short tableIndexOther = 3;

  public static final short attributeNoNulls = 0;

  public static final short attributeNullable = 1;

  public static final short attributeNullableUnknown = 2;

  public static final int sqlStateXOpen = 1;

  public static final int sqlStateSQL99 = 2;

  /**
   * This method tests whether or not all the procedures returned by
   * the <code>getProcedures</code> method can be called by this user.
   *
   * @return <code>true</code> if all the procedures can be called,
   * <code>false</code> otherwise.
   * @exception SQLException If an error occurs.
   */
  public boolean allProceduresAreCallable() throws SQLException;

  /**
   * This method tests whether or not all the table returned by the
   * <code>getTables</code> method can be selected by this user.
   *
   * @return <code>true</code> if all the procedures can be called,
   * <code>false</code> otherwise.
   *
   * @exception SQLException If an error occurs.
   */
  public boolean allTablesAreSelectable() throws SQLException;

  /**
   * This method returns the URL for this database.
   *
   * @return The URL string for this database, or <code>null</code> if it
   *         is not known.
   * @exception SQLException If an error occurs.
   */
  public String getURL() throws SQLException;

  /**
   * This method returns the database username for this connection.
   *
   * @return The database username.
   * @exception SQLException If an error occurs.
   */
  public String getUserName() throws SQLException;

  /**
   * This method tests whether or not the database is in read only mode.
   *
   * @return <code>true</code> if the database is in read only mode,
   *         <code>false</code> otherwise.
   * @exception SQLException If an error occurs.
   */
  public boolean isReadOnly() throws SQLException;

  /**
   * This method tests whether or not NULL's sort as high values.
   *
   * @return <code>true</code> if NULL's sort as high values, <code>false</code>
   *         otherwise.
   * @exception SQLException If an error occurs.
   */
  public boolean nullsAreSortedHigh() throws SQLException;

  /**
   * This method tests whether or not NULL's sort as low values.
   *
   * @return <code>true</code> if NULL's sort as low values, <code>false</code>
   * otherwise.
   * @exception SQLException If an error occurs.
   */
  public boolean nullsAreSortedLow() throws SQLException;

  /**
   * This method tests whether or not NULL's sort as high values.
   *
   * @return <code>true</code> if NULL's sort as high values, <code>false</code>
   * otherwise.
   * @exception SQLException If an error occurs.
   */
  public boolean nullsAreSortedAtStart() throws SQLException;

  /**
   * This method test whether or not NULL's are sorted to the end
   * of the list regardless of ascending or descending sort order.
   *
   * @return <code>true</code> if NULL's always sort to the end,
   * <code>false</code> otherwise.
   * @exception SQLException If an error occurs.
   */
  public boolean nullsAreSortedAtEnd() throws SQLException;

  /**
   * This method returns the name of the database product.
   *
   * @return The database product.
   * @exception SQLException If an error occurs.
   */