Simplify types, replace Value with Variant.

Change-Id: I2e492ebfefc7e9a47c874ed22ff199412e9948ee
7 files changed
tree: 496e011fd0cf8c34d2634ce991f287b6a4ee4838
  1. .mvn/
  2. src/
  3. .gitignore
  4. COPYING
  5. COPYING.GPL
  6. pom.xml
  7. README.md
README.md

GVariant for Java

This library provides a GVariant parser in pure Java.

Overview

The two foundational classes are Value and Decoder.

Value is a sum type (sealed interface) that represents a GVariant value. Its subtypes represent the different types of values that GVariant supports.

Instances of Decoder read a given concrete subtype of Value from a ByteBuffer. The class also contains factory methods to create those instances.

The various subclasses of Decoder together implement the GVariant serialization specification.

Example

To parse a GVariant value of type "a(si)", which is an array of pairs of String and int, you can use the following code:

record ExampleRecord(String s, int i) {}

var decoder =
  Decoder.ofArray(
    Decoder.ofStructure(
      ExampleRecord.class,
      Decoder.ofString(StandardCharsets.UTF_8),
      Decoder.ofInt().withByteOrder(ByteOrder.LITTLE_ENDIAN)));

byte[] bytes = ...;
List<ExampleRecord> example = decoder.decode(ByteBuffer.wrap(bytes));