surrealdb.java

The official SurrealDB library for Java.

Features

• Sync & Async driver implementations available.
• Complex JSON serialization & deserialization to Java classes.
• Simple API (very similar to the Javascript driver, see docs).

Installation

• For now, you can grab the JAR from the releases page here.
• Put it in libs folder.
• Add the JAR to you project:

Gradle:

repositories {
    maven {
        url = uri("https://maven.pkg.github.com/surrealdb/surrealdb.java")
    }
}
implementation files('libs/surrealdb-0.1.0.jar')

Maven:

<settings>
    <repositories>
        <repository>
            <id>surrealdb-github</id>
            <url>https://maven.pkg.github.com/surrealdb/surrealdb.java</url>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
        </repository>
    </repositories>
    <dependencies>
        <dependency>
            <groupId>com.surrealdb</groupId>
            <artifactId>driver</artifactId>
            <version>0.1.0</version>
        </dependency>
    </dependencies>
</settings>

Quick Start

package org.example;

import com.surrealdb.connection.SurrealConnection;
import com.surrealdb.connection.SurrealWebSocketConnection;
import com.surrealdb.driver.SyncSurrealDriver;

import java.util.List;

public class Main {
    public static void main(String[] args) {
        SurrealConnection connection = new SurrealWebSocketConnection("127.0.0.1", 8000);
        connection.connect(30); // timeout after 30 seconds

        SyncSurrealDriver driver = new SyncSurrealDriver(connection);

        driver.signIn("root", "root"); // username & password
        driver.use("test", "test"); // namespace & database

        Person tobie = driver.create("person", new Person("Founder & CEO", "Tobie", "Morgan Hitchcock", true));

        List<Person> people = driver.select("person", Person.class);

        System.out.println();
        System.out.println("Tobie = "+tobie);
        System.out.println();
        System.out.println("people = "+people);
        System.out.println();

        connection.disconnect();
        
        // for more docs, see https://surrealdb.com/docs/integration/libraries/nodejs
    }
}

class Person {
    String id;
    String title;
    String firstName;
    String lastName;
    boolean marketing;

    public Person(String title, String firstName, String lastName, boolean marketing) {
        this.title = title;
        this.firstName = firstName;
        this.lastName = lastName;
        this.marketing = marketing;
    }

    @Override
    public String toString() {
        return "Person{" +
                "id='" + id + '\'' +
                ", title='" + title + '\'' +
                ", firstName='" + firstName + '\'' +
                ", lastName='" + lastName + '\'' +
                ", marketing=" + marketing +
                '}';
    }
}

Planned Features

• A complete SDK With Repository pattern.
• JDBC interface (work in progress can be found in src/main/java/com/surrealdb/jdbc)
• Open an issue for feature requests

Minimum Requirements

• Java 17