Interface IOracleOutboxBuilder
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
sectionPathstringThe 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
dbFactoryFunc<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
dbFactoryis null.
ConnectionString(string)
Sets the connection string for the Oracle outbox database.
IOracleOutboxBuilder ConnectionString(string connectionString)
Parameters
connectionStringstringThe 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
connectionStringis null, empty, or whitespace.
ConnectionStringName(string)
Resolves the connection string from IConfiguration.GetConnectionString(name).
IOracleOutboxBuilder ConnectionStringName(string name)
Parameters
namestringThe 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
tableNamestringThe table name for dead letters.
Returns
- IOracleOutboxBuilder
The builder for fluent chaining.
Remarks
Default is "outbox_dead_letters".
Exceptions
- ArgumentException
Thrown when
tableNameis null, empty, or whitespace.
SchemaName(string)
Sets the schema name for the outbox tables.
IOracleOutboxBuilder SchemaName(string schema)
Parameters
schemastringThe 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
schemais null, empty, or whitespace.
TableName(string)
Sets the table name for storing outbox messages.
IOracleOutboxBuilder TableName(string tableName)
Parameters
tableNamestringThe table name.
Returns
- IOracleOutboxBuilder
The builder for fluent chaining.
Remarks
Default is "outbox".
Exceptions
- ArgumentException
Thrown when
tableNameis null, empty, or whitespace.