Class ErrorResult

java.lang.Object

io.fluxzero.common.api.AbstractRequestResult

io.fluxzero.common.api.ErrorResult

All Implemented Interfaces:

JsonType, RequestResult

public class ErrorResult
extends AbstractRequestResult

A generic error response returned when a request could not be completed successfully.

Contains a textual error message explaining the failure. This class is often returned in place of the expected RequestResult if an error occurs in the Fluxzero Runtime or client.

Exception Behavior

If an ErrorResult is received for a Request, the associated CompletableFuture will be completed exceptionally with a ServiceException that wraps the error message. This allows applications to handle errors via standard future.exceptionally(...) mechanisms.

keyValueClient.send(new GetValue("missingKey"))
           .exceptionally(error -> {
               if (error instanceof ServiceException) {
                   log.warn("Failed: {}", error.getMessage());
               }
               return null;
           });

See Also:

• RequestResult

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	ErrorResult.ModelHistoryUnavailable	A Model has changed after the requested boundary and lacks the history required to recover its earlier head.

Constructor Summary

Constructors

Constructor	Description
ErrorResult(long requestId, String message)	Creates an ordinary unstructured request failure.
ErrorResult(long requestId, String message, ErrorResult.ModelHistoryUnavailable modelHistoryUnavailable)	Creates a failure with optional, typed historical-read evidence.

Method Summary

Methods inherited from class AbstractRequestResult

getRequestReceivedTimestamp, getResponseQueuedTimestamp, getResponseSendStartTimestamp, setRequestReceivedTimestamp, setResponseQueuedTimestamp, setResponseSendStartTimestamp

Methods inherited from class Object

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

Methods inherited from interface JsonType

toMetric

Methods inherited from interface RequestResult

getRequestId, getTimestamp

Constructor Details

ErrorResult

public ErrorResult(long requestId,
 String message)

Creates an ordinary unstructured request failure.

ErrorResult

@ConstructorProperties({"requestId","message","modelHistoryUnavailable"})
public ErrorResult(long requestId,
 String message,
 ErrorResult.ModelHistoryUnavailable modelHistoryUnavailable)

Creates a failure with optional, typed historical-read evidence.