RavenDB.DependencyInjection 5.0.1

RavenDB.DependencyInjection

用于在 ASP.NET Core 中使用 RavenDB 的依赖注入包。

此包允许您配置 RavenDB 的 DocumentStore 并在其依赖注入容器中创建一个单例。此外，您还可以配置一个 IAsyncDocumentSession （或其同步等效物）以便在每个作用域内创建。

入门教程

通过 NuGet 安装 RavenDB.DependencyInjection 库。

Install-Package RavenDB.DependencyInjection

用法

将 RavenSettings 部分添加到您的 appsettings.json 中

"RavenSettings": {
    "Urls": [
       "http://live-test.ravendb.net"
    ],
    "DatabaseName": "Demo",
    "CertFilePath": "",
    "CertPassword": ""
},

注意，CertFilePath 和 CertPassword 都是可选的。如果您使用证书连接到数据库，则此路径应该是相对于内容根的相对路径。您的证书存储在代码外吗？请参阅 手动配置。

然后在 Startup.cs 中，告诉 Raven 使用此数据库并将其添加到 DI 容器

public void ConfigureServices(IServiceCollection services)
{
    // 1. Add an IDocumentStore singleton. Make sure that RavenSettings section exist in appsettings.json
    services.AddRavenDbDocStore();

    // 2. Add a scoped IAsyncDocumentSession. For the sync version, use .AddRavenSession().
    services.AddRavenDbAsyncSession(); 
}

现在您可以通过控制器和服务注入 IDocumentStore、IAsyncDocumentSession 或 IDocumentSession。😎

配置 Raven 协议

您需要在 docStore.Initialize() 之前配置 RavenDB 协议或执行其他工作？这很简单

services.AddRavenDbDocStore(options => 
{
    options.BeforeInitializeDocStore = docStore => docStore.Conventions.IdentityPartsSeparator = "-";
}

手动配置

您的 Raven 信息存储在代码之外，例如环境变量或 Azure Key Vault？如果是这样，您可以像这样配置您的文档存储

services.AddRavenDbDocStore(options =>
{
    // Grab the DB name from appsettings.json
    var dbName = options.Settings.DbName;
    
    // But grab the cert and password from the cloud
    var certBytes = Convert.FromBase64String(...); // load the certificate from wherever
    var certPassword = ...; // grab the password from wherever
    options.Certificate = new X509Certificate2(certBytes, certPassword);
});

查看示例项目以查看全部功能。