/// <inheritdoc/>
public FeatureFlagsState AllFlagsState(User user, params FlagsStateOption[] options)
{
if (IsOffline())
{
Log.Warn("AllFlagsState() was called when client is in offline mode. Returning empty state.");
return(new FeatureFlagsState(false));
}
if (!Initialized())
{
if (_featureStore.Initialized())
{
Log.Warn("AllFlagsState() called before client initialized; using last known values from feature store");
}
else
{
Log.Warn("AllFlagsState() called before client initialized; feature store unavailable, returning empty state");
return(new FeatureFlagsState(false));
}
}
if (user == null || user.Key == null)
{
Log.Warn("AllFlagsState() called with null user or null user key. Returning empty state");
return(new FeatureFlagsState(false));
}
var state = new FeatureFlagsState(true);
var clientSideOnly = FlagsStateOption.HasOption(options, FlagsStateOption.ClientSideOnly);
var withReasons = FlagsStateOption.HasOption(options, FlagsStateOption.WithReasons);
var detailsOnlyIfTracked = FlagsStateOption.HasOption(options, FlagsStateOption.DetailsOnlyForTrackedFlags);
IDictionary <string, FeatureFlag> flags = _featureStore.All(VersionedDataKind.Features);
foreach (KeyValuePair <string, FeatureFlag> pair in flags)
{
var flag = pair.Value;
if (clientSideOnly && !flag.ClientSide)
{
continue;
}
try
{
FeatureFlag.EvalResult result = flag.Evaluate(user, _featureStore, EventFactory.Default);
state.AddFlag(flag, result.Result.Value.InnerValue, result.Result.VariationIndex,
withReasons ? result.Result.Reason : null, detailsOnlyIfTracked);
}
catch (Exception e)
{
Log.ErrorFormat("Exception caught for feature flag \"{0}\" when evaluating all flags: {1}", flag.Key, Util.ExceptionMessage(e));
Log.Debug(e.ToString(), e);
EvaluationReason reason = new EvaluationReason.Error(EvaluationErrorKind.EXCEPTION);
state.AddFlag(flag, null, null, withReasons ? reason : null, detailsOnlyIfTracked);
}
}
return(state);
}
private EvaluationDetail <T> Evaluate <T>(string featureKey, User user, LdValue defaultValue, LdValue.Converter <T> converter,
bool checkType, EventFactory eventFactory)
{
T defaultValueOfType = converter.ToType(defaultValue);
if (!Initialized())
{
if (_featureStore.Initialized())
{
Log.Warn("Flag evaluation before client initialized; using last known values from feature store");
}
else
{
Log.Warn("Flag evaluation before client initialized; feature store unavailable, returning default value");
return(new EvaluationDetail <T>(defaultValueOfType, null,
new EvaluationReason.Error(EvaluationErrorKind.CLIENT_NOT_READY)));
}
}
FeatureFlag featureFlag = null;
try
{
featureFlag = _featureStore.Get(VersionedDataKind.Features, featureKey);
if (featureFlag == null)
{
Log.InfoFormat("Unknown feature flag {0}; returning default value",
featureKey);
_eventProcessor.SendEvent(eventFactory.NewUnknownFeatureRequestEvent(featureKey, user, defaultValue,
EvaluationErrorKind.FLAG_NOT_FOUND));
return(new EvaluationDetail <T>(defaultValueOfType, null,
new EvaluationReason.Error(EvaluationErrorKind.FLAG_NOT_FOUND)));
}
if (user == null || user.Key == null)
{
Log.Warn("Feature flag evaluation called with null user or null user key. Returning default");
_eventProcessor.SendEvent(eventFactory.NewDefaultFeatureRequestEvent(featureFlag, user, defaultValue,
EvaluationErrorKind.USER_NOT_SPECIFIED));
return(new EvaluationDetail <T>(defaultValueOfType, null,
new EvaluationReason.Error(EvaluationErrorKind.USER_NOT_SPECIFIED)));
}
FeatureFlag.EvalResult evalResult = featureFlag.Evaluate(user, _featureStore, eventFactory);
if (!IsOffline())
{
foreach (var prereqEvent in evalResult.PrerequisiteEvents)
{
_eventProcessor.SendEvent(prereqEvent);
}
}
var evalDetail = evalResult.Result;
EvaluationDetail <T> returnDetail;
if (evalDetail.VariationIndex == null)
{
returnDetail = new EvaluationDetail <T>(defaultValueOfType, null, evalDetail.Reason);
evalDetail = new EvaluationDetail <LdValue>(defaultValue, null, evalDetail.Reason);
}
else
{
if (checkType && !defaultValue.IsNull && evalDetail.Value.Type != defaultValue.Type)
{
Log.ErrorFormat("Expected type: {0} but got {1} when evaluating FeatureFlag: {2}. Returning default",
defaultValue.Type,
evalDetail.Value.Type,
featureKey);
_eventProcessor.SendEvent(eventFactory.NewDefaultFeatureRequestEvent(featureFlag, user,
defaultValue, EvaluationErrorKind.WRONG_TYPE));
return(new EvaluationDetail <T>(defaultValueOfType, null,
new EvaluationReason.Error(EvaluationErrorKind.WRONG_TYPE)));
}
returnDetail = new EvaluationDetail <T>(converter.ToType(evalDetail.Value),
evalDetail.VariationIndex, evalDetail.Reason);
}
_eventProcessor.SendEvent(eventFactory.NewFeatureRequestEvent(featureFlag, user,
evalDetail, defaultValue));
return(returnDetail);
}
catch (Exception e)
{
Log.ErrorFormat("Encountered exception in LaunchDarkly client: {0} when evaluating feature key: {1} for user key: {2}",
Util.ExceptionMessage(e),
featureKey,
user.Key);
Log.Debug(e.ToString(), e);
var reason = new EvaluationReason.Error(EvaluationErrorKind.EXCEPTION);
if (featureFlag == null)
{
_eventProcessor.SendEvent(eventFactory.NewUnknownFeatureRequestEvent(featureKey, user,
defaultValue, EvaluationErrorKind.EXCEPTION));
}
else
{
_eventProcessor.SendEvent(eventFactory.NewFeatureRequestEvent(featureFlag, user,
new EvaluationDetail <LdValue>(defaultValue, null, reason), defaultValue));
}
return(new EvaluationDetail <T>(defaultValueOfType, null, reason));
}
}
