databasemetadata.java

gcc的组建

/* 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., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301 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.
   */
  int procedureResultUnknown = 0;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  short attributeNoNulls = 0;

  short attributeNullable = 1;

  short attributeNullableUnknown = 2;

  int sqlStateXOpen = 1;

  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.
   */
  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.
   */
  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.
   */
  String getURL() throws SQLException;

  /**
   * This method returns the database username for this connection.
   *
   * @return The database username.
   * @exception SQLException If an error occurs.
   */
  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.
   */
  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.
   */
  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.
   */
  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.
   */
  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.
   */
  boolean nullsAreSortedAtEnd() throws SQLException;

  /**
   * This method returns the name of the database product.
   *
   * @return The database product.
   * @exception SQLException If an error occurs.
   */
  String getDatabaseProductName() throws SQLException;

  /**
   * This method returns the version of the database product.
   *