Nutzungsvorgaben Datum & Zeit Persistenz

IFS-Logo 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.

Creative Commons Namensnennung 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.