/*
 * Hibernate, Relational Persistence for Idiomatic Java
 *
 * License: GNU Lesser General Public License (LGPL), version 2.1 or later.
 * See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
 */
package org.hibernate.tool.schema;

import java.util.Map;

import org.hibernate.cfg.AvailableSettings;
import org.hibernate.internal.util.StringHelper;
import org.hibernate.internal.util.config.ConfigurationHelper;

Author:Andrea Boriero
/** * @author Andrea Boriero */
public enum JdbcMetadaAccessStrategy {
The SchemaMigrator and SchemaValidator execute one DatabaseMetaData.getTables(String, String, String, String[]) call for each Entity in order to determine if a corresponding database table exists.
/** * The {@link org.hibernate.tool.schema.spi.SchemaMigrator} and {@link org.hibernate.tool.schema.spi.SchemaValidator} * execute one {@link java.sql.DatabaseMetaData#getTables(String, String, String, String[])} call for each * {@link javax.persistence.Entity} in order to determine if a corresponding database table exists. */
INDIVIDUALLY( "individually" ),
The SchemaMigrator and SchemaValidator execute a single DatabaseMetaData.getTables(String, String, String, String[]) call to retrieve all the database table in order to determine all the Entity have a mapped database tables.

This strategy is the default one and it may require AvailableSettings.DEFAULT_CATALOG and/or AvailableSettings.DEFAULT_SCHEMA values to be provided.

/** * The {@link org.hibernate.tool.schema.spi.SchemaMigrator} and {@link org.hibernate.tool.schema.spi.SchemaValidator} * execute a single {@link java.sql.DatabaseMetaData#getTables(String, String, String, String[])} call * to retrieve all the database table in order to determine all the {@link javax.persistence.Entity} have a mapped database tables. * <p> * This strategy is the default one and it may require {@link AvailableSettings#DEFAULT_CATALOG} and/or * {@link AvailableSettings#DEFAULT_SCHEMA} values to be provided. */
GROUPED( "grouped" ); private final String strategy; JdbcMetadaAccessStrategy(String strategy) { this.strategy = strategy; } @Override public String toString() { return strategy; } public static JdbcMetadaAccessStrategy interpretSetting(Map options) { if ( options == null ) { return interpretHbm2ddlSetting( null ); } else if ( ConfigurationHelper.getBoolean( AvailableSettings.ENABLE_SYNONYMS, options, false ) ) { // Use of synonyms can cause issues during schema validation or schema update when GROUPED strategy is used (especially in Oracle) return INDIVIDUALLY; } else { return interpretHbm2ddlSetting( options.get( AvailableSettings.HBM2DDL_JDBC_METADATA_EXTRACTOR_STRATEGY ) ); } } public static JdbcMetadaAccessStrategy interpretHbm2ddlSetting(Object value) { if ( value == null ) { return GROUPED; } else { final String name = value.toString(); if ( StringHelper.isEmpty( name ) || GROUPED.strategy.equals( name ) ) { return GROUPED; } else if ( INDIVIDUALLY.strategy.equals( name ) ) { return INDIVIDUALLY; } else { throw new IllegalArgumentException( "Unrecognized `" + AvailableSettings.HBM2DDL_JDBC_METADATA_EXTRACTOR_STRATEGY + "` value : " + name ); } } } }