Nutzungsvorgaben Datum & Zeit Persistenz

Java Bibliothek / IT-System

Name Art Version

isy-datetime-persistence

Bibliothek

5.0.0

Die Bibliothek isy-datetime-persistence dient als Ergänzung der Bibliothek isy-datetime. Mit ihr können Datums-Objekte des Pakets isy-datetime in Datenbanken abgelegt und wieder ausgelesen werden.

1. 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.

2. 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.

3. Attribute Converter

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.