Nutzungsvorgaben Datum & Zeit Persistenz
Diese Seite ist ein Teil der IsyFact-Standards.
Alle Inhalte der Seite, insbesondere Texte und Grafiken, sind urheberrechtlich geschützt.
Alle urheberrechtlichen Nutzungs- und Verwertungsrechte liegen beim Bundesverwaltungsamt.
Die Nutzung ist unter den Lizenzbedingungen der Creative Commons Namensnennung 4.0 International gestattet.
Mit Hilfe des Pakets isy-datetime-persistence
der Isyfact können Datums-Objekte des Pakets isy-datetime
in Datenbanken abgelegt und wieder ausgelesen werden.
1. Einleitung
Die Bibliothek isy-datetime-persistence
dient als Ergänzung der Bibliothek isy-datetime
. Sie enthält alle Methoden zur Persistierung von Datums-Objekten aus isy-datetime
.
2. Einbinden in das Projekt
Die Bibliothek isy-datetime-persistence
wird mit folgendem Code-Abschnitt in die POM-Datei des Projekts eingebunden:
<dependency>
<groupId>de.bund.bva.isyfact</groupId>
<artifactId>isy-datetime-persistence</artifactId>
<version>${isy-datetime-persistence.version}</version>
</dependency>
Der Wert von isy-datetime-persistence.version
wird dabei in den Properties der POM-Datei gesetzt.
Durch diese Dependency werden auch isy-datetime
und jakarta.persistence
eingebunden.
Dem Entwickler stehen nun einige Entitäten und ein Converter zur Verfügung, mit den Datums-Objekte verarbeitet werden können.
3. Die Entitäten
Im Paket de.bund.bva.isyfact.datetime.persistence
befinden sich die Klassen
-
UngewissesDatumEntitaet
-
UngewisseZeitEntitaet
-
ZeitraumEntitaet
Diese Klassen bilden die Datenbank-Entitäten zu den entsprechenden Klassen aus isy-datetime
gemäß dem Standard, der in jakarta.persistence
definiert ist.
4. Der AttributeConverter
Die Klasse PeriodAttributeConverter
im Unterpaket attributeconverter
stellt einen Converter
zur Konvertierung von Objekten der Klasse Period
aus java.time
zur Verfügung. Die Konvertierung erfolgt dabei automatisch; das Speichern erfolgt in der ISO-8601-Darstellung als String.