Java einfach erklärt

Plain Java

Serialisierung und Deserialisierung von Datums- und Zeitangaben mit Jackson in Java

Die Serialisierung und Deserialisierung von Datums- und Zeitangaben sind entscheidende Aspekte beim Umgang mit Daten in Java-Anwendungen. In diesem Artikel werden wir uns auf die Verwendung der Jackson-Bibliothek konzentrieren, um Datums- und Zeitangaben zu serialisieren und zu deserialisieren. Dabei werden sowohl die traditionelle java.util.Date-Klasse als auch die neuen DateTime-Objekte aus Java 8 berücksichtigt.

Einleitung zu Jackson

Jackson ist eine leistungsstarke Java-Bibliothek zur Verarbeitung von JSON-Daten. Sie bietet eine einfache Möglichkeit, Java-Objekte in JSON umzuwandeln (Serialisierung) und umgekehrt (Deserialisierung). Jackson unterstützt verschiedene Datentypen, einschließlich Datums- und Zeitangaben.

Serialisierung von Datums- und Zeitangaben

Serialisierung von java.util.Date

Um ein java.util.Date-Objekt in ein JSON-Format zu serialisieren, verwenden wir die Jackson-Annotationen. Hier ein einfaches Beispiel:

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;
import java.util.Date;

public class DateSerializationExample {

    public static void main(String[] args) throws Exception {
        ObjectMapper objectMapper = new ObjectMapper();
        objectMapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false);

        Date currentDate = new Date();
        String jsonDate = objectMapper.writeValueAsString(currentDate);

        System.out.println("Serialisiertes Datum: " + jsonDate);
    }
}Code-Sprache: JavaScript (javascript)

In diesem Beispiel wird die ObjectMapper-Klasse von Jackson verwendet. Die Konfiguration WRITE_DATES_AS_TIMESTAMPS wird auf false gesetzt, um das Datum nicht als Zeitstempel, sondern im lesbaren String-Format zu serialisieren.

Serialisierung von Java 8 DateTime-Objekten

Für Java 8 und spätere Versionen bietet Jackson native Unterstützung für die Serialisierung von DateTime-Objekten. Hier ein Beispiel:

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import java.time.LocalDateTime;

public class DateTimeSerializationExample {

    public static void main(String[] args) throws Exception {
        ObjectMapper objectMapper = new ObjectMapper();
        objectMapper.registerModule(new JavaTimeModule());

        LocalDateTime currentDateTime = LocalDateTime.now();
        String jsonDateTime = objectMapper.writeValueAsString(currentDateTime);

        System.out.println("Serialisiertes DateTime: " + jsonDateTime);
    }
}Code-Sprache: JavaScript (javascript)

Durch Hinzufügen des JavaTimeModule zum ObjectMapper kann Jackson LocalDateTime-Objekte ohne zusätzliche Konfiguration serialisieren.

Deserialisierung von Datums- und Zeitangaben

Deserialisierung von java.util.Date

Um ein JSON-String mit einem Datumsformat in ein java.util.Date-Objekt zu deserialisieren, verwenden wir erneut Jackson-Annotationen:

import com.fasterxml.jackson.databind.ObjectMapper;
import java.text.SimpleDateFormat;
import java.util.Date;

public class DateDeserializationExample {

    public static void main(String[] args) throws Exception {
        ObjectMapper objectMapper = new ObjectMapper();

        String jsonDate = "\"2024-01-24T12:30:45\""; // Beispiel-Datum im ISO-Format
        Date deserializedDate = objectMapper.readValue(jsonDate, Date.class);

        System.out.println("Deserialisiertes Datum: " + deserializedDate);
    }
}Code-Sprache: JavaScript (javascript)

Hier wird der JSON-String im ISO-Format bereitgestellt, und Jackson kümmert sich um die Deserialisierung in ein java.util.Date-Objekt.

Deserialisierung von Java 8 DateTime-Objekten

Die Deserialisierung von Java 8 DateTime-Objekten ist ebenfalls unkompliziert:

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import java.time.LocalDateTime;

public class DateTimeDeserializationExample {

    public static void main(String[] args) throws Exception {
        ObjectMapper objectMapper = new ObjectMapper();
        objectMapper.registerModule(new JavaTimeModule());

        String jsonDateTime = "\"2024-01-24T12:30:45\"";
        LocalDateTime deserializedDateTime = objectMapper.readValue(jsonDateTime, LocalDateTime.class);

        System.out.println("Deserialisiertes DateTime: " + deserializedDateTime);
    }
}Code-Sprache: JavaScript (javascript)

Durch das Registrieren des JavaTimeModule kann Jackson den JSON-String in ein LocalDateTime-Objekt umwandeln.

Serialisierung und Deserialisierung von OffsetDateTime

Neben den bereits behandelten java.util.Date– und Java 8 DateTime-Objekten bietet Jackson auch Unterstützung für OffsetDateTime. OffsetDateTime ist eine Klasse aus dem java.time-Paket und repräsentiert einen Datum und Uhrzeit mit einem festen Offset von der UTC-Zeit.

Serialisierung von OffsetDateTime

Die Serialisierung von OffsetDateTime ist ähnlich wie bei anderen DateTime-Objekten. Es ist jedoch wichtig sicherzustellen, dass der Offset im JSON-Format erhalten bleibt. Hier ein Beispiel:

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import java.time.OffsetDateTime;

public class OffsetDateTimeSerializationExample {

    public static void main(String[] args) throws Exception {
        ObjectMapper objectMapper = new ObjectMapper();
        objectMapper.registerModule(new JavaTimeModule());

        OffsetDateTime currentOffsetDateTime = OffsetDateTime.now();
        String jsonOffsetDateTime = objectMapper.writeValueAsString(currentOffsetDateTime);

        System.out.println("Serialisiertes OffsetDateTime: " + jsonOffsetDateTime);
    }
}Code-Sprache: JavaScript (javascript)

Durch das Hinzufügen des JavaTimeModule kann Jackson OffsetDateTime korrekt serialisieren, einschließlich des Offset-Teils.

Deserialisierung von OffsetDateTime

Die Deserialisierung von OffsetDateTime erfordert ebenfalls die Beachtung des Offset-Teils im JSON-Format:

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import java.time.OffsetDateTime;

public class OffsetDateTimeDeserializationExample {

    public static void main(String[] args) throws Exception {
        ObjectMapper objectMapper = new ObjectMapper();
        objectMapper.registerModule(new JavaTimeModule());

        String jsonOffsetDateTime = "\"2024-01-24T12:30:45+03:00\"";
        OffsetDateTime deserializedOffsetDateTime = objectMapper.readValue(jsonOffsetDateTime, OffsetDateTime.class);

        System.out.println("Deserialisiertes OffsetDateTime: " + deserializedOffsetDateTime);
    }
}Code-Sprache: JavaScript (javascript)

Hier wird der Offset im JSON-String im ISO-Format (z.B., +03:00 für eine Zeitzone mit einem Offset von 3 Stunden) angegeben, und Jackson kann das OffsetDateTime-Objekt entsprechend deserialisieren.

Problematik von Zeit-Offsets zwischen Rechnern in unterschiedlichen Zeitzonen

Bei der Übertragung von OffsetDateTime zwischen Rechnern in unterschiedlichen Zeitzonen besteht oft die Anforderung, dass der Offset genau so erhalten bleibt, wie er auf dem Quellsystem vorliegt. In solchen Fällen kann die Jackson-Option ADJUST_DATES_TO_CONTEXT_TIME_ZONE hilfreich sein. Diese Option wird verwendet, um sicherzustellen, dass der Offset im OffsetDateTime-Objekt unverändert bleibt und nicht an den Zeitzone-Kontext des Zielsystems angepasst wird.

ObjectMapper objectMapper = new ObjectMapper();
objectMapper.registerModule(new JavaTimeModule());
objectMapper.configure(SerializationFeature.ADJUST_DATES_TO_CONTEXT_TIME_ZONE, false);Code-Sprache: JavaScript (javascript)

Durch das Deaktivieren der Anpassung an die Zeitzone des Kontexts wird gewährleistet, dass der Offset im OffsetDateTime-Objekt erhalten bleibt und nicht durch den Zeitzone-Kontext des Zielsystems verändert wird.

Es ist jedoch wichtig zu beachten, dass diese Vorgehensweise zu potenziellen Problemen führen kann, wenn die Anwendung auf dem Zielsystem nicht in der Lage ist, den Offset korrekt zu interpretieren. Daher sollte dies nur dann verwendet werden, wenn sicher gestellt ist, dass beide Systeme den Offset eindeutig verstehen und interpretieren können.

Fazit

Die Serialisierung und Deserialisierung von Datums- und Zeitangaben mit Jackson in Java erlauben eine einfache und effiziente Handhabung von Zeitinformationen in JSON-Format. Durch die Verwendung von Jackson-Annotationen und -Modulen können sowohl die traditionelle java.util.Date-Klasse als auch die neuen Java 8 DateTime-Objekte problemlos integriert werden. Dies erleichtert die Interoperabilität zwischen Java-Anwendungen und externen Systemen, die JSON als Datenformat verwenden.