public enum StreamsError extends java.lang.Enum<StreamsError> implements com.google.protobuf.ProtocolMessageEnum
Error codes specific to the Streams API. These errors represent failure modes when working with streams of records.Protobuf enum
kurrentdb.protocol.v2.streams.errors.StreamsError| Enum Constant and Description |
|---|
STREAMS_ERROR_APPEND_RECORD_SIZE_EXCEEDED
A single record being appended exceeds the maximum allowed size.
|
STREAMS_ERROR_APPEND_SESSION_NO_REQUESTS
An append session was started but no append requests were sent before completing the stream.
|
STREAMS_ERROR_APPEND_TRANSACTION_SIZE_EXCEEDED
The total size of all records in a single append session exceeds the maximum allowed transaction size.
|
STREAMS_ERROR_STREAM_ALREADY_EXISTS
The stream already exists when an operation expected it not to exist.
|
STREAMS_ERROR_STREAM_ALREADY_IN_APPEND_SESSION
The same stream appears multiple times in a single append session.
|
STREAMS_ERROR_STREAM_DELETED
The stream has been soft deleted.
|
STREAMS_ERROR_STREAM_NOT_FOUND
The requested stream does not exist in the database.
|
STREAMS_ERROR_STREAM_REVISION_CONFLICT
The expected revision does not match the actual stream revision.
|
STREAMS_ERROR_STREAM_TOMBSTONED
The stream has been tombstoned (permanently deleted).
|
STREAMS_ERROR_UNSPECIFIED
Default value.
|
UNRECOGNIZED |
| Modifier and Type | Field and Description |
|---|---|
static int |
STREAMS_ERROR_APPEND_RECORD_SIZE_EXCEEDED_VALUE
A single record being appended exceeds the maximum allowed size.
|
static int |
STREAMS_ERROR_APPEND_SESSION_NO_REQUESTS_VALUE
An append session was started but no append requests were sent before completing the stream.
|
static int |
STREAMS_ERROR_APPEND_TRANSACTION_SIZE_EXCEEDED_VALUE
The total size of all records in a single append session exceeds the maximum allowed transaction size.
|
static int |
STREAMS_ERROR_STREAM_ALREADY_EXISTS_VALUE
The stream already exists when an operation expected it not to exist.
|
static int |
STREAMS_ERROR_STREAM_ALREADY_IN_APPEND_SESSION_VALUE
The same stream appears multiple times in a single append session.
|
static int |
STREAMS_ERROR_STREAM_DELETED_VALUE
The stream has been soft deleted.
|
static int |
STREAMS_ERROR_STREAM_NOT_FOUND_VALUE
The requested stream does not exist in the database.
|
static int |
STREAMS_ERROR_STREAM_REVISION_CONFLICT_VALUE
The expected revision does not match the actual stream revision.
|
static int |
STREAMS_ERROR_STREAM_TOMBSTONED_VALUE
The stream has been tombstoned (permanently deleted).
|
static int |
STREAMS_ERROR_UNSPECIFIED_VALUE
Default value.
|
| Modifier and Type | Method and Description |
|---|---|
static StreamsError |
forNumber(int value) |
static com.google.protobuf.Descriptors.EnumDescriptor |
getDescriptor() |
com.google.protobuf.Descriptors.EnumDescriptor |
getDescriptorForType() |
int |
getNumber() |
com.google.protobuf.Descriptors.EnumValueDescriptor |
getValueDescriptor() |
static com.google.protobuf.Internal.EnumLiteMap<StreamsError> |
internalGetValueMap() |
static StreamsError |
valueOf(com.google.protobuf.Descriptors.EnumValueDescriptor desc) |
static StreamsError |
valueOf(int value)
Deprecated.
Use
forNumber(int) instead. |
static StreamsError |
valueOf(java.lang.String name)
Returns the enum constant of this type with the specified name.
|
static StreamsError[] |
values()
Returns an array containing the constants of this enum type, in
the order they are declared.
|
public static final StreamsError STREAMS_ERROR_UNSPECIFIED
Default value. This value is not used. An error code MUST always be set to a non-zero value. If an error code is not explicitly set, it MUST be treated as an internal server error (INTERNAL).
STREAMS_ERROR_UNSPECIFIED = 0;public static final StreamsError STREAMS_ERROR_STREAM_NOT_FOUND
The requested stream does not exist in the database. Common causes: - Stream name typo or incorrect stream identifier - Stream was never created (no events appended yet) - Stream was deleted and not yet recreated Client action: Verify the stream name is correct. Create the stream by appending to it. Recoverable by creating the stream first (append with NO_STREAM expected revision).
STREAMS_ERROR_STREAM_NOT_FOUND = 1 [(.kurrent.rpc.error) = { ... }public static final StreamsError STREAMS_ERROR_STREAM_ALREADY_EXISTS
The stream already exists when an operation expected it not to exist. Common causes: - Attempting to create a stream that already has events - Using NO_STREAM expected revision on an existing stream - Race condition with concurrent stream creation Client action: Use the existing stream or use a different expected revision. Recoverable by adjusting the expected revision or using the existing stream.
STREAMS_ERROR_STREAM_ALREADY_EXISTS = 2 [(.kurrent.rpc.error) = { ... }public static final StreamsError STREAMS_ERROR_STREAM_DELETED
The stream has been soft deleted. Soft-deleted streams are hidden from stream lists but can be restored by appending to them. Common causes: - Stream was explicitly soft-deleted via delete operation - Attempting to read from a soft-deleted stream Client action: Restore the stream by appending new events, or accept that the stream is deleted. Recoverable by appending to the stream to restore it.
STREAMS_ERROR_STREAM_DELETED = 3 [(.kurrent.rpc.error) = { ... }public static final StreamsError STREAMS_ERROR_STREAM_TOMBSTONED
The stream has been tombstoned (permanently deleted). Tombstoned streams cannot be restored and will never accept new events. Common causes: - Stream was explicitly tombstoned via tombstone operation - Administrative deletion of sensitive data - Attempting to write to or read from a tombstoned stream Client action: Stream is permanently removed. Create a new stream with a different name if needed. Not recoverable - the stream cannot be restored.
STREAMS_ERROR_STREAM_TOMBSTONED = 4 [(.kurrent.rpc.error) = { ... }public static final StreamsError STREAMS_ERROR_STREAM_REVISION_CONFLICT
The expected revision does not match the actual stream revision. This is an optimistic concurrency control failure. Common causes: - Another client modified the stream concurrently - Client has stale state about the stream revision - Race condition in distributed system Client action: Fetch the current stream revision and retry with the correct expected revision. Recoverable by reading the current state and retrying with proper optimistic concurrency control.
STREAMS_ERROR_STREAM_REVISION_CONFLICT = 5 [(.kurrent.rpc.error) = { ... }public static final StreamsError STREAMS_ERROR_APPEND_RECORD_SIZE_EXCEEDED
A single record being appended exceeds the maximum allowed size. Common causes: - Record payload is too large (exceeds server's max record size configuration) - Excessive metadata in properties - Large binary data without chunking Client action: Reduce record size, split large payloads across multiple records, or increase server limits. Recoverable by reducing record size or adjusting server configuration.
STREAMS_ERROR_APPEND_RECORD_SIZE_EXCEEDED = 6 [(.kurrent.rpc.error) = { ... }public static final StreamsError STREAMS_ERROR_APPEND_TRANSACTION_SIZE_EXCEEDED
The total size of all records in a single append session exceeds the maximum allowed transaction size. Common causes: - Too many records in a single append session - Combined payload size exceeds server's max transaction size - Attempting to write very large batches Client action: Split the append into multiple smaller transactions. Recoverable by reducing the number of records per append session.
STREAMS_ERROR_APPEND_TRANSACTION_SIZE_EXCEEDED = 7 [(.kurrent.rpc.error) = { ... }public static final StreamsError STREAMS_ERROR_STREAM_ALREADY_IN_APPEND_SESSION
The same stream appears multiple times in a single append session. This is currently not supported to prevent complexity with expected revisions and ordering. Common causes: - Accidentally appending to the same stream twice in one session - Application logic error in batch operations Client action: Remove duplicate streams from the append session or split into multiple sessions. Recoverable by restructuring the append session to reference each stream only once.
STREAMS_ERROR_STREAM_ALREADY_IN_APPEND_SESSION = 8 [(.kurrent.rpc.error) = { ... }public static final StreamsError STREAMS_ERROR_APPEND_SESSION_NO_REQUESTS
An append session was started but no append requests were sent before completing the stream. Common causes: - Client completed the stream without sending any AppendRequest messages - Application logic error Client action: Ensure at least one AppendRequest is sent before completing the stream. Recoverable by properly implementing the append session protocol.
STREAMS_ERROR_APPEND_SESSION_NO_REQUESTS = 9 [(.kurrent.rpc.error) = { ... }public static final StreamsError UNRECOGNIZED
public static final int STREAMS_ERROR_UNSPECIFIED_VALUE
Default value. This value is not used. An error code MUST always be set to a non-zero value. If an error code is not explicitly set, it MUST be treated as an internal server error (INTERNAL).
STREAMS_ERROR_UNSPECIFIED = 0;public static final int STREAMS_ERROR_STREAM_NOT_FOUND_VALUE
The requested stream does not exist in the database. Common causes: - Stream name typo or incorrect stream identifier - Stream was never created (no events appended yet) - Stream was deleted and not yet recreated Client action: Verify the stream name is correct. Create the stream by appending to it. Recoverable by creating the stream first (append with NO_STREAM expected revision).
STREAMS_ERROR_STREAM_NOT_FOUND = 1 [(.kurrent.rpc.error) = { ... }public static final int STREAMS_ERROR_STREAM_ALREADY_EXISTS_VALUE
The stream already exists when an operation expected it not to exist. Common causes: - Attempting to create a stream that already has events - Using NO_STREAM expected revision on an existing stream - Race condition with concurrent stream creation Client action: Use the existing stream or use a different expected revision. Recoverable by adjusting the expected revision or using the existing stream.
STREAMS_ERROR_STREAM_ALREADY_EXISTS = 2 [(.kurrent.rpc.error) = { ... }public static final int STREAMS_ERROR_STREAM_DELETED_VALUE
The stream has been soft deleted. Soft-deleted streams are hidden from stream lists but can be restored by appending to them. Common causes: - Stream was explicitly soft-deleted via delete operation - Attempting to read from a soft-deleted stream Client action: Restore the stream by appending new events, or accept that the stream is deleted. Recoverable by appending to the stream to restore it.
STREAMS_ERROR_STREAM_DELETED = 3 [(.kurrent.rpc.error) = { ... }public static final int STREAMS_ERROR_STREAM_TOMBSTONED_VALUE
The stream has been tombstoned (permanently deleted). Tombstoned streams cannot be restored and will never accept new events. Common causes: - Stream was explicitly tombstoned via tombstone operation - Administrative deletion of sensitive data - Attempting to write to or read from a tombstoned stream Client action: Stream is permanently removed. Create a new stream with a different name if needed. Not recoverable - the stream cannot be restored.
STREAMS_ERROR_STREAM_TOMBSTONED = 4 [(.kurrent.rpc.error) = { ... }public static final int STREAMS_ERROR_STREAM_REVISION_CONFLICT_VALUE
The expected revision does not match the actual stream revision. This is an optimistic concurrency control failure. Common causes: - Another client modified the stream concurrently - Client has stale state about the stream revision - Race condition in distributed system Client action: Fetch the current stream revision and retry with the correct expected revision. Recoverable by reading the current state and retrying with proper optimistic concurrency control.
STREAMS_ERROR_STREAM_REVISION_CONFLICT = 5 [(.kurrent.rpc.error) = { ... }public static final int STREAMS_ERROR_APPEND_RECORD_SIZE_EXCEEDED_VALUE
A single record being appended exceeds the maximum allowed size. Common causes: - Record payload is too large (exceeds server's max record size configuration) - Excessive metadata in properties - Large binary data without chunking Client action: Reduce record size, split large payloads across multiple records, or increase server limits. Recoverable by reducing record size or adjusting server configuration.
STREAMS_ERROR_APPEND_RECORD_SIZE_EXCEEDED = 6 [(.kurrent.rpc.error) = { ... }public static final int STREAMS_ERROR_APPEND_TRANSACTION_SIZE_EXCEEDED_VALUE
The total size of all records in a single append session exceeds the maximum allowed transaction size. Common causes: - Too many records in a single append session - Combined payload size exceeds server's max transaction size - Attempting to write very large batches Client action: Split the append into multiple smaller transactions. Recoverable by reducing the number of records per append session.
STREAMS_ERROR_APPEND_TRANSACTION_SIZE_EXCEEDED = 7 [(.kurrent.rpc.error) = { ... }public static final int STREAMS_ERROR_STREAM_ALREADY_IN_APPEND_SESSION_VALUE
The same stream appears multiple times in a single append session. This is currently not supported to prevent complexity with expected revisions and ordering. Common causes: - Accidentally appending to the same stream twice in one session - Application logic error in batch operations Client action: Remove duplicate streams from the append session or split into multiple sessions. Recoverable by restructuring the append session to reference each stream only once.
STREAMS_ERROR_STREAM_ALREADY_IN_APPEND_SESSION = 8 [(.kurrent.rpc.error) = { ... }public static final int STREAMS_ERROR_APPEND_SESSION_NO_REQUESTS_VALUE
An append session was started but no append requests were sent before completing the stream. Common causes: - Client completed the stream without sending any AppendRequest messages - Application logic error Client action: Ensure at least one AppendRequest is sent before completing the stream. Recoverable by properly implementing the append session protocol.
STREAMS_ERROR_APPEND_SESSION_NO_REQUESTS = 9 [(.kurrent.rpc.error) = { ... }public static StreamsError[] values()
for (StreamsError c : StreamsError.values()) System.out.println(c);
public static StreamsError valueOf(java.lang.String name)
name - the name of the enum constant to be returned.java.lang.IllegalArgumentException - if this enum type has no constant with the specified namejava.lang.NullPointerException - if the argument is nullpublic final int getNumber()
getNumber in interface com.google.protobuf.Internal.EnumLitegetNumber in interface com.google.protobuf.ProtocolMessageEnum@Deprecated public static StreamsError valueOf(int value)
forNumber(int) instead.value - The numeric wire value of the corresponding enum entry.public static StreamsError forNumber(int value)
value - The numeric wire value of the corresponding enum entry.public static com.google.protobuf.Internal.EnumLiteMap<StreamsError> internalGetValueMap()
public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor()
getValueDescriptor in interface com.google.protobuf.ProtocolMessageEnumpublic final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType()
getDescriptorForType in interface com.google.protobuf.ProtocolMessageEnumpublic static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor()
public static StreamsError valueOf(com.google.protobuf.Descriptors.EnumValueDescriptor desc)