http://hibernate.org: The core O/RM functionality as provided by Hibernate (Hibernate.org) 
/*
 * Hibernate, Relational Persistence for Idiomatic Java
 *
 * Copyright (c) 2010, Red Hat Inc. or third-party contributors as
 * indicated by the @author tags or express copyright attribution
 * statements applied by the authors.  All third-party contributions are
 * distributed under license by Red Hat Inc.
 *
 * This copyrighted material is made available to anyone wishing to use, modify,
 * copy, or redistribute it subject to the terms and conditions of the GNU
 * Lesser General Public License, as published by the Free Software Foundation.
 *
 * This program 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 Lesser General Public License
 * for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this distribution; if not, write to:
 * Free Software Foundation, Inc.
 * 51 Franklin Street, Fifth Floor
 * Boston, MA  02110-1301  USA
 */
package org.hibernate.engine.jdbc.spi;

import java.util.LinkedHashSet;
import java.util.Set;


Information extracted from DatabaseMetaData regarding what the JDBC driver reports as being supported or not. Obviously DatabaseMetaData reports many things, these are a few in which we have particular interest. 
Author:Steve Ebersole
/**
 * Information extracted from {@link java.sql.DatabaseMetaData} regarding what the JDBC driver reports as
 * being supported or not.  Obviously {@link java.sql.DatabaseMetaData} reports many things, these are a few in
 * which we have particular interest.
 *
 * @author Steve Ebersole
 */
@SuppressWarnings( {"UnusedDeclaration"})
public interface ExtractedDatabaseMetaData {
	
Which specification do the reported SQLState codes follow?

/**
	 * Which specification do the reported SQLState codes follow?
	 */
	public enum SQLStateType {
		
The reported codes follow the X/Open spec

/**
		 * The reported codes follow the X/Open spec
		 */
		XOpen,
		
The reported codes follow the SQL spec

/**
		 * The reported codes follow the SQL spec
		 */
		SQL99,
		
It is unknown.  Might follow another spec completely, or be a mixture.

/**
		 * It is unknown.  Might follow another spec completely, or be a mixture.
		 */
		UNKOWN
	}

	
Does the driver report supporting named parameters?

Returns:true indicates the driver reported true; false indicates the driver reported false or that the driver could not be asked.
/**
	 * Does the driver report supporting named parameters?
	 *
	 * @return {@code true} indicates the driver reported true; {@code false} indicates the driver reported false
	 * or that the driver could not be asked.
	 */
	public boolean supportsNamedParameters();

	
Does the driver report supporting REF_CURSORs?

Returns:true indicates the driver reported true; false indicates the driver reported false or that the driver could not be asked.
/**
	 * Does the driver report supporting REF_CURSORs?
	 *
	 * @return {@code true} indicates the driver reported true; {@code false} indicates the driver reported false
	 * or that the driver could not be asked.
	 */
	public boolean supportsRefCursors();

	
Did the driver report to supporting scrollable result sets?

See Also:
Returns:True if the driver reported to support ResultSet.TYPE_SCROLL_INSENSITIVE.
/**
	 * Did the driver report to supporting scrollable result sets?
	 *
	 * @return True if the driver reported to support {@link java.sql.ResultSet#TYPE_SCROLL_INSENSITIVE}.
	 *
	 * @see java.sql.DatabaseMetaData#supportsResultSetType
	 */
	public boolean supportsScrollableResults();

	
Did the driver report to supporting retrieval of generated keys?

See Also:
Returns:True if the if the driver reported to support calls to Statement.getGeneratedKeys
/**
	 * Did the driver report to supporting retrieval of generated keys?
	 *
	 * @return True if the if the driver reported to support calls to {@link java.sql.Statement#getGeneratedKeys}
	 *
	 * @see java.sql.DatabaseMetaData#supportsGetGeneratedKeys
	 */
	public boolean supportsGetGeneratedKeys();

	
Did the driver report to supporting batched updates?

See Also:
Returns:True if the driver supports batched updates
/**
	 * Did the driver report to supporting batched updates?
	 *
	 * @return True if the driver supports batched updates
	 *
	 * @see java.sql.DatabaseMetaData#supportsBatchUpdates
	 */
	public boolean supportsBatchUpdates();

	
Did the driver report to support performing DDL within transactions?

See Also:
Returns:True if the drivers supports DDL statements within transactions.
/**
	 * Did the driver report to support performing DDL within transactions?
	 *
	 * @return True if the drivers supports DDL statements within transactions.
	 *
	 * @see java.sql.DatabaseMetaData#dataDefinitionIgnoredInTransactions
	 */
	public boolean supportsDataDefinitionInTransaction();

	
Did the driver report to DDL statements performed within a transaction performing an implicit commit of the
transaction.

See Also:
Returns:True if the driver/database performs an implicit commit of transaction when DDL statement is
performed
/**
	 * Did the driver report to DDL statements performed within a transaction performing an implicit commit of the
	 * transaction.
	 *
	 * @return True if the driver/database performs an implicit commit of transaction when DDL statement is
	 * performed
	 *
	 * @see java.sql.DatabaseMetaData#dataDefinitionCausesTransactionCommit()
	 */
	public boolean doesDataDefinitionCauseTransactionCommit();

	
Get the list of extra keywords (beyond standard SQL92 keywords) reported by the driver.

See Also:
Returns:The extra keywords used by this database.
/**
	 * Get the list of extra keywords (beyond standard SQL92 keywords) reported by the driver.
	 *
	 * @return The extra keywords used by this database.
	 *
	 * @see java.sql.DatabaseMetaData#getSQLKeywords()
	 */
	public Set<String> getExtraKeywords();

	
Retrieve the type of codes the driver says it uses for SQLState. They might follow either the X/Open standard or the SQL92 standard. 
See Also:
Returns:The SQLState strategy reportedly used by this driver/database.
/**
	 * Retrieve the type of codes the driver says it uses for {@code SQLState}.  They might follow either
	 * the X/Open standard or the SQL92 standard.
	 *
	 * @return The SQLState strategy reportedly used by this driver/database.
	 *
	 * @see java.sql.DatabaseMetaData#getSQLStateType()
	 */
	public SQLStateType getSqlStateType();

	
Did the driver report that updates to a LOB locator affect a copy of the LOB?

See Also:
Returns:True if updates to the state of a LOB locator update only a copy.
/**
	 * Did the driver report that updates to a LOB locator affect a copy of the LOB?
	 *
	 * @return True if updates to the state of a LOB locator update only a copy.
	 *
	 * @see java.sql.DatabaseMetaData#locatorsUpdateCopy()
	 */
	public boolean doesLobLocatorUpdateCopy();

	
Retrieve the name of the schema in effect when we connected to the database.

Returns:The schema name
/**
	 * Retrieve the name of the schema in effect when we connected to the database.
	 *
	 * @return The schema name
	 */
	public String getConnectionSchemaName();

	
Retrieve the name of the catalog in effect when we connected to the database.

Returns:The catalog name
/**
	 * Retrieve the name of the catalog in effect when we connected to the database.
	 *
	 * @return The catalog name
	 */
	public String getConnectionCatalogName();

	
Set of type info reported by the driver.

See Also:
Returns:The type information obtained from the driver.
/**
	 * Set of type info reported by the driver.
	 *
	 * @return The type information obtained from the driver.
	 *
	 * @see java.sql.DatabaseMetaData#getTypeInfo()
	 */
	public LinkedHashSet<TypeInfo> getTypeInfoSet();
}