Runtime bootstrap
Build the metadata; the runtime discovers annotated translation fields automatically.
Build the runtime metadata
Create the registry with HibernateI18n so the mapping generator and metadata finalizer are installed. Provide a PostgreSQL DataSource and the annotated Page from the mapping guide.
Registry and schema preparation
Use the DDL manager as the schema owner. Migrate the complete metadata before building the factory and keep Hibernate schema generation disabled.
The upgrade helper requires an auto-commit PostgreSQL connection. It widens existing generated varchar columns to text, preserves values, and leaves missing tables to schema creation.
Annotation-only mapping
Declare translated properties only through annotations. openSession discovers every @Localized entity, @Translation member and JPA converter from Hibernate metadata automatically.
Get a metadata-derived editor handle
The annotations fully define the mapping. Request a handle only when an editor needs exact inactive locales.