| commit | fe45858847c31226af28e6d06dc0e250d895e7c6 | [log] [tgz] |
|---|---|---|
| author | Matthias Andreas Benkard <code@mail.matthias.benkard.de> | Sat Dec 18 11:13:30 2021 +0100 |
| committer | Matthias Andreas Benkard <code@mail.matthias.benkard.de> | Sat Dec 18 11:13:30 2021 +0100 |
| tree | 465374b8483f76c63d6b821b42a66a36b645d751 | |
| parent | e5c63e787f39cd37fad98f543139dd27f71bdc07 [diff] |
README: Move the usage example above the installation instructions. Change-Id: I5d53715d18b59784140ec69d91e72ee6bc087c35
This library provides a GVariant parser in pure Java.
Instances of Decoder<T> read a given type of GVariant-encoded value from a ByteBuffer. The class also contains factory methods to acquire those instances.
The various subclasses of Decoder together implement the GVariant serialization specification.
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));
<project>
...
<dependencies>
...
<dependency>
<groupId>eu.mulk.jgvariant</groupId>
<artifactId>jgvariant-core</artifactId>
<version>0.1.0</version>
</dependency>
...
</dependencies>
...
</project>
dependencies {
...
implementation("eu.mulk.jgvariant:jgvariant-core:0.1.0")
...
}