/// <summary>
/// Initializes a new instance of the <see cref="RedisCacheHandle{TCacheValue}"/> class.
/// </summary>
/// <param name="managerConfiguration">The manager configuration.</param>
/// <param name="configuration">The cache handle configuration.</param>
/// <param name="loggerFactory">The logger factory.</param>
/// <param name="serializer">The serializer.</param>
public RedisCacheHandle(ICacheManagerConfiguration managerConfiguration, CacheHandleConfiguration configuration, ILoggerFactory loggerFactory, ICacheSerializer serializer)
: base(managerConfiguration, configuration)
{
Guard.NotNull(loggerFactory, nameof(loggerFactory));
Guard.NotNull(managerConfiguration, nameof(managerConfiguration));
Guard.NotNull(configuration, nameof(configuration));
Guard.EnsureNotNull(serializer, "A serializer is required for the redis cache handle");
Logger = loggerFactory.CreateLogger(this);
_managerConfiguration = managerConfiguration;
_valueConverter = new RedisValueConverter(serializer);
_redisConfiguration = RedisConfigurations.GetConfiguration(configuration.Key);
_connection = new RedisConnectionManager(_redisConfiguration, loggerFactory);
_isLuaAllowed = _connection.Features.Scripting;
// disable preloading right away if twemproxy mode, as this is not supported.
_canPreloadScripts = _redisConfiguration.TwemproxyEnabled ? false : true;
if (_redisConfiguration.KeyspaceNotificationsEnabled)
{
// notify-keyspace-events needs to be set to "Exe" at least! Otherwise we will not receive any events.
// this must be configured per server and should probably not be done automagically as this needs admin rights!
// Let's try to check at least if those settings are configured (the check also works only if useAdmin is set to true though).
try
{
var configurations = _connection.GetConfiguration("notify-keyspace-events");
foreach (var cfg in configurations)
{
if (!cfg.Value.Contains("E"))
{
Logger.LogWarn("Server {0} is missing configuration value 'E' in notify-keyspace-events to enable keyevents.", cfg.Key);
}
if (!(cfg.Value.Contains("A") ||
(cfg.Value.Contains("x") && cfg.Value.Contains("e"))))
{
Logger.LogWarn("Server {0} is missing configuration value 'A' or 'x' and 'e' in notify-keyspace-events to enable keyevents for expired and evicted keys.", cfg.Key);
}
}
}
catch
{
Logger.LogDebug("Could not read configuration from redis to validate notify-keyspace-events. Most likely useAdmin is not set to true.");
}
SubscribeKeyspaceNotifications();
}
}
/// <summary>
/// Gets the configuration.
/// </summary>
/// <param name="configurationName">The identifier.</param>
/// <returns>The <c>RedisConfiguration</c>.</returns>
/// <exception cref="System.ArgumentNullException">If id is null.</exception>
/// <exception cref="System.InvalidOperationException">
/// If no configuration was added for the id.
/// </exception>
public static RedisConfiguration GetConfiguration(string configurationName)
{
Guard.NotNullOrWhiteSpace(configurationName, nameof(configurationName));
if (!Configurations.ContainsKey(configurationName))
{
#if CORE
throw new InvalidOperationException("No configuration added for configuration name " + configurationName);
#else
// check connection strings if there is one matching the name
var connectionStringHolder = ConfigurationManager.ConnectionStrings[configurationName];
if (connectionStringHolder == null || string.IsNullOrWhiteSpace(connectionStringHolder.ConnectionString))
{
throw new InvalidOperationException("No configuration added for configuration name " + configurationName);
}
// defaulting to database 0, no way to set it via connection strings atm.
var configuration = new RedisConfiguration(configurationName, connectionStringHolder.ConnectionString, 0, false);
AddConfiguration(configuration);
#endif
}
return(Configurations[configurationName]);
}