org.hibernate.cfg
Interface Mappings

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

static class

Mappings.PropertyReference Represents a property-ref mapping.

Method Summary

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(org.hibernate.annotations.common.reflection.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(java.lang.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(java.lang.String name, NamedQueryDefinition query)
void	addDefaultResultSetMapping(ResultSetMappingDefinition definition)
void	addDefaultSQLQuery(java.lang.String name, NamedSQLQueryDefinition query)
Table	addDenormalizedTable(java.lang.String schema, java.lang.String catalog, java.lang.String name, boolean isAbstract, java.lang.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(java.lang.String name, java.util.Properties params) Add a generator table properties.
void	addImport(java.lang.String entityName, java.lang.String rename) Adds an import (HQL entity rename) to the repository.
void	addJoins(PersistentClass persistentClass, java.util.Map<java.lang.String,Join> joins) Add join metadata for a persistent entity.
void	addMappedBy(java.lang.String entityName, java.lang.String propertyName, java.lang.String inversePropertyName)
void	addMappedSuperclass(java.lang.Class type, MappedSuperclass mappedSuperclass) add a new MappedSuperclass This should not be called if the MappedSuperclass already exists (it would be erased)
void	addPropertyAnnotatedWithMapsId(org.hibernate.annotations.common.reflection.XClass entityType, PropertyData property)
void	addPropertyAnnotatedWithMapsIdSpecj(org.hibernate.annotations.common.reflection.XClass entityType, PropertyData property, java.lang.String mapsIdValue)
void	addPropertyReference(java.lang.String referencedClass, java.lang.String propertyName) Adds a property reference binding to this repository.
void	addPropertyReferencedAssociation(java.lang.String entityName, java.lang.String propertyName, java.lang.String propertyRef)
void	addQuery(java.lang.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(java.lang.String name, NamedSQLQueryDefinition query) Adds metadata for a named SQL query to this repository.
Table	addTable(java.lang.String schema, java.lang.String catalog, java.lang.String name, java.lang.String subselect, boolean isAbstract) Adds table metadata to this repository returning the created metadata instance.
void	addTableBinding(java.lang.String schema, java.lang.String catalog, java.lang.String logicalName, java.lang.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(org.hibernate.annotations.common.reflection.XClass entity, PropertyData property)
void	addTypeDef(java.lang.String typeName, java.lang.String typeClass, java.util.Properties paramMap) Adds a type definition to this metadata repository.
void	addUniqueConstraintHolders(Table table, java.util.List<UniqueConstraintHolder> uniqueConstraintHolders)
void	addUniqueConstraints(Table table, java.util.List uniqueConstraints) Deprecated. Use addUniqueConstraintHolders(org.hibernate.mapping.Table, java.util.List) instead
void	addUniquePropertyReference(java.lang.String referencedClass, java.lang.String propertyName) Adds a property reference binding to this repository where said proeprty reference is marked as unique.
FetchProfile	findOrCreateFetchProfile(java.lang.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).
AnyMetaDef	getAnyMetaDef(java.lang.String name)
java.lang.String	getCatalogName() Returns the currently bound default catalog name.
PersistentClass	getClass(java.lang.String entityName) Retrieves the entity mapping metadata for the given entity name.
java.util.Map	getClasses()
AnnotatedClassType	getClassType(org.hibernate.annotations.common.reflection.XClass clazz) Get and maintain a cache of class type.
Collection	getCollection(java.lang.String role) Retrieves the collection mapping metadata for the given collection role.
java.util.Properties	getConfigurationProperties() Retrieve the configuration properties currently in effect.
java.lang.String	getDefaultAccess() Get the current default property access style.
java.lang.String	getDefaultCascade() Get the current default cascade style.
java.lang.String	getDefaultPackage() Get the currently bound default package name.
FilterDefinition	getFilterDefinition(java.lang.String name) Retrieves a filter definition by name.
java.util.Map	getFilterDefinitions() Retrieves the copmplete map of filter definitions.
java.lang.String	getFromMappedBy(java.lang.String entityName, java.lang.String propertyName)
IdGenerator	getGenerator(java.lang.String name) Retrieve the id-generator by name.
IdGenerator	getGenerator(java.lang.String name, java.util.Map<java.lang.String,IdGenerator> localGenerators) Try to find the generator from the localGenerators and then from the global generator list
java.util.Properties	getGeneratorTableProperties(java.lang.String name, java.util.Map<java.lang.String,java.util.Properties> localGeneratorTables) Retrieve the properties related to a generator table.
DefaultIdentifierGeneratorFactory	getIdentifierGeneratorFactory() Retrieve the IdentifierGeneratorFactory in effect for this mapping.
java.util.Map<java.lang.String,Join>	getJoins(java.lang.String entityName) Retrieve join metadata for a particular persistent entity.
java.lang.String	getLogicalColumnName(java.lang.String physicalName, Table table) Find the logical column name against whcih the given physical column name was bound within the given table.
java.lang.String	getLogicalTableName(Table table) Get the logical table name mapped for the given physical table.
MappedSuperclass	getMappedSuperclass(java.lang.Class type) Get a MappedSuperclass or null if not mapped
NamingStrategy	getNamingStrategy() Get the current naming strategy.
ObjectNameNormalizer	getObjectNameNormalizer() Retrieve the database identifier normalizer for this context.
PersisterClassProvider	getPersisterClassProvider() Get the current persister class provider implementation
java.lang.String	getPhysicalColumnName(java.lang.String logicalName, Table table) Find the physical column name for the given logical column name within the given table.
PropertyData	getPropertyAnnotatedWithIdAndToOne(org.hibernate.annotations.common.reflection.XClass entityType, java.lang.String propertyName) Return the property annotated with @ToOne and @Id if any.
PropertyData	getPropertyAnnotatedWithMapsId(org.hibernate.annotations.common.reflection.XClass entityType, java.lang.String propertyName) Return the property annotated with @MapsId("propertyName") if any.
java.lang.String	getPropertyReferencedAssociation(java.lang.String entityName, java.lang.String propertyName)
NamedQueryDefinition	getQuery(java.lang.String name) Get named query metadata by name.
org.hibernate.annotations.common.reflection.ReflectionManager	getReflectionManager()
ResultSetMappingDefinition	getResultSetMapping(java.lang.String name) Get the metadata for a named SQL result set mapping.
java.lang.String	getSchemaName() Returns the currently bound default schema name.
NamedSQLQueryDefinition	getSQLQuery(java.lang.String name) Get named SQL query metadata.
Table	getTable(java.lang.String schema, java.lang.String catalog, java.lang.String name) Returns the named table metadata.
java.util.Map<Table,java.util.List<java.lang.String[]>>	getTableUniqueConstraints() Deprecated. Use getUniqueConstraintHoldersByTable() instead
TypeDef	getTypeDef(java.lang.String typeName) Retrieve a type definition by name.
TypeResolver	getTypeResolver() Retrieve the type resolver in effect.
java.util.Map<Table,java.util.List<UniqueConstraintHolder>>	getUniqueConstraintHoldersByTable()
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()
java.util.Iterator<AuxiliaryDatabaseObject>	iterateAuxiliaryDatabaseObjects() Retrieves an iterator over the metadata pertaining to all auxiliary database objects int this repository.
java.util.ListIterator<AuxiliaryDatabaseObject>	iterateAuxiliaryDatabaseObjectsInReverse() Same as iterateAuxiliaryDatabaseObjects() except that here the iterator is reversed.
java.util.Iterator<AuxiliaryDatabaseObject>	iterateAuxliaryDatabaseObjects() Deprecated. To fix misspelling; use iterateAuxiliaryDatabaseObjects() instead
java.util.ListIterator<AuxiliaryDatabaseObject>	iterateAuxliaryDatabaseObjectsInReverse() Deprecated. To fix misspelling; use iterateAuxiliaryDatabaseObjectsInReverse() instead
java.util.Iterator<PersistentClass>	iterateClasses() Retrieves an iterator over the entity metadata present in this repository.
java.util.Iterator<Collection>	iterateCollections() Returns an iterator over collection metadata.
java.util.Iterator<Table>	iterateTables() Returns an iterator over table metadata.
PersistentClass	locatePersistentClassByEntityName(java.lang.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(java.lang.String catalogName) Sets the currently bound default catalog name.
void	setDefaultAccess(java.lang.String defaultAccess) Sets the current default property access style.
void	setDefaultCascade(java.lang.String defaultCascade) Sets the current default cascade style.
void	setDefaultLazy(boolean defaultLazy) Set whether to enable default laziness.
void	setDefaultPackage(java.lang.String defaultPackage) Set the current default package name.
void	setNamingStrategy(NamingStrategy namingStrategy) Set the current naming strategy.
void	setPersisterClassProvider(PersisterClassProvider persisterClassProvider) Set the current persister class provider implementation
void	setSchemaName(java.lang.String schemaName) Sets the currently bound default schema name.
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

NamingStrategy getNamingStrategy()

Get the current naming strategy.

Returns:

The current naming strategy.

setNamingStrategy

void setNamingStrategy(NamingStrategy namingStrategy)

Set the current naming strategy.

Parameters:

namingStrategy - The naming strategy to use.

getPersisterClassProvider

PersisterClassProvider getPersisterClassProvider()

Get the current persister class provider implementation

setPersisterClassProvider

void setPersisterClassProvider(PersisterClassProvider persisterClassProvider)

Set the current persister class provider implementation

getSchemaName

java.lang.String getSchemaName()

Returns the currently bound default schema name.

Returns:

The currently bound schema name

setSchemaName

void setSchemaName(java.lang.String schemaName)

Sets the currently bound default schema name.

Parameters:

schemaName - The schema name to bind as the current default.

getCatalogName

java.lang.String getCatalogName()

Returns the currently bound default catalog name.

Returns:

The currently bound catalog name, or null if none.

setCatalogName

void setCatalogName(java.lang.String catalogName)

Sets the currently bound default catalog name.

Parameters:

catalogName - The catalog name to use as the current default.

getDefaultPackage

java.lang.String getDefaultPackage()

Get the currently bound default package name.

Returns:

The currently bound default package name

setDefaultPackage

void setDefaultPackage(java.lang.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

java.lang.String getDefaultCascade()

Get the current default cascade style.

Returns:

The current default cascade style.

setDefaultCascade

void setDefaultCascade(java.lang.String defaultCascade)

Sets the current default cascade style. .

Parameters:

defaultCascade - The cascade style to set as the current default.

getDefaultAccess

java.lang.String getDefaultAccess()

Get the current default property access style.

Returns:

The current default property access style.

setDefaultAccess

void setDefaultAccess(java.lang.String defaultAccess)

Sets the current default property access style.

Parameters:

defaultAccess - The access style to use as the current default.

iterateClasses

java.util.Iterator<PersistentClass> iterateClasses()

Retrieves an iterator over the entity metadata present in this repository.

Returns:

Iterator over class metadata.

getClass

PersistentClass getClass(java.lang.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(java.lang.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(java.lang.String entityName,
               java.lang.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(java.lang.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

java.util.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(java.lang.String schema,
               java.lang.String catalog,
               java.lang.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

java.util.Iterator<Table> iterateTables()

Returns an iterator over table metadata.

Returns:

Iterator over table metadata.

addTable

Table addTable(java.lang.String schema,
               java.lang.String catalog,
               java.lang.String name,
               java.lang.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(java.lang.String schema,
                           java.lang.String catalog,
                           java.lang.String name,
                           boolean isAbstract,
                           java.lang.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(java.lang.String name)

Get named query metadata by name.

Parameters:

name - The named query name

Returns:

The query metadata, or null.

addQuery

void addQuery(java.lang.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(java.lang.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(java.lang.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(java.lang.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(java.lang.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(java.lang.String typeName,
                java.lang.String typeClass,
                java.util.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

java.util.Map getFilterDefinitions()

Retrieves the copmplete map of filter definitions.

Returns:

The filter definition map.

getFilterDefinition

FilterDefinition getFilterDefinition(java.lang.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(java.lang.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
java.util.Iterator<AuxiliaryDatabaseObject> iterateAuxliaryDatabaseObjects()

Deprecated. To fix misspelling; use iterateAuxiliaryDatabaseObjects() instead

iterateAuxiliaryDatabaseObjects

java.util.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
java.util.ListIterator<AuxiliaryDatabaseObject> iterateAuxliaryDatabaseObjectsInReverse()

Deprecated. To fix misspelling; use iterateAuxiliaryDatabaseObjectsInReverse() instead

iterateAuxiliaryDatabaseObjectsInReverse

java.util.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

java.lang.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(java.lang.String schema,
                     java.lang.String catalog,
                     java.lang.String logicalName,
                     java.lang.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(java.lang.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

java.lang.String getPhysicalColumnName(java.lang.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

java.lang.String getLogicalColumnName(java.lang.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(java.lang.String referencedClass,
                          java.lang.String propertyName)

Adds a property reference binding to this repository.

Parameters:

referencedClass - The referenced entity name.

propertyName - The referenced property name.

addUniquePropertyReference

void addUniquePropertyReference(java.lang.String referencedClass,
                                java.lang.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

DefaultIdentifierGeneratorFactory getIdentifierGeneratorFactory()

Retrieve the IdentifierGeneratorFactory in effect for this mapping.

Returns:

The IdentifierGeneratorFactory

addMappedSuperclass

void addMappedSuperclass(java.lang.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(java.lang.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

java.util.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(java.lang.String name)

Retrieve the id-generator by name.

Parameters:

name - The generator name.

Returns:

The generator, or null.

getGenerator

IdGenerator getGenerator(java.lang.String name,
                         java.util.Map<java.lang.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(java.lang.String name,
                       java.util.Properties params)

Add a generator table properties.

Parameters:

name - The generator name

params - The generator table properties.

getGeneratorTableProperties

java.util.Properties getGeneratorTableProperties(java.lang.String name,
                                                 java.util.Map<java.lang.String,java.util.Properties> localGeneratorTables)

Retrieve the properties related to a generator table.

Parameters:

name - generator name

localGeneratorTables - local generator tables

Returns:

The properties, or null.

getJoins

java.util.Map<java.lang.String,Join> getJoins(java.lang.String entityName)

Retrieve join metadata for a particular persistent entity.

Parameters:

entityName - The entity name

Returns:

The join metadata

addJoins

void addJoins(PersistentClass persistentClass,
              java.util.Map<java.lang.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(org.hibernate.annotations.common.reflection.XClass clazz)

Get and maintain a cache of class type.

Parameters:

clazz - The XClass mapping

Returns:

The class type.

addClassType

AnnotatedClassType addClassType(org.hibernate.annotations.common.reflection.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

java.util.Map<Table,java.util.List<java.lang.String[]>> getTableUniqueConstraints()

Deprecated. Use getUniqueConstraintHoldersByTable() instead

getUniqueConstraintHoldersByTable

java.util.Map<Table,java.util.List<UniqueConstraintHolder>> getUniqueConstraintHoldersByTable()

addUniqueConstraints

void addUniqueConstraints(Table table,
                          java.util.List uniqueConstraints)

Deprecated. Use addUniqueConstraintHolders(org.hibernate.mapping.Table, java.util.List) instead

addUniqueConstraintHolders

void addUniqueConstraintHolders(Table table,
                                java.util.List<UniqueConstraintHolder> uniqueConstraintHolders)

addMappedBy

void addMappedBy(java.lang.String entityName,
                 java.lang.String propertyName,
                 java.lang.String inversePropertyName)

getFromMappedBy

java.lang.String getFromMappedBy(java.lang.String entityName,
                                 java.lang.String propertyName)

addPropertyReferencedAssociation

void addPropertyReferencedAssociation(java.lang.String entityName,
                                      java.lang.String propertyName,
                                      java.lang.String propertyRef)

getPropertyReferencedAssociation

java.lang.String getPropertyReferencedAssociation(java.lang.String entityName,
                                                  java.lang.String propertyName)

getReflectionManager

org.hibernate.annotations.common.reflection.ReflectionManager getReflectionManager()

addDefaultQuery

void addDefaultQuery(java.lang.String name,
                     NamedQueryDefinition query)

addDefaultSQLQuery

void addDefaultSQLQuery(java.lang.String name,
                        NamedSQLQueryDefinition query)

addDefaultResultSetMapping

void addDefaultResultSetMapping(ResultSetMappingDefinition definition)

getClasses

java.util.Map getClasses()

addAnyMetaDef

void addAnyMetaDef(AnyMetaDef defAnn)
                   throws AnnotationException

Throws:

AnnotationException

getAnyMetaDef

AnyMetaDef getAnyMetaDef(java.lang.String name)

isInSecondPass

boolean isInSecondPass()

getPropertyAnnotatedWithMapsId

PropertyData getPropertyAnnotatedWithMapsId(org.hibernate.annotations.common.reflection.XClass entityType,
                                            java.lang.String propertyName)

Return the property annotated with @MapsId("propertyName") if any. Null otherwise

addPropertyAnnotatedWithMapsId

void addPropertyAnnotatedWithMapsId(org.hibernate.annotations.common.reflection.XClass entityType,
                                    PropertyData property)

addPropertyAnnotatedWithMapsIdSpecj

void addPropertyAnnotatedWithMapsIdSpecj(org.hibernate.annotations.common.reflection.XClass entityType,
                                         PropertyData property,
                                         java.lang.String mapsIdValue)

isSpecjProprietarySyntaxEnabled

boolean isSpecjProprietarySyntaxEnabled()

useNewGeneratorMappings

boolean useNewGeneratorMappings()

Should we use the new generator strategy mappings. This is controlled by the Configuration.USE_NEW_ID_GENERATOR_MAPPINGS setting.

Returns:

True if the new generators should be used, false otherwise.

getPropertyAnnotatedWithIdAndToOne

PropertyData getPropertyAnnotatedWithIdAndToOne(org.hibernate.annotations.common.reflection.XClass entityType,
                                                java.lang.String propertyName)

Return the property annotated with @ToOne and @Id if any. Null otherwise

addToOneAndIdProperty

void addToOneAndIdProperty(org.hibernate.annotations.common.reflection.XClass entity,
                           PropertyData property)