Skip to content

DJUTILS SERIALIZATION

What is in the DJUTILS-SERIALIZATION project?

DJUTILS-SERIALIZATION contains a set of Java classes that can do strongly-typed serialization and deserialization of data. Example uses are network traffic where different programming languages are involved. We are not the first attempt to solve this problem. Many have gone before us, e.g.:

  • XML: extremely verbose format, requires complex encoders and parsers.
  • GZip-compressed XML: compact, requires complex encoders and parsers.
  • protobuf: not self-documenting, uses overly complex encoders and parsers (generated by a code generator).
  • ASN.1: most tools (code generators for encoders and decoders) only available in C or C++, or not open source

The (de)serialization methods are used by other TU Delft projects such as SIM0MQ.

Some properties:

  • DJUTILS-SERIALIZATION stores one byte before each serialized field that indicates its type (compact and self-documenting encoded data).
  • DJUTILS-SERIALIZATION can use little-endian and big-endian encoding for multi-byte values (portability among different CPU types).
  • DJUTILS-SERIALIZATION handles Scalars, Vectors and Matrices from DJUNITS, including the scalar type and display type (e.g. Length in kilometers, Duration in minutes, an AreaVector in acres).
  • DJUTILS-SERIALIZATION is the basis for the (de)serialization of types in the SIM0MQ project.

Origin

DJUTILS-SERIALIZATION was developed at the Delft University of Technology as part of the SIM0MQ project and further refined within the Open Traffic Simulator project. The main authors/contributors of the DJUTILS project are Alexander Verbraeck, Wouter Schakel and Peter Knoppers for the Java implementation, and Alexander Verbraeck, Wouter Schakel, Sibel Eker and Jan Kwakkel for the Python implementation. There is also a partial C++ implementation.

Maven use

Maven is one of the easiest ways to include DJUTILS-SERIALIZATION in a Java project. The Maven files for DJUTILS-SERIALIZATION reside at Maven Central as of version 2.0.0. When a POM-file is created for the project, the following snippet needs to be included to include DJUTILS-SERIALIZATION:

<dependencies>
  <dependency>
    <groupId>org.djutils</groupId>
    <artifactId>djutils-serialization</artifactId>
    <version>2.3.0</version>
  </dependency>
</dependencies>

Of course, the version number (2.3.0 in the above example) needs to be replaced with the version that one wants to include in the project.

DJUTILS-SERIALIZATION jars before version 2 are kept on a server at TU Delft at https://djutils.org/maven.

Dependencies

DJUTILS-SERIALIZATION is directly dependent on two packages (djutils and djunits), which have a few further dependencies:

  • djutils for the base helper classes
  • djunits for the scalar, vector and matrix fields
  • tinylog for providing an easy-to-use and fast logger (via djutils)
  • jakarta.annotation-api for annotation code after Java-8 (via djunits)

If the DJUTILS-SERIALIZATION library is used as a part of a Maven project, all dependencies will be automatically resolved, and the programmer / user does not have to worry about finding the libraries.

Documentation and test reports: