SQL Server

SQL Server 是由微软开发的一个关系型数据库，你可以使用 SQL Server 来作为 CAP 消息的持久化。

注意

我们目前使用 Microsoft.Data.SqlClient 作为数据库驱动程序，它是SQL Server 驱动的未来，并且已经放弃了 System.Data.SqlClient，我们建议你切换过去。

配置

要使用 SQL Server 存储，你需要从 NuGet 安装以下扩展包：

Install-Package DotNetCore.CAP.SqlServer

然后，你可以在 Startup.cs 的 ConfigureServices 方法中添加基于内存的配置项。

public void ConfigureServices(IServiceCollection services)
{
    // ...

    services.AddCap(x =>
    {
        x.UseSqlServer(opt=>{
            //SqlServerOptions
        }); 
        // x.UseXXX ...
    });
}

配置项

NAME	DESCRIPTION	TYPE	DEFAULT
Schema	数据库架构	string	Cap
ConnectionString	数据库连接字符串	string

自定义表名称

你可以通过重写 IStorageInitializer 接口获取表名称的方法来做到这一点

示例代码：

public class MyTableInitializer : SqlServerStorageInitializer
{
    public override string GetPublishedTableName()
    {
        //你的 发送消息表 名称
    }

    public override string GetReceivedTableName()
    {
        //你的 接收消息表 名称
    }
}

然后将你的实现注册到容器中

services.AddSingleton<IStorageInitializer, MyTableInitializer>();

使用事务发布消息

ADO.NET

private readonly ICapPublisher _capBus;

using (var connection = new SqlConnection("ConnectionString"))
{
    using (var transaction = connection.BeginTransaction(_capBus, autoCommit: false))
    {
        //your business code
        connection.Execute("insert into test(name) values('test')", 
            transaction: (IDbTransaction)transaction.DbTransaction);

        _capBus.Publish("sample.rabbitmq.mysql", DateTime.Now);

        transaction.Commit();
    }
}

EntityFramework

private readonly ICapPublisher _capBus;

using (var trans = dbContext.Database.BeginTransaction(_capBus, autoCommit: false))
{
    dbContext.Persons.Add(new Person() { Name = "ef.transaction" });

    _capBus.Publish("sample.rabbitmq.mysql", DateTime.Now);

    dbContext.SaveChanges();
    trans.Commit();
}