Table of Contents

Interface IOracleOutboxBuilder

Namespace
Excalibur.Outbox.Oracle
Assembly
Excalibur.Outbox.Oracle.dll

Fluent builder interface for configuring Oracle-specific outbox settings.

public interface IOracleOutboxBuilder
Extension Methods

Examples

outbox.UseOracle(oracle =>
{
    oracle.ConnectionString(connectionString)
            .SchemaName("messaging")
            .TableName("outbox_messages")
            .CommandTimeout(TimeSpan.FromSeconds(60))
            .ReservationTimeout(TimeSpan.FromMinutes(5));
});

Remarks

This builder configures Oracle-specific options such as table names, schema, command timeouts, and reservation behavior. All methods return this for method chaining.

Methods

BindConfiguration(string)

Binds options from an IConfiguration section.

IOracleOutboxBuilder BindConfiguration(string sectionPath)

Parameters

sectionPath string

The configuration section path.

Returns

IOracleOutboxBuilder

The builder for fluent chaining.

ConnectionFactory(Func<IServiceProvider, IDb>)

Sets a factory function that provides an IDb instance.

IOracleOutboxBuilder ConnectionFactory(Func<IServiceProvider, IDb> dbFactory)

Parameters

dbFactory Func<IServiceProvider, IDb>

A factory function that provides an IDb instance.

Returns

IOracleOutboxBuilder

The builder for fluent chaining.

Remarks

Use this for advanced scenarios like multi-database setups, custom connection pooling, or IDb integration. Mutually exclusive with ConnectionString(string). The last one set wins.

Exceptions

ArgumentNullException

Thrown when dbFactory is null.

ConnectionString(string)

Sets the connection string for the Oracle outbox database.

IOracleOutboxBuilder ConnectionString(string connectionString)

Parameters

connectionString string

The Oracle connection string.

Returns

IOracleOutboxBuilder

The builder for fluent chaining.

Remarks

This is the recommended way to provide a connection string for the outbox store. Mutually exclusive with ConnectionFactory(Func<IServiceProvider, IDb>). The last one set wins.

Exceptions

ArgumentException

Thrown when connectionString is null, empty, or whitespace.

ConnectionStringName(string)

Resolves the connection string from IConfiguration.GetConnectionString(name).

IOracleOutboxBuilder ConnectionStringName(string name)

Parameters

name string

The connection string name.

Returns

IOracleOutboxBuilder

The builder for fluent chaining.

DeadLetterTableName(string)

Sets the table name for storing dead letter messages.

IOracleOutboxBuilder DeadLetterTableName(string tableName)

Parameters

tableName string

The table name for dead letters.

Returns

IOracleOutboxBuilder

The builder for fluent chaining.

Remarks

Default is "outbox_dead_letters".

Exceptions

ArgumentException

Thrown when tableName is null, empty, or whitespace.

SchemaName(string)

Sets the schema name for the outbox tables.

IOracleOutboxBuilder SchemaName(string schema)

Parameters

schema string

The schema name (e.g., "public", "messaging").

Returns

IOracleOutboxBuilder

The builder for fluent chaining.

Remarks

Default is "public". Use this to organize outbox tables in a specific schema.

Exceptions

ArgumentException

Thrown when schema is null, empty, or whitespace.

TableName(string)

Sets the table name for storing outbox messages.

IOracleOutboxBuilder TableName(string tableName)

Parameters

tableName string

The table name.

Returns

IOracleOutboxBuilder

The builder for fluent chaining.

Remarks

Default is "outbox".

Exceptions

ArgumentException

Thrown when tableName is null, empty, or whitespace.