Zum Inhalt springen
Anjunar/ DOCS

API und Grenzen

Öffentliche API, unterstützte Mappings und abgelehnte Operationen nachschlagen.

Module

Eine öffentliche Runtime-API

hibernate-i18n-core liefert die Annotationen. hibernate-i18n enthält Mapping-Bootstrap, sprachgebundene Sessions, typisierten Editor und Schema-Integration. Es gibt ein Runtime-Artefakt.

HibernateI18n.registryBuilder()
Erzeugt einen Hibernate-Registry-Builder mit Übersetzungs-Mapping-Contributors.
HibernateI18n.openSession(factory, locale[, tenantId])
Initialisiert annotierte Entities und öffnet eine Session mit fester Inhaltssprache und optionalem Tenant.
HibernateI18n.translations(factory, entityClass)
Liefert den aus Annotationen abgeleiteten Editorzugriff für eine gemappte Entity.
translations.fieldNames
Liefert alle Namen übersetzter Properties aus dem Entity-Mapping.
translations.get[V](session, entity, name, locale)
Liefert Option des exakten Sprachwerts ohne Fallback.
translations.set(session, entity, name, locale, value)
Schreibt eine Überschreibung für eine inaktive Sprache; null entfernt sie.
translations.copyInactive(session, from, to)
Kopiert gespeicherte inaktive Sprachzeilen und liefert ihre Anzahl.
Umfang

Den unterstützten Vertrag kennen

Diese Grenzen beschreiben den Runtime-Vertrag von Hibernate I18n 1.1.1.

Unterstützte Mapping-Form
Eine UUID-ID, String-Datenbankwerte und einheitlicher Feld- oder JavaBean-Getter-Zugriff.
Einfache Spaltenbezeichner; Tabellennamen dürfen auch # enthalten.
String-@TenantId für Isolation in gemeinsamen Tabellen.
Übersetzte Member einer MappedSuperclass dürfen ein Entity-Mapping pro Factory versorgen.
Abgelehnte Operationen

Detached merge und replicate, gemischter Zugriff und @Column an übersetzten Attributen werden abgelehnt. Query-Caching wird abgelehnt; Second-Level-Caching wird für lokalisierte Entity-Hierarchien deaktiviert. Unabhängige Entities dürfen ihren Cache weiterhin verwenden.

Verwaltete Änderungen

Lade die Entity in der Zielsprache, bevor du ihre gewöhnlichen Felder bearbeitest. Neue Entities verwenden persist. openSession erkennt annotierte Entities automatisch.