Package dev.dokimos.server.client

Class DokimosServerReporter.Builder

java.lang.Object

dev.dokimos.server.client.DokimosServerReporter.Builder

Enclosing class:

DokimosServerReporter

public static class DokimosServerReporter.Builder
extends Object

Builder for DokimosServerReporter.

Method Summary

Modifier and Type	Method	Description
DokimosServerReporter.Builder	apiKey(String apiKey)	Bearer API key for authentication.
DokimosServerReporter.Builder	apiVersion(String apiVersion)	API version, e.g.
DokimosServerReporter	build()
DokimosServerReporter.Builder	onItemDeliveryFailure(Consumer<DokimosServerReporter.ItemDeliveryFailure> onItemDeliveryFailure)	Callback invoked when a batch of items is permanently dropped after all delivery retries.
DokimosServerReporter.Builder	projectName(String projectName)	Project name on the server.
DokimosServerReporter.Builder	serverUrl(String serverUrl)	Dokimos server URL, e.g.
DokimosServerReporter.Builder	spoolDirectory(Path spoolDirectory)	Opt-in durable spool directory.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

serverUrl

public DokimosServerReporter.Builder serverUrl(String serverUrl)

Dokimos server URL, e.g. "https://api.my-domain.com".

projectName

public DokimosServerReporter.Builder projectName(String projectName)

Project name on the server.

apiVersion

public DokimosServerReporter.Builder apiVersion(String apiVersion)

API version, e.g. "v1". Defaults to DokimosServerReporter.DEFAULT_API_VERSION.

apiKey

public DokimosServerReporter.Builder apiKey(String apiKey)

Bearer API key for authentication.

onItemDeliveryFailure

public DokimosServerReporter.Builder onItemDeliveryFailure(Consumer<DokimosServerReporter.ItemDeliveryFailure> onItemDeliveryFailure)

Callback invoked when a batch of items is permanently dropped after all delivery retries. The callback runs on the reporter's background worker thread, so keep it lightweight and do NOT call flush(), close(), or reportItem(...) on this reporter from it; doing so re-enters the worker and stalls delivery. Exceptions thrown by the callback are caught and logged.

spoolDirectory

public DokimosServerReporter.Builder spoolDirectory(Path spoolDirectory)

Opt-in durable spool directory. When set, permanently-failed item batches are appended as JSON lines to failed-items.ndjson in this directory so a transient outage past all retries does not silently lose data. Defaults to null (disabled).

build

public DokimosServerReporter build()

Throws:

IllegalStateException - if serverUrl or projectName is not set.