Table of Contents

Interface IPersistenceProviderConnection

Namespace
Excalibur.Data.Persistence
Assembly
Excalibur.Data.Abstractions.dll

Exposes how a persistence provider reaches its store, and how it behaves when reaching it fails. Obtain via GetService(Type) with typeof(IPersistenceProviderConnection).

public interface IPersistenceProviderConnection

Remarks

This capability answers "where is the store, and what does this provider do about transient failure". It says nothing about whether the store can run a multi-statement transaction — that is IPersistenceProviderTransaction, resolved separately.

The two are separate because the sets of providers that can honour them differ. Every provider that holds a connection can describe it and can describe its retry policy. Only stores with an ambient, open-ended transaction model can honour a transaction scope; document and key-value stores generally cannot. A single contract spanning both would force those providers to choose between advertising a transaction facility they cannot deliver and withholding connection details they can, and neither answer is true.

Properties

ConnectionString

Gets the connection string or connection configuration for the provider.

string ConnectionString { get; }

Property Value

string

The connection string or connection configuration for the provider.

RetryPolicy

Gets the retry policy used for DataRequest execution.

IDataRequestRetryPolicy RetryPolicy { get; }

Property Value

IDataRequestRetryPolicy

The retry policy used for DataRequest execution.