Table of Contents

Class CdcBuilderInMemoryExtensions

Namespace
Excalibur.Cdc.InMemory
Assembly
Excalibur.Cdc.dll

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

builder ICdcBuilder

The CDC builder.

store IInMemoryCdcStore

The pre-configured in-memory store instance.

configure Action<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 builder or store is 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

builder ICdcBuilder

The CDC builder.

configure Action<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 builder is null.