Class CdcBuilderInMemoryExtensions
Extension methods for configuring in-memory CDC provider on ICdcBuilder.
public static class CdcBuilderInMemoryExtensions
- Inheritance
-
CdcBuilderInMemoryExtensions
- Inherited Members
Remarks
These extensions provide fluent provider selection by adding provider-specific configuration to the core ICdcBuilder interface.
Methods
UseInMemory(ICdcBuilder, IInMemoryCdcStore, Action<IInMemoryCdcBuilder>?)
Configures the CDC processor to use an in-memory provider with a pre-configured store.
public static ICdcBuilder UseInMemory(this ICdcBuilder builder, IInMemoryCdcStore store, Action<IInMemoryCdcBuilder>? configure = null)
Parameters
builderICdcBuilderThe CDC builder.
storeIInMemoryCdcStoreThe pre-configured in-memory store instance.
configureAction<IInMemoryCdcBuilder>Optional action to configure in-memory-specific options.
Returns
- ICdcBuilder
The builder for fluent chaining.
Examples
var store = new InMemoryCdcStore();
store.AddChange(InMemoryCdcChange.Insert("dbo.Orders", ...));
services.AddCdcProcessor(cdc =>
{
cdc.UseInMemory(store, mem =>
{
mem.BatchSize(10);
});
});
Remarks
Use this overload when you want to share a pre-configured store instance across multiple tests or provide a store with pre-populated changes.
Exceptions
- ArgumentNullException
Thrown when
builderorstoreis null.
UseInMemory(ICdcBuilder, Action<IInMemoryCdcBuilder>?)
Configures the CDC processor to use an in-memory provider for testing.
public static ICdcBuilder UseInMemory(this ICdcBuilder builder, Action<IInMemoryCdcBuilder>? configure = null)
Parameters
builderICdcBuilderThe CDC builder.
configureAction<IInMemoryCdcBuilder>Optional action to configure in-memory-specific options.
Returns
- ICdcBuilder
The builder for fluent chaining.
Examples
// Basic usage for testing
services.AddCdcProcessor(cdc =>
{
cdc.UseInMemory()
.TrackTable("dbo.Orders", table =>
{
table.MapInsert<OrderCreatedEvent>()
.MapUpdate<OrderUpdatedEvent>()
.MapDelete<OrderDeletedEvent>();
});
});
// Later in test code, inject changes:
var store = services.GetRequiredService<IInMemoryCdcStore>();
store.AddChange(InMemoryCdcChange.Insert("dbo.Orders", new CdcDataChange
{
ColumnName = "Id",
NewValue = 1
}));
Remarks
This provider is designed for testing scenarios where a real database connection is not available or not desired. It registers the InMemoryCdcProcessor and Excalibur.Cdc.InMemory.InMemoryCdcStore.
The in-memory store is registered as a singleton to allow test code to inject simulated changes via IInMemoryCdcStore.
Exceptions
- ArgumentNullException
Thrown when
builderis null.