Files
quicproquo/sdks/java
Christian Nennemann a710037dde chore: rename quicproquo → quicprochat in Rust workspace
Rename all crate directories, package names, binary names, proto
package/module paths, ALPN strings, env var prefixes, config filenames,
mDNS service names, and plugin ABI symbols from quicproquo/qpq to
quicprochat/qpc.
2026-03-21 19:14:06 +01:00
..

QuicProQuo Java SDK

Java wrapper over libquicproquo_ffi via JNI for JVM and Android.

Prerequisites

  • JDK 17+
  • libquicproquo_ffi built for the target platform
  • JNI bridge compiled (shared with Kotlin SDK: ../kotlin/jni/)

Building

# Build Rust FFI library
cargo build --release -p quicproquo-ffi

# Build Java SDK
./gradlew build

Usage

import dev.quicproquo.QpqClient;

try (QpqClient client = new QpqClient("127.0.0.1:5001", "ca.pem")) {
    client.login("alice", "secret");
    client.send("bob", "hello".getBytes());

    var messages = client.receive(5000);
    messages.forEach(msg -> System.out.println("Received: " + msg));
}

API

Method Description
new QpqClient(server, caCertPath) Connect to server
client.login(username, password) OPAQUE authentication
client.send(recipient, message) Send message by username
client.receive(timeoutMs) Receive pending messages
client.close() / client.disconnect() Disconnect
client.isConnected() Connection status

Structure

  • src/main/java/dev/quicproquo/QpqClient.java -- High-level client
  • src/main/java/dev/quicproquo/NativeBridge.java -- JNI declarations
  • JNI C bridge shared with Kotlin SDK at ../kotlin/jni/