hibernate-orm/migration-guide-5.0.adoc
Steve Ebersole 9caca0ce37 HHH-9490 - Migrate from dom4j to jaxb for XML processing;
HHH-9492 - Migrate to new bootstrap API (MetadataSources, etc);
HHH-7078 - Split NamingStrategy into ImplicitNamingStrategy/PhysicalNamingStrategy;
HHH-6005 - Better handling of implicit column naming with @ElementCollection of @Embeddables;
HHH-9633 - Add tests that explicitly test the "main" NamingStrategy impls
2015-03-10 16:53:51 -05:00

26 lines
1.4 KiB
Plaintext

= 5.0 Migration Guide
:toc:
This guide discusses migration from Hibernate ORM version 4.3 to version 5.0. For migration from
earlier versions, see any other pertinent migration guides as well.
* Re-purposing of Configuration. Configuration, historically, allowed users to iteratively add
settings and mappings in any order and to query the state of settings and mapping information in the middle
of that process. Which meant that building the mapping information could not effectively rely on any settings
being available. This lead to many limitations and problems. Quite a few methods have been removed from
Configuration. todo : topical guide on bootstrapping, reference that here.
* Migrated `org.hibernate.metamodel.spi.TypeContributor` and `org.hibernate.metamodel.spi.TypeContributions`
to `org.hibernate.boot.model.TypeContributor` and `org.hibernate.boot.model.TypeContributions`
* Naming strategies - discuss split.
* implicit column names, add to strategy? Currently these are handled "specially":
** PrimaryKeyJoinColumn
*** joined-subclass key column(s) - JPA defaults
*** secondary table key column(s) - JPA defaults
*** one-to-one key column(s) - JPA defaults
** entity simple identifier column - JPA defaults
** entity version - currently uses #determineAttributeColumnName
** collection-id column name - currently hard-coded as "id"
** list-index column name - currently hard-coded as "idx"