Mappings (Red Hat JBoss Enterprise Application Platform 6.4.19.GA public API)

All Known Subinterfaces:

ExtendedMappings

All Known Implementing Classes:

AnnotationConfiguration.ExtendedMappingsImpl, Configuration.MappingsImpl
```
public interface Mappings
```
A collection of mappings from classes and collections to relational database tables. Represents a single <hibernate-mapping> element.
todo : the statement about this representing a single mapping element is simply not true if it was ever the case. this contract actually represents 3 scopes of information:
1. bounded state : this is information which is indeed scoped by a single mapping
2. unbounded state : this is information which is Configuration wide (think of metadata repository)
3. transient state : state which changed at its own pace (naming strategy)
Author:

Gavin King, Steve Ebersole

Nested Class Summary

Nested Classes
Modifier and Type Interface and Description

static class Mappings.PropertyReference
Represents a property-ref mapping.

Nested Classes
Modifier and Type	Interface and Description
`static class`	`Mappings.PropertyReference` Represents a property-ref mapping.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addAnyMetaDef(AnyMetaDef defAnn)`
`void`	`addAuxiliaryDatabaseObject(AuxiliaryDatabaseObject auxiliaryDatabaseObject)` Add metadata pertaining to an auxiliary database object to this repository.
`void`	`addClass(PersistentClass persistentClass)` Add entity mapping metadata.
`AnnotatedClassType`	`addClassType(XClass clazz)` FIXME should be private but will this break things? Add a class type.
`void`	`addCollection(Collection collection)` Add collection mapping metadata to this repository.
`void`	`addColumnBinding(String logicalName, Column physicalColumn, Table table)` Binds the given 'physicalColumn' to the give 'logicalName' within the given 'table'.
`void`	`addDefaultGenerator(IdGenerator generator)` Adds a default id generator.
`void`	`addDefaultQuery(String name, NamedQueryDefinition query)`
`void`	`addDefaultResultSetMapping(ResultSetMappingDefinition definition)`
`void`	`addDefaultSQLQuery(String name, NamedSQLQueryDefinition query)`
`Table`	`addDenormalizedTable(String schema, String catalog, String name, boolean isAbstract, String subselect, Table includedTable)` Adds a 'denormalized table' to this repository.
`void`	`addFilterDefinition(FilterDefinition definition)` Adds a filter definition to this repository.
`void`	`addGenerator(IdGenerator generator)` Add a generator.
`void`	`addGeneratorTable(String name, Properties params)` Add a generator table properties.
`void`	`addImport(String entityName, String rename)` Adds an import (HQL entity rename) to the repository.
`void`	`addJoins(PersistentClass persistentClass, Map<String,Join> joins)` Add join metadata for a persistent entity.
`void`	`addMappedBy(String entityName, String propertyName, String inversePropertyName)`
`void`	`addMappedSuperclass(Class type, MappedSuperclass mappedSuperclass)` add a new MappedSuperclass This should not be called if the MappedSuperclass already exists (it would be erased)
`void`	`addPropertyAnnotatedWithMapsId(XClass entityType, PropertyData property)`
`void`	`addPropertyAnnotatedWithMapsIdSpecj(XClass entityType, PropertyData property, String mapsIdValue)`
`void`	`addPropertyReference(String referencedClass, String propertyName)` Adds a property reference binding to this repository.
`void`	`addPropertyReferencedAssociation(String entityName, String propertyName, String propertyRef)`
`void`	`addQuery(String name, NamedQueryDefinition query)` Adds metadata for a named query to this repository.
`void`	`addResultSetMapping(ResultSetMappingDefinition sqlResultSetMapping)` Adds the metadata for a named SQL result set mapping to this repository.
`void`	`addSecondPass(SecondPass sp)` Adds a second-pass to the end of the current queue.
`void`	`addSecondPass(SecondPass sp, boolean onTopOfTheQueue)` Adds a second pass.
`void`	`addSQLQuery(String name, NamedSQLQueryDefinition query)` Adds metadata for a named SQL query to this repository.
`Table`	`addTable(String schema, String catalog, String name, String subselect, boolean isAbstract)` Adds table metadata to this repository returning the created metadata instance.
`void`	`addTableBinding(String schema, String catalog, String logicalName, String physicalName, Table denormalizedSuperTable)` Adds a table binding to this repository.
`void`	`addToExtendsQueue(ExtendsQueueEntry entry)` Adds an entry to the extends queue queue.
`void`	`addToOneAndIdProperty(XClass entity, PropertyData property)`
`void`	`addTypeDef(String typeName, String typeClass, Properties paramMap)` Adds a type definition to this metadata repository.
`void`	`addUniqueConstraintHolders(Table table, List<UniqueConstraintHolder> uniqueConstraintHolders)`
`void`	`addUniqueConstraints(Table table, List uniqueConstraints)` Deprecated. Use `addUniqueConstraintHolders(org.hibernate.mapping.Table, java.util.List<org.hibernate.cfg.UniqueConstraintHolder>)` instead
`void`	`addUniquePropertyReference(String referencedClass, String propertyName)` Adds a property reference binding to this repository where said proeprty reference is marked as unique.
`FetchProfile`	`findOrCreateFetchProfile(String name, MetadataSource source)` Retrieves a fetch profile by either finding one currently in this repository matching the given name or by creating one (and adding it).
`boolean`	`forceDiscriminatorInSelectsByDefault()`
`AnyMetaDef`	`getAnyMetaDef(String name)`
`String`	`getCatalogName()` Returns the currently bound default catalog name.
`PersistentClass`	`getClass(String entityName)` Retrieves the entity mapping metadata for the given entity name.
`Map`	`getClasses()`
`AnnotatedClassType`	`getClassType(XClass clazz)` Get and maintain a cache of class type.
`Collection`	`getCollection(String role)` Retrieves the collection mapping metadata for the given collection role.
`Properties`	`getConfigurationProperties()` Retrieve the configuration properties currently in effect.
`String`	`getDefaultAccess()` Get the current default property access style.
`String`	`getDefaultCascade()` Get the current default cascade style.
`String`	`getDefaultPackage()` Get the currently bound default package name.
`FilterDefinition`	`getFilterDefinition(String name)` Retrieves a filter definition by name.
`Map`	`getFilterDefinitions()` Retrieves the copmplete map of filter definitions.
`String`	`getFromMappedBy(String entityName, String propertyName)`
`IdGenerator`	`getGenerator(String name)` Retrieve the id-generator by name.
`IdGenerator`	`getGenerator(String name, Map<String,IdGenerator> localGenerators)` Try to find the generator from the localGenerators and then from the global generator list
`Properties`	`getGeneratorTableProperties(String name, Map<String,Properties> localGeneratorTables)` Retrieve the properties related to a generator table.
`MutableIdentifierGeneratorFactory`	`getIdentifierGeneratorFactory()` Retrieve the IdentifierGeneratorFactory in effect for this mapping.
`Map<String,Join>`	`getJoins(String entityName)` Retrieve join metadata for a particular persistent entity.
`String`	`getLogicalColumnName(String physicalName, Table table)` Find the logical column name against whcih the given physical column name was bound within the given table.
`String`	`getLogicalTableName(Table table)` Get the logical table name mapped for the given physical table.
`MappedSuperclass`	`getMappedSuperclass(Class type)` Get a MappedSuperclass or null if not mapped
`NamingStrategy`	`getNamingStrategy()` Deprecated. Use `getNamingStrategyDelegator()` instead.
`NamingStrategyDelegator`	`getNamingStrategyDelegator()` Get the current naming strategy delegate.
`ObjectNameNormalizer`	`getObjectNameNormalizer()` Retrieve the database identifier normalizer for this context.
`String`	`getPhysicalColumnName(String logicalName, Table table)` Find the physical column name for the given logical column name within the given table.
`PropertyData`	`getPropertyAnnotatedWithIdAndToOne(XClass entityType, String propertyName)` Return the property annotated with @ToOne and @Id if any.
`PropertyData`	`getPropertyAnnotatedWithMapsId(XClass entityType, String propertyName)` Return the property annotated with @MapsId("propertyName") if any.
`String`	`getPropertyReferencedAssociation(String entityName, String propertyName)`
`NamedQueryDefinition`	`getQuery(String name)` Get named query metadata by name.
`ReflectionManager`	`getReflectionManager()`
`ResultSetMappingDefinition`	`getResultSetMapping(String name)` Get the metadata for a named SQL result set mapping.
`String`	`getSchemaName()` Returns the currently bound default schema name.
`NamedSQLQueryDefinition`	`getSQLQuery(String name)` Get named SQL query metadata.
`Table`	`getTable(String schema, String catalog, String name)` Returns the named table metadata.
`Map<Table,List<String[]>>`	`getTableUniqueConstraints()` Deprecated. Use `getUniqueConstraintHoldersByTable()` instead
`TypeDef`	`getTypeDef(String typeName)` Retrieve a type definition by name.
`TypeResolver`	`getTypeResolver()` Retrieve the type resolver in effect.
`Map<Table,List<UniqueConstraintHolder>>`	`getUniqueConstraintHoldersByTable()`
`boolean`	`ignoreExplicitDiscriminatorColumnForJoinedInheritance()` Should we ignore explicit DiscriminatorColumn annotations when combined with joined inheritance?
`boolean`	`isAutoImport()` Determine whether auto importing of entity names is currently enabled.
`boolean`	`isDefaultLazy()` Determine whether default laziness is currently enabled.
`boolean`	`isInSecondPass()`
`boolean`	`isSpecjProprietarySyntaxEnabled()`
`Iterator<AuxiliaryDatabaseObject>`	`iterateAuxiliaryDatabaseObjects()` Retrieves an iterator over the metadata pertaining to all auxiliary database objects int this repository.
`ListIterator<AuxiliaryDatabaseObject>`	`iterateAuxiliaryDatabaseObjectsInReverse()` Same as `iterateAuxiliaryDatabaseObjects()` except that here the iterator is reversed.
`Iterator<AuxiliaryDatabaseObject>`	`iterateAuxliaryDatabaseObjects()` Deprecated. To fix misspelling; use `iterateAuxiliaryDatabaseObjects()` instead
`ListIterator<AuxiliaryDatabaseObject>`	`iterateAuxliaryDatabaseObjectsInReverse()` Deprecated. To fix misspelling; use `iterateAuxiliaryDatabaseObjectsInReverse()` instead
`Iterator<PersistentClass>`	`iterateClasses()` Retrieves an iterator over the entity metadata present in this repository.
`Iterator<Collection>`	`iterateCollections()` Returns an iterator over collection metadata.
`Iterator<Table>`	`iterateTables()` Returns an iterator over table metadata.
`PersistentClass`	`locatePersistentClassByEntityName(String entityName)` Retrieves the entity mapping metadata for the given entity name, potentially accounting for imports.
`void`	`setAutoImport(boolean autoImport)` Set whether to enable auto importing of entity names.
`void`	`setCatalogName(String catalogName)` Sets the currently bound default catalog name.
`void`	`setDefaultAccess(String defaultAccess)` Sets the current default property access style.
`void`	`setDefaultCascade(String defaultCascade)` Sets the current default cascade style.
`void`	`setDefaultLazy(boolean defaultLazy)` Set whether to enable default laziness.
`void`	`setDefaultPackage(String defaultPackage)` Set the current default package name.
`void`	`setNamingStrategy(NamingStrategy namingStrategy)` Deprecated. Use `setNamingStrategyDelegator(org.hibernate.cfg.naming.NamingStrategyDelegator)` instead.
`void`	`setNamingStrategyDelegator(NamingStrategyDelegator namingStrategyDelegator)` Set a current naming strategy delegator.
`void`	`setSchemaName(String schemaName)` Sets the currently bound default schema name.
`boolean`	`useImplicitDiscriminatorColumnForJoinedInheritance()` Should we handle absent DiscriminatorColumn mappings for joined inheritance by implicitly mapping a discriminator column?
`boolean`	`useNationalizedCharacterData()` Should we use nationalized variants of character data by default? This is controlled by the `AvailableSettings.USE_NATIONALIZED_CHARACTER_DATA` setting.
`boolean`	`useNewGeneratorMappings()` Should we use the new generator strategy mappings.

- Method Detail
  - getTypeResolver
```
TypeResolver getTypeResolver()
```
    Retrieve the type resolver in effect.
    
    Returns:
    The type resolver.
  - getNamingStrategy
```
@Deprecated
NamingStrategy getNamingStrategy()
```
    Deprecated. Use getNamingStrategyDelegator() instead.
    
    Get the current naming strategy.
    
    Returns:
    The current naming strategy.
  - setNamingStrategy
```
@Deprecated
void setNamingStrategy(NamingStrategy namingStrategy)
```
    Deprecated. Use setNamingStrategyDelegator(org.hibernate.cfg.naming.NamingStrategyDelegator) instead.
    
    Set the current naming strategy. An instance of LegacyNamingStrategyDelegator will be constructed with the specified naming strategy.
    
    Parameters:
    namingStrategy - the NamingStrategy to set; must be non-null.
    See Also:
    LegacyNamingStrategyDelegator.LegacyNamingStrategyDelegator(NamingStrategy)
  - getNamingStrategyDelegator
```
NamingStrategyDelegator getNamingStrategyDelegator()
```
    Get the current naming strategy delegate.
    
    Returns:
    The current naming strategy delegate.
  - setNamingStrategyDelegator
```
void setNamingStrategyDelegator(NamingStrategyDelegator namingStrategyDelegator)
```
    Set a current naming strategy delegator.
    
    Parameters:
    namingStrategyDelegator - the NamingStrategyDelegator to set; must be non-null; if namingStrategyDelegator is an instance of LegacyNamingStrategyDelegator, then LegacyNamingStrategyDelegator.getNamingStrategy() must be non-null.
  - getSchemaName
```
String getSchemaName()
```
    Returns the currently bound default schema name.
    
    Returns:
    The currently bound schema name
  - setSchemaName
```
void setSchemaName(String schemaName)
```
    Sets the currently bound default schema name.
    
    Parameters:
    schemaName - The schema name to bind as the current default.
  - getCatalogName
```
String getCatalogName()
```
    Returns the currently bound default catalog name.
    
    Returns:
    The currently bound catalog name, or null if none.
  - setCatalogName
```
void setCatalogName(String catalogName)
```
    Sets the currently bound default catalog name.
    
    Parameters:
    catalogName - The catalog name to use as the current default.
  - getDefaultPackage
```
String getDefaultPackage()
```
    Get the currently bound default package name.
    
    Returns:
    The currently bound default package name
  - setDefaultPackage
```
void setDefaultPackage(String defaultPackage)
```
    Set the current default package name.
    
    Parameters:
    defaultPackage - The package name to set as the current default.
  - isAutoImport
```
boolean isAutoImport()
```
    Determine whether auto importing of entity names is currently enabled.
    
    Returns:
    True if currently enabled; false otherwise.
  - setAutoImport
```
void setAutoImport(boolean autoImport)
```
    Set whether to enable auto importing of entity names.
    
    Parameters:
    autoImport - True to enable; false to diasable.
    See Also:
    addImport(java.lang.String, java.lang.String)
  - isDefaultLazy
```
boolean isDefaultLazy()
```
    Determine whether default laziness is currently enabled.
    
    Returns:
    True if enabled, false otherwise.
  - setDefaultLazy
```
void setDefaultLazy(boolean defaultLazy)
```
    Set whether to enable default laziness.
    
    Parameters:
    defaultLazy - True to enable, false to disable.
  - getDefaultCascade
```
String getDefaultCascade()
```
    Get the current default cascade style.
    
    Returns:
    The current default cascade style.
  - setDefaultCascade
```
void setDefaultCascade(String defaultCascade)
```
    Sets the current default cascade style. .
    
    Parameters:
    defaultCascade - The cascade style to set as the current default.
  - getDefaultAccess
```
String getDefaultAccess()
```
    Get the current default property access style.
    
    Returns:
    The current default property access style.
  - setDefaultAccess
```
void setDefaultAccess(String defaultAccess)
```
    Sets the current default property access style.
    
    Parameters:
    defaultAccess - The access style to use as the current default.
  - iterateClasses
```
Iterator<PersistentClass> iterateClasses()
```
    Retrieves an iterator over the entity metadata present in this repository.
    
    Returns:
    Iterator over class metadata.
  - getClass
```
PersistentClass getClass(String entityName)
```
    Retrieves the entity mapping metadata for the given entity name.
    
    Parameters:
    entityName - The entity name for which to retrieve the metadata.
    
    Returns:
    The entity mapping metadata, or null if none found matching given entity name.
  - locatePersistentClassByEntityName
```
PersistentClass locatePersistentClassByEntityName(String entityName)
```
    Retrieves the entity mapping metadata for the given entity name, potentially accounting for imports.
    
    Parameters:
    entityName - The entity name for which to retrieve the metadata.
    
    Returns:
    The entity mapping metadata, or null if none found matching given entity name.
  - addClass
```
void addClass(PersistentClass persistentClass)
              throws DuplicateMappingException
```
    Add entity mapping metadata.
    
    Parameters:
    persistentClass - The entity metadata
    
    Throws:
    
    DuplicateMappingException - Indicates there4 was already an extry corresponding to the given entity name.
  - addImport
```
void addImport(String entityName,
             String rename)
               throws DuplicateMappingException
```
    Adds an import (HQL entity rename) to the repository.
    
    Parameters:
    entityName - The entity name being renamed.
    rename - The rename
    
    Throws:
    
    DuplicateMappingException - If rename already is mapped to another entity name in this repository.
  - getCollection
```
Collection getCollection(String role)
```
    Retrieves the collection mapping metadata for the given collection role.
    
    Parameters:
    role - The collection role for which to retrieve the metadata.
    
    Returns:
    The collection mapping metadata, or null if no matching collection role found.
  - iterateCollections
```
Iterator<Collection> iterateCollections()
```
    Returns an iterator over collection metadata.
    
    Returns:
    Iterator over collection metadata.
  - addCollection
```
void addCollection(Collection collection)
                   throws DuplicateMappingException
```
    Add collection mapping metadata to this repository.
    
    Parameters:
    collection - The collection metadata
    
    Throws:
    
    DuplicateMappingException - Indicates there was already an entry corresponding to the given collection role
  - getTable
```
Table getTable(String schema,
             String catalog,
             String name)
```
    Returns the named table metadata.
    
    Parameters:
    schema - The named schema in which the table belongs (or null).
    catalog - The named catalog in which the table belongs (or null).
    name - The table name
    
    Returns:
    The table metadata, or null.
  - iterateTables
```
Iterator<Table> iterateTables()
```
    Returns an iterator over table metadata.
    
    Returns:
    Iterator over table metadata.
  - addTable
```
Table addTable(String schema,
             String catalog,
             String name,
             String subselect,
             boolean isAbstract)
```
    Adds table metadata to this repository returning the created metadata instance.
    
    Parameters:
    schema - The named schema in which the table belongs (or null).
    catalog - The named catalog in which the table belongs (or null).
    name - The table name
    subselect - A select statement which defines a logical table, much like a DB view.
    isAbstract - Is the table abstract (i.e. not really existing in the DB)?
    
    Returns:
    The created table metadata, or the existing reference.
  - addDenormalizedTable
```
Table addDenormalizedTable(String schema,
                         String catalog,
                         String name,
                         boolean isAbstract,
                         String subselect,
                         Table includedTable)
                           throws DuplicateMappingException
```
    Adds a 'denormalized table' to this repository.
    
    Parameters:
    schema - The named schema in which the table belongs (or null).
    catalog - The named catalog in which the table belongs (or null).
    name - The table name
    isAbstract - Is the table abstract (i.e. not really existing in the DB)?
    subselect - A select statement which defines a logical table, much like a DB view.
    includedTable - ???
    
    Returns:
    The created table metadata.
    
    Throws:
    
    DuplicateMappingException - If such a table mapping already exists.
  - getQuery
```
NamedQueryDefinition getQuery(String name)
```
    Get named query metadata by name.
    
    Parameters:
    name - The named query name
    
    Returns:
    The query metadata, or null.
  - addQuery
```
void addQuery(String name,
            NamedQueryDefinition query)
              throws DuplicateMappingException
```
    Adds metadata for a named query to this repository.
    
    Parameters:
    name - The name
    query - The metadata
    
    Throws:
    
    DuplicateMappingException - If a query already exists with that name.
  - getSQLQuery
```
NamedSQLQueryDefinition getSQLQuery(String name)
```
    Get named SQL query metadata.
    
    Parameters:
    name - The named SQL query name.
    
    Returns:
    The meatdata, or null if none found.
  - addSQLQuery
```
void addSQLQuery(String name,
               NamedSQLQueryDefinition query)
                 throws DuplicateMappingException
```
    Adds metadata for a named SQL query to this repository.
    
    Parameters:
    name - The name
    query - The metadata
    
    Throws:
    
    DuplicateMappingException - If a query already exists with that name.
  - getResultSetMapping
```
ResultSetMappingDefinition getResultSetMapping(String name)
```
    Get the metadata for a named SQL result set mapping.
    
    Parameters:
    name - The mapping name.
    
    Returns:
    The SQL result set mapping metadat, or null if none found.
  - addResultSetMapping
```
void addResultSetMapping(ResultSetMappingDefinition sqlResultSetMapping)
                         throws DuplicateMappingException
```
    Adds the metadata for a named SQL result set mapping to this repository.
    
    Parameters:
    sqlResultSetMapping - The metadata
    
    Throws:
    
    DuplicateMappingException - If metadata for another SQL result mapping was already found under the given name.
  - getTypeDef
```
TypeDef getTypeDef(String typeName)
```
    Retrieve a type definition by name.
    
    Parameters:
    typeName - The name of the type definition to retrieve.
    
    Returns:
    The type definition, or null if none found.
  - addTypeDef
```
void addTypeDef(String typeName,
              String typeClass,
              Properties paramMap)
```
    Adds a type definition to this metadata repository.
    
    Parameters:
    typeName - The type name.
    typeClass - The class implementing the Type contract.
    paramMap - Map of parameters to be used to configure the type after instantiation.
  - getFilterDefinitions
```
Map getFilterDefinitions()
```
    Retrieves the copmplete map of filter definitions.
    
    Returns:
    The filter definition map.
  - getFilterDefinition
```
FilterDefinition getFilterDefinition(String name)
```
    Retrieves a filter definition by name.
    
    Parameters:
    name - The name of the filter definition to retrieve.
    
    Returns:
    The filter definition, or null.
  - addFilterDefinition
```
void addFilterDefinition(FilterDefinition definition)
```
    Adds a filter definition to this repository.
    
    Parameters:
    definition - The filter definition to add.
  - findOrCreateFetchProfile
```
FetchProfile findOrCreateFetchProfile(String name,
                                    MetadataSource source)
```
    Retrieves a fetch profile by either finding one currently in this repository matching the given name or by creating one (and adding it).
    
    Parameters:
    name - The name of the profile.
    source - The source from which this profile is named.
    
    Returns:
    The fetch profile metadata.
  - iterateAuxliaryDatabaseObjects
```
@Deprecated
Iterator<AuxiliaryDatabaseObject> iterateAuxliaryDatabaseObjects()
```
    Deprecated. To fix misspelling; use iterateAuxiliaryDatabaseObjects() instead
  - iterateAuxiliaryDatabaseObjects
```
Iterator<AuxiliaryDatabaseObject> iterateAuxiliaryDatabaseObjects()
```
    Retrieves an iterator over the metadata pertaining to all auxiliary database objects int this repository.
    
    Returns:
    Iterator over the auxiliary database object metadata.
  - iterateAuxliaryDatabaseObjectsInReverse
```
@Deprecated
ListIterator<AuxiliaryDatabaseObject> iterateAuxliaryDatabaseObjectsInReverse()
```
    Deprecated. To fix misspelling; use iterateAuxiliaryDatabaseObjectsInReverse() instead
  - iterateAuxiliaryDatabaseObjectsInReverse
```
ListIterator<AuxiliaryDatabaseObject> iterateAuxiliaryDatabaseObjectsInReverse()
```
    Same as iterateAuxiliaryDatabaseObjects() except that here the iterator is reversed.
    
    Returns:
    The reversed iterator.
  - addAuxiliaryDatabaseObject
```
void addAuxiliaryDatabaseObject(AuxiliaryDatabaseObject auxiliaryDatabaseObject)
```
    Add metadata pertaining to an auxiliary database object to this repository.
    
    Parameters:
    auxiliaryDatabaseObject - The metadata.
  - getLogicalTableName
```
String getLogicalTableName(Table table)
                           throws MappingException
```
    Get the logical table name mapped for the given physical table.
    
    Parameters:
    table - The table for which to determine the logical name.
    
    Returns:
    The logical name.
    
    Throws:
    
    MappingException - Indicates that no logical name was bound for the given physical table.
  - addTableBinding
```
void addTableBinding(String schema,
                   String catalog,
                   String logicalName,
                   String physicalName,
                   Table denormalizedSuperTable)
                     throws DuplicateMappingException
```
    Adds a table binding to this repository.
    
    Parameters:
    schema - The schema in which the table belongs (may be null).
    catalog - The catalog in which the table belongs (may be null).
    logicalName - The logical table name.
    physicalName - The physical table name.
    denormalizedSuperTable - ???
    
    Throws:
    
    DuplicateMappingException - Indicates physical table was already bound to another logical name.
  - addColumnBinding
```
void addColumnBinding(String logicalName,
                    Column physicalColumn,
                    Table table)
                      throws DuplicateMappingException
```
    Binds the given 'physicalColumn' to the give 'logicalName' within the given 'table'.
    
    Parameters:
    logicalName - The logical column name binding.
    physicalColumn - The physical column metadata.
    table - The table metadata.
    
    Throws:
    
    DuplicateMappingException - Indicates a duplicate binding for either the physical column name or the logical column name.
  - getPhysicalColumnName
```
String getPhysicalColumnName(String logicalName,
                           Table table)
                             throws MappingException
```
    Find the physical column name for the given logical column name within the given table.
    
    Parameters:
    logicalName - The logical name binding.
    table - The table metatdata.
    
    Returns:
    The physical column name.
    
    Throws:
    
    MappingException - Indicates that no such binding was found.
  - getLogicalColumnName
```
String getLogicalColumnName(String physicalName,
                          Table table)
                            throws MappingException
```
    Find the logical column name against whcih the given physical column name was bound within the given table.
    
    Parameters:
    physicalName - The physical column name
    table - The table metadata.
    
    Returns:
    The logical column name.
    
    Throws:
    
    MappingException - Indicates that no such binding was found.
  - addSecondPass
```
void addSecondPass(SecondPass sp)
```
    Adds a second-pass to the end of the current queue.
    
    Parameters:
    sp - The second pass to add.
  - addSecondPass
```
void addSecondPass(SecondPass sp,
                 boolean onTopOfTheQueue)
```
    Adds a second pass.
    
    Parameters:
    sp - The second pass to add.
    onTopOfTheQueue - True to add to the beginning of the queue; false to add to the end.
  - addPropertyReference
```
void addPropertyReference(String referencedClass,
                        String propertyName)
```
    Adds a property reference binding to this repository.
    
    Parameters:
    referencedClass - The referenced entity name.
    propertyName - The referenced property name.
  - addUniquePropertyReference
```
void addUniquePropertyReference(String referencedClass,
                              String propertyName)
```
    Adds a property reference binding to this repository where said proeprty reference is marked as unique.
    
    Parameters:
    referencedClass - The referenced entity name.
    propertyName - The referenced property name.
  - addToExtendsQueue
```
void addToExtendsQueue(ExtendsQueueEntry entry)
```
    Adds an entry to the extends queue queue.
    
    Parameters:
    entry - The entry to add.
  - getIdentifierGeneratorFactory
```
MutableIdentifierGeneratorFactory getIdentifierGeneratorFactory()
```
    Retrieve the IdentifierGeneratorFactory in effect for this mapping.
    
    Returns:
    The IdentifierGeneratorFactory
  - addMappedSuperclass
```
void addMappedSuperclass(Class type,
                       MappedSuperclass mappedSuperclass)
```
    add a new MappedSuperclass This should not be called if the MappedSuperclass already exists (it would be erased)
    
    Parameters:
    type - type corresponding to the Mappedsuperclass
    mappedSuperclass - MappedSuperclass
  - getMappedSuperclass
```
MappedSuperclass getMappedSuperclass(Class type)
```
    Get a MappedSuperclass or null if not mapped
    
    Parameters:
    type - class corresponding to the MappedSuperclass
    
    Returns:
    the MappedSuperclass
  - getObjectNameNormalizer
```
ObjectNameNormalizer getObjectNameNormalizer()
```
    Retrieve the database identifier normalizer for this context.
    
    Returns:
    The normalizer.
  - getConfigurationProperties
```
Properties getConfigurationProperties()
```
    Retrieve the configuration properties currently in effect.
    
    Returns:
    The configuration properties
  - addDefaultGenerator
```
void addDefaultGenerator(IdGenerator generator)
```
    Adds a default id generator.
    
    Parameters:
    generator - The id generator
  - getGenerator
```
IdGenerator getGenerator(String name)
```
    Retrieve the id-generator by name.
    
    Parameters:
    name - The generator name.
    
    Returns:
    The generator, or null.
  - getGenerator
```
IdGenerator getGenerator(String name,
                       Map<String,IdGenerator> localGenerators)
```
    Try to find the generator from the localGenerators and then from the global generator list
    
    Parameters:
    name - generator name
    localGenerators - local generators
    
    Returns:
    the appropriate idgenerator or null if not found
  - addGenerator
```
void addGenerator(IdGenerator generator)
```
    Add a generator.
    
    Parameters:
    generator - The generator to add.
  - addGeneratorTable
```
void addGeneratorTable(String name,
                     Properties params)
```
    Add a generator table properties.
    
    Parameters:
    name - The generator name
    params - The generator table properties.
  - getGeneratorTableProperties
```
Properties getGeneratorTableProperties(String name,
                                     Map<String,Properties> localGeneratorTables)
```
    Retrieve the properties related to a generator table.
    
    Parameters:
    name - generator name
    localGeneratorTables - local generator tables
    
    Returns:
    The properties, or null.
  - getJoins
```
Map<String,Join> getJoins(String entityName)
```
    Retrieve join metadata for a particular persistent entity.
    
    Parameters:
    entityName - The entity name
    
    Returns:
    The join metadata
  - addJoins
```
void addJoins(PersistentClass persistentClass,
            Map<String,Join> joins)
```
    Add join metadata for a persistent entity.
    
    Parameters:
    persistentClass - The persistent entity metadata.
    joins - The join metadata to add.
    
    Throws:
    
    MappingException
  - getClassType
```
AnnotatedClassType getClassType(XClass clazz)
```
    Get and maintain a cache of class type.
    
    Parameters:
    clazz - The XClass mapping
    
    Returns:
    The class type.
  - addClassType
```
AnnotatedClassType addClassType(XClass clazz)
```
    FIXME should be private but will this break things? Add a class type.
    
    Parameters:
    clazz - The XClass mapping.
    
    Returns:
    The class type.
  - getTableUniqueConstraints
```
@Deprecated
Map<Table,List<String[]>> getTableUniqueConstraints()
```
    Deprecated. Use getUniqueConstraintHoldersByTable() instead
  - getUniqueConstraintHoldersByTable
```
Map<Table,List<UniqueConstraintHolder>> getUniqueConstraintHoldersByTable()
```
  - addUniqueConstraints
```
@Deprecated
void addUniqueConstraints(Table table,
                                   List uniqueConstraints)
```
    Deprecated. Use addUniqueConstraintHolders(org.hibernate.mapping.Table, java.util.List<org.hibernate.cfg.UniqueConstraintHolder>) instead
  - addUniqueConstraintHolders
```
void addUniqueConstraintHolders(Table table,
                              List<UniqueConstraintHolder> uniqueConstraintHolders)
```
  - addMappedBy
```
void addMappedBy(String entityName,
               String propertyName,
               String inversePropertyName)
```
  - getFromMappedBy
```
String getFromMappedBy(String entityName,
                     String propertyName)
```
  - addPropertyReferencedAssociation
```
void addPropertyReferencedAssociation(String entityName,
                                    String propertyName,
                                    String propertyRef)
```
  - getPropertyReferencedAssociation
```
String getPropertyReferencedAssociation(String entityName,
                                      String propertyName)
```
  - getReflectionManager
```
ReflectionManager getReflectionManager()
```
  - addDefaultQuery
```
void addDefaultQuery(String name,
                   NamedQueryDefinition query)
```
  - addDefaultSQLQuery
```
void addDefaultSQLQuery(String name,
                      NamedSQLQueryDefinition query)
```
  - addDefaultResultSetMapping
```
void addDefaultResultSetMapping(ResultSetMappingDefinition definition)
```
  - getClasses
```
Map getClasses()
```
  - addAnyMetaDef
```
void addAnyMetaDef(AnyMetaDef defAnn)
                   throws AnnotationException
```
    Throws:
    
    AnnotationException
  - getAnyMetaDef
```
AnyMetaDef getAnyMetaDef(String name)
```
  - isInSecondPass
```
boolean isInSecondPass()
```
  - getPropertyAnnotatedWithMapsId
```
PropertyData getPropertyAnnotatedWithMapsId(XClass entityType,
                                          String propertyName)
```
    Return the property annotated with @MapsId("propertyName") if any. Null otherwise
  - addPropertyAnnotatedWithMapsId
```
void addPropertyAnnotatedWithMapsId(XClass entityType,
                                  PropertyData property)
```
  - addPropertyAnnotatedWithMapsIdSpecj
```
void addPropertyAnnotatedWithMapsIdSpecj(XClass entityType,
                                       PropertyData property,
                                       String mapsIdValue)
```
  - isSpecjProprietarySyntaxEnabled
```
boolean isSpecjProprietarySyntaxEnabled()
```
  - useNewGeneratorMappings
```
boolean useNewGeneratorMappings()
```
    Should we use the new generator strategy mappings. This is controlled by the AvailableSettings.USE_NEW_ID_GENERATOR_MAPPINGS setting.
    
    Returns:
    True if the new generators should be used, false otherwise.
  - useImplicitDiscriminatorColumnForJoinedInheritance
```
boolean useImplicitDiscriminatorColumnForJoinedInheritance()
```
    Should we handle absent DiscriminatorColumn mappings for joined inheritance by implicitly mapping a discriminator column?
    
    Returns:
    true indicates we should infer DiscriminatorColumn implicitly (aka, map to a discriminator column even without a DiscriminatorColumn annotation); false (the default) indicates that we should not.
    See Also:
    AvailableSettings.IMPLICIT_DISCRIMINATOR_COLUMNS_FOR_JOINED_SUBCLASS
  - ignoreExplicitDiscriminatorColumnForJoinedInheritance
```
boolean ignoreExplicitDiscriminatorColumnForJoinedInheritance()
```
    Should we ignore explicit DiscriminatorColumn annotations when combined with joined inheritance?
    
    Returns:
    true indicates we should ignore explicit DiscriminatorColumn annotations; false (the default) indicates we should not ignore them
    See Also:
    AvailableSettings.IGNORE_EXPLICIT_DISCRIMINATOR_COLUMNS_FOR_JOINED_SUBCLASS
  - useNationalizedCharacterData
```
boolean useNationalizedCharacterData()
```
    Should we use nationalized variants of character data by default? This is controlled by the AvailableSettings.USE_NATIONALIZED_CHARACTER_DATA setting.
    
    Returns:
    true if nationalized character data should be used by default; false otherwise.
  - getPropertyAnnotatedWithIdAndToOne
```
PropertyData getPropertyAnnotatedWithIdAndToOne(XClass entityType,
                                              String propertyName)
```
    Return the property annotated with @ToOne and @Id if any. Null otherwise
  - addToOneAndIdProperty
```
void addToOneAndIdProperty(XClass entity,
                         PropertyData property)
```
  - forceDiscriminatorInSelectsByDefault
```
boolean forceDiscriminatorInSelectsByDefault()
```

Interface Mappings

Nested Class Summary

Method Summary

Method Detail

getTypeResolver

getNamingStrategy

setNamingStrategy

getNamingStrategyDelegator

setNamingStrategyDelegator

getSchemaName

setSchemaName

getCatalogName

setCatalogName

getDefaultPackage

setDefaultPackage

isAutoImport

setAutoImport

isDefaultLazy

setDefaultLazy

getDefaultCascade

setDefaultCascade

getDefaultAccess

setDefaultAccess

iterateClasses

getClass

locatePersistentClassByEntityName

addClass

addImport

getCollection

iterateCollections

addCollection

getTable

iterateTables

addTable

addDenormalizedTable

getQuery

addQuery

getSQLQuery

addSQLQuery

getResultSetMapping

addResultSetMapping

getTypeDef

addTypeDef

getFilterDefinitions

getFilterDefinition

addFilterDefinition

findOrCreateFetchProfile

iterateAuxliaryDatabaseObjects

iterateAuxiliaryDatabaseObjects

iterateAuxliaryDatabaseObjectsInReverse

iterateAuxiliaryDatabaseObjectsInReverse

addAuxiliaryDatabaseObject

getLogicalTableName

addTableBinding

addColumnBinding

getPhysicalColumnName

getLogicalColumnName

addSecondPass

addSecondPass

addPropertyReference

addUniquePropertyReference

addToExtendsQueue

getIdentifierGeneratorFactory

addMappedSuperclass

getMappedSuperclass

getObjectNameNormalizer

getConfigurationProperties

addDefaultGenerator

getGenerator

getGenerator

addGenerator

addGeneratorTable

getGeneratorTableProperties

getJoins

addJoins

getClassType

addClassType

getTableUniqueConstraints

getUniqueConstraintHoldersByTable

addUniqueConstraints