resurfaceio-ndjson

Readers & writers for Resurface NDJSON files

This open source Java library makes it easy to parse or generate NDJSON payloads, streams, or compressed files in Resurface JSON format. This library can be used to parse messages from any compatible logger, as well as parsing NDJSON files exported from the Resurface database. This library also provides a write interface to generate compatible NDJSON files or payloads programmatically.

Usage

This library was originally designed for use by the Resurface database, for parsing messages from loggers, and for writing export files. The test cases included with this project include examples of generating NDJSON files, and parsing JSON messages in Resurface and IBM dialects.

This library is used by the importer and simulator utilities, for loading data into a Resurface database.

Dependencies

• Java 17
• google/gson

Installing with Maven

⚠️ We publish our official binaries on CloudSmith rather than Maven Central, because CloudSmith is awesome and free for open-source projects.

Simply add these sections to pom.xml to install:

<dependency>
    <groupId>io.resurface</groupId>
    <artifactId>resurfaceio-ndjson</artifactId>
    <version>3.6.5</version>
</dependency>
<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.10.1</version>
</dependency>

<repositories>
    <repository>
        <id>resurfaceio-public</id>
        <url>https://dl.cloudsmith.io/public/resurfaceio/public/maven/</url>
        <releases>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy>
        </releases>
    </repository>
</repositories>

---

© 2016-2024 Graylog, Inc.