/// <summary>
/// Creates Cosmos container configuration properties suitable for passing to
/// <see cref="ITenantStore.UpdateTenantAsync(string, string?, IEnumerable{KeyValuePair{string, object}}?, IEnumerable{string}?)"/>.
/// </summary>
/// <param name="values">Existing configuration values to which to append these.</param>
/// <param name="definition">The definition of the Cosmos container for which to set the configuration.</param>
/// <param name="configuration">The configuration to set.</param>
/// <returns>
/// Properties pass to
/// <see cref="ITenantStore.UpdateTenantAsync(string, string?, IEnumerable{KeyValuePair{string, object}}?, IEnumerable{string}?)"/>.
/// </returns>
public static IEnumerable <KeyValuePair <string, object> > AddCosmosConfiguration(
this IEnumerable <KeyValuePair <string, object> > values,
CosmosContainerDefinition definition,
CosmosConfiguration configuration)
{
ArgumentNullException.ThrowIfNull(values);
ArgumentNullException.ThrowIfNull(definition);
ArgumentNullException.ThrowIfNull(configuration);
return(values.Append(new KeyValuePair <string, object>(GetConfigurationKey(definition), configuration)));
}
private static string GetConfigurationKey(CosmosContainerDefinition definition)
{
return($"StorageConfiguration__{definition.DatabaseName}__{definition.ContainerName}");
}
/// <summary>
/// Describes how to clear the Cosmos configuration for the specified container from tenant
/// properties in form suitable for passing as the <c>propertiesToRemove</c> argument to
/// <see cref="ITenantStore.UpdateTenantAsync(string, string?, IEnumerable{KeyValuePair{string, object}}?, IEnumerable{string}?)"/>.
/// </summary>
/// <param name="definition">The definition of the Cosmos container for which to remove the configuration.</param>
/// <returns>
/// A single-entry list of properties that can be passed to
/// <see cref="ITenantStore.UpdateTenantAsync(string, string?, IEnumerable{KeyValuePair{string, object}}?, IEnumerable{string}?)"/>
/// to remove the storage configuration.
/// </returns>
public static IEnumerable <string> RemoveCosmosConfiguration(this CosmosContainerDefinition definition)
{
ArgumentNullException.ThrowIfNull(definition);
return(new string[] { GetConfigurationKey(definition) });
}
/// <summary>
/// Get the configuration for the specified Cosmos container definition for a particular tenant.
/// </summary>
/// <param name="tenant">The tenant.</param>
/// <param name="definition">The Cosmos storage container definition.</param>
/// <returns>The configuration for the Cosmos account for this tenant.</returns>
public static CosmosConfiguration GetCosmosConfiguration(this ITenant tenant, CosmosContainerDefinition definition)
{
ArgumentNullException.ThrowIfNull(tenant);
ArgumentNullException.ThrowIfNull(definition);
// First, try the configuration specific to this instance
if (tenant.Properties.TryGet(GetConfigurationKey(definition), out CosmosConfiguration? configuration))
{
return(configuration);
}
throw new ArgumentException($"No Cosmos configuration was found for definition with database name '{definition.DatabaseName}' and container name '{definition.ContainerName}'");
}