org.hibernate.cfg.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:Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Mappings.PropertyReference | Represents a property-ref mapping. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Add metadata pertaining to an auxiliary database object to this repository.
| |||||||||||
Add entity mapping metadata.
| |||||||||||
FIXME should be private but will this break things?
Add a class type.
| |||||||||||
Add collection mapping metadata to this repository.
| |||||||||||
Binds the given 'physicalColumn' to the give 'logicalName' within the given 'table'.
| |||||||||||
Adds a default id generator.
| |||||||||||
Adds a 'denormalized table' to this repository.
| |||||||||||
Adds a filter definition to this repository.
| |||||||||||
Add a generator.
| |||||||||||
Add a generator table properties.
| |||||||||||
Adds an import (HQL entity rename) to the repository.
| |||||||||||
Add join metadata for a persistent entity.
| |||||||||||
add a new MappedSuperclass
This should not be called if the MappedSuperclass already exists
(it would be erased)
| |||||||||||
Adds a property reference binding to this repository.
| |||||||||||
Adds metadata for a named query to this repository.
| |||||||||||
Adds the metadata for a named SQL result set mapping to this repository.
| |||||||||||
Adds metadata for a named SQL query to this repository.
| |||||||||||
Adds a second-pass to the end of the current queue.
| |||||||||||
Adds a second pass.
| |||||||||||
Adds table metadata to this repository returning the created
metadata instance.
| |||||||||||
Adds a table binding to this repository.
| |||||||||||
Adds an entry to the extends queue queue.
| |||||||||||
Adds a type definition to this metadata repository.
| |||||||||||
This method is deprecated.
Use
addUniqueConstraintHolders(Table, List instead
| |||||||||||
Adds a property reference binding to this repository where said proeprty reference is marked as unique.
| |||||||||||
Retrieves a fetch profile by either finding one currently in this repository matching the given name
or by creating one (and adding it).
| |||||||||||
Returns the currently bound default catalog name.
| |||||||||||
Retrieves the entity mapping metadata for the given entity name.
| |||||||||||
Get and maintain a cache of class type.
| |||||||||||
Retrieves the collection mapping metadata for the given collection role.
| |||||||||||
Retrieve the configuration properties currently in effect.
| |||||||||||
Get the current default property access style.
| |||||||||||
Get the current default cascade style.
| |||||||||||
Get the currently bound default package name.
| |||||||||||
Retrieves a filter definition by name.
| |||||||||||
Retrieves the copmplete map of filter definitions.
| |||||||||||
Try to find the generator from the localGenerators
and then from the global generator list
| |||||||||||
Retrieve the id-generator by name.
| |||||||||||
Retrieve the properties related to a generator table.
| |||||||||||
Retrieve the IdentifierGeneratorFactory in effect for this mapping.
| |||||||||||
Retrieve join metadata for a particular persistent entity.
| |||||||||||
Find the logical column name against whcih the given physical column name was bound within the given table.
| |||||||||||
Get the logical table name mapped for the given physical table.
| |||||||||||
Get a MappedSuperclass or null if not mapped
| |||||||||||
Get the current naming strategy.
| |||||||||||
Retrieve the database identifier normalizer for this context.
| |||||||||||
Get the current persister class provider implementation
| |||||||||||
Find the physical column name for the given logical column name within the given table.
| |||||||||||
Return the property annotated with @ToOne and @Id if any.
| |||||||||||
Return the property annotated with @MapsId("propertyName") if any.
| |||||||||||
Get named query metadata by name.
| |||||||||||
Get the metadata for a named SQL result set mapping.
| |||||||||||
Get named SQL query metadata.
| |||||||||||
Returns the currently bound default schema name.
| |||||||||||
Returns the named table metadata.
| |||||||||||
This method is deprecated.
Use
getUniqueConstraintHoldersByTable() instead
| |||||||||||
Retrieve a type definition by name.
| |||||||||||
Retrieve the type resolver in effect.
| |||||||||||
Determine whether auto importing of entity names is currently enabled.
| |||||||||||
Determine whether default laziness is currently enabled.
| |||||||||||
Retrieves an iterator over the metadata pertaining to all auxiliary database objects int this repository.
| |||||||||||
Same as
iterateAuxiliaryDatabaseObjects() except that here the iterator is reversed. | |||||||||||
This method is deprecated.
To fix misspelling; use
iterateAuxiliaryDatabaseObjects() instead
| |||||||||||
This method is deprecated.
To fix misspelling; use
iterateAuxiliaryDatabaseObjectsInReverse() instead
| |||||||||||
Retrieves an iterator over the entity metadata present in this repository.
| |||||||||||
Returns an iterator over collection metadata.
| |||||||||||
Returns an iterator over table metadata.
| |||||||||||
Retrieves the entity mapping metadata for the given entity name, potentially accounting
for imports.
| |||||||||||
Set whether to enable auto importing of entity names.
| |||||||||||
Sets the currently bound default catalog name.
| |||||||||||
Sets the current default property access style.
| |||||||||||
Sets the current default cascade style.
| |||||||||||
Set whether to enable default laziness.
| |||||||||||
Set the current default package name.
| |||||||||||
Set the current naming strategy.
| |||||||||||
Set the current persister class provider implementation
| |||||||||||
Sets the currently bound default schema name.
| |||||||||||
Should we use the new generator strategy mappings.
|
Add metadata pertaining to an auxiliary database object to this repository.
auxiliaryDatabaseObject | The metadata. |
---|
Add entity mapping metadata.
persistentClass | The entity metadata |
---|
DuplicateMappingException | Indicates there4 was already an extry corresponding to the given entity name. |
---|
FIXME should be private but will this break things? Add a class type.
clazz | The XClass mapping. |
---|
Add collection mapping metadata to this repository.
collection | The collection metadata |
---|
DuplicateMappingException | Indicates there was already an entry corresponding to the given collection role |
---|
Binds the given 'physicalColumn' to the give 'logicalName' within the given 'table'.
logicalName | The logical column name binding. |
---|---|
physicalColumn | The physical column metadata. |
table | The table metadata. |
DuplicateMappingException | Indicates a duplicate binding for either the physical column name or the logical column name. |
---|
Adds a default id generator.
generator | The id generator |
---|
Adds a 'denormalized table' to this repository.
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 | ??? |
DuplicateMappingException | If such a table mapping already exists. |
---|
Adds a filter definition to this repository.
definition | The filter definition to add. |
---|
Add a generator.
generator | The generator to add. |
---|
Add a generator table properties.
name | The generator name |
---|---|
params | The generator table properties. |
Adds an import (HQL entity rename) to the repository.
entityName | The entity name being renamed. |
---|---|
rename | The rename |
DuplicateMappingException | If rename already is mapped to another entity name in this repository. |
---|
Add join metadata for a persistent entity.
persistentClass | The persistent entity metadata. |
---|---|
joins | The join metadata to add. |
MappingException |
---|
add a new MappedSuperclass This should not be called if the MappedSuperclass already exists (it would be erased)
type | type corresponding to the Mappedsuperclass |
---|---|
mappedSuperclass | MappedSuperclass |
Adds a property reference binding to this repository.
referencedClass | The referenced entity name. |
---|---|
propertyName | The referenced property name. |
Adds metadata for a named query to this repository.
name | The name |
---|---|
query | The metadata |
DuplicateMappingException | If a query already exists with that name. |
---|
Adds the metadata for a named SQL result set mapping to this repository.
sqlResultSetMapping | The metadata |
---|
DuplicateMappingException | If metadata for another SQL result mapping was already found under the given name. |
---|
Adds metadata for a named SQL query to this repository.
name | The name |
---|---|
query | The metadata |
DuplicateMappingException | If a query already exists with that name. |
---|
Adds a second-pass to the end of the current queue.
sp | The second pass to add. |
---|
Adds a second pass.
sp | The second pass to add. |
---|---|
onTopOfTheQueue | True to add to the beginning of the queue; false to add to the end. |
Adds table metadata to this repository returning the created metadata instance.
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)? |
Adds a table binding to this repository.
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 | ??? |
DuplicateMappingException | Indicates physical table was already bound to another logical name. |
---|
Adds an entry to the extends queue queue.
entry | The entry to add. |
---|
Adds a type definition to this metadata repository.
typeName | The type name. |
---|---|
typeClass | The class implementing the Type contract. |
paramMap | Map of parameters to be used to configure the type after instantiation. |
Adds a property reference binding to this repository where said proeprty reference is marked as unique.
referencedClass | The referenced entity name. |
---|---|
propertyName | The referenced property name. |
Retrieves a fetch profile by either finding one currently in this repository matching the given name or by creating one (and adding it).
name | The name of the profile. |
---|---|
source | The source from which this profile is named. |
Returns the currently bound default catalog name.
Retrieves the entity mapping metadata for the given entity name.
entityName | The entity name for which to retrieve the metadata. |
---|
Get and maintain a cache of class type.
clazz | The XClass mapping |
---|
Retrieves the collection mapping metadata for the given collection role.
role | The collection role for which to retrieve the metadata. |
---|
Retrieve the configuration properties currently in effect.
Get the current default property access style.
Get the current default cascade style.
Get the currently bound default package name.
Retrieves a filter definition by name.
name | The name of the filter definition to retrieve. |
---|
Retrieves the copmplete map of filter definitions.
Try to find the generator from the localGenerators and then from the global generator list
name | generator name |
---|---|
localGenerators | local generators |
Retrieve the id-generator by name.
name | The generator name. |
---|
Retrieve the properties related to a generator table.
name | generator name |
---|---|
localGeneratorTables | local generator tables |
Retrieve the IdentifierGeneratorFactory in effect for this mapping.
Retrieve join metadata for a particular persistent entity.
entityName | The entity name |
---|
Find the logical column name against whcih the given physical column name was bound within the given table.
physicalName | The physical column name |
---|---|
table | The table metadata. |
MappingException | Indicates that no such binding was found. |
---|
Get the logical table name mapped for the given physical table.
table | The table for which to determine the logical name. |
---|
MappingException | Indicates that no logical name was bound for the given physical table. |
---|
Get a MappedSuperclass or null if not mapped
type | class corresponding to the MappedSuperclass |
---|
Get the current naming strategy.
Retrieve the database identifier normalizer for this context.
Get the current persister class provider implementation
Find the physical column name for the given logical column name within the given table.
logicalName | The logical name binding. |
---|---|
table | The table metatdata. |
MappingException | Indicates that no such binding was found. |
---|
Return the property annotated with @ToOne and @Id if any. Null otherwise
Return the property annotated with @MapsId("propertyName") if any. Null otherwise
Get named query metadata by name.
name | The named query name |
---|
Get the metadata for a named SQL result set mapping.
name | The mapping name. |
---|
Get named SQL query metadata.
name | The named SQL query name. |
---|
Returns the currently bound default schema name.
Returns the named table metadata.
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 |
Retrieve a type definition by name.
typeName | The name of the type definition to retrieve. |
---|
Retrieve the type resolver in effect.
Determine whether auto importing of entity names is currently enabled.
Determine whether default laziness is currently enabled.
Retrieves an iterator over the metadata pertaining to all auxiliary database objects int this repository.
Same as iterateAuxiliaryDatabaseObjects()
except that here the iterator is reversed.
This method is deprecated.
To fix misspelling; use iterateAuxiliaryDatabaseObjectsInReverse()
instead
Retrieves an iterator over the entity metadata present in this repository.
Returns an iterator over collection metadata.
Returns an iterator over table metadata.
Retrieves the entity mapping metadata for the given entity name, potentially accounting for imports.
entityName | The entity name for which to retrieve the metadata. |
---|
Set whether to enable auto importing of entity names.
autoImport | True to enable; false to diasable. |
---|
Sets the currently bound default catalog name.
catalogName | The catalog name to use as the current default. |
---|
Sets the current default property access style.
defaultAccess | The access style to use as the current default. |
---|
Sets the current default cascade style. .
defaultCascade | The cascade style to set as the current default. |
---|
Set whether to enable default laziness.
defaultLazy | True to enable, false to disable. |
---|
Set the current default package name.
defaultPackage | The package name to set as the current default. |
---|
Set the current naming strategy.
namingStrategy | The naming strategy to use. |
---|
Set the current persister class provider implementation
Sets the currently bound default schema name.
schemaName | The schema name to bind as the current default. |
---|
Should we use the new generator strategy mappings. This is controlled by the
USE_NEW_ID_GENERATOR_MAPPINGS
setting.