Table of Contents

Class FirestoreStalePositionException

Namespace
Excalibur.Cdc.Firestore
Assembly
Excalibur.Cdc.Firestore.dll

Exception thrown when the Firestore CDC processor detects a stale position that cannot be recovered automatically.

public sealed class FirestoreStalePositionException : CdcStalePositionException, ISerializable
Inheritance
FirestoreStalePositionException
Implements
Inherited Members

Remarks

This exception is thrown in the following scenarios:

  • The recovery strategy is Throw
  • The maximum recovery attempts have been exhausted
  • The callback strategy throws or fails to provide a valid new position

The EventArgs property contains detailed information about the stale position, including the reason code, affected positions, and original exception.

Constructors

FirestoreStalePositionException()

Initializes a new instance of the FirestoreStalePositionException class.

public FirestoreStalePositionException()

FirestoreStalePositionException(CdcPositionResetEventArgs)

Initializes a new instance of the FirestoreStalePositionException class with the specified event arguments.

public FirestoreStalePositionException(CdcPositionResetEventArgs eventArgs)

Parameters

eventArgs CdcPositionResetEventArgs

The stale position event arguments.

FirestoreStalePositionException(string)

Initializes a new instance of the FirestoreStalePositionException class with a specified error message.

public FirestoreStalePositionException(string message)

Parameters

message string

The error message.

FirestoreStalePositionException(string, CdcPositionResetEventArgs)

Initializes a new instance of the FirestoreStalePositionException class with a custom message and event arguments.

public FirestoreStalePositionException(string message, CdcPositionResetEventArgs eventArgs)

Parameters

message string

The error message.

eventArgs CdcPositionResetEventArgs

The stale position event arguments.

FirestoreStalePositionException(string, Exception)

Initializes a new instance of the FirestoreStalePositionException class with a specified error message and inner exception.

public FirestoreStalePositionException(string message, Exception innerException)

Parameters

message string

The error message.

innerException Exception

The inner exception.

Properties

CollectionPath

Gets the collection path that was affected.

public string? CollectionPath { get; }

Property Value

string

The collection path, or null if not available.

DocumentId

Gets the document ID that was affected.

public string? DocumentId { get; }

Property Value

string

The document ID, or null if not available.

GrpcStatusCode

Gets the gRPC status code that indicated the stale position.

public int? GrpcStatusCode { get; }

Property Value

int?

The gRPC status code, or null if not available.

ProjectId

Gets the Firestore project ID that was affected.

public string? ProjectId { get; }

Property Value

string

The project ID, or null if not available.