#region License Information
/* HeuristicLab
* Copyright (C) 2002-2018 Heuristic and Evolutionary Algorithms Laboratory (HEAL)
*
* This file is part of HeuristicLab.
*
* HeuristicLab is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* HeuristicLab is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with HeuristicLab. If not, see .
*/
#endregion
using System;
using System.Threading;
using HeuristicLab.Common;
using HeuristicLab.Core;
using HeuristicLab.Persistence.Default.CompositeSerializers.Storable;
namespace HeuristicLab.Parameters {
///
/// A parameter whose value is retrieved from the scope.
///
[Item("LookupParameter", "A parameter whose value is retrieved from or written to a scope.")]
[StorableClass]
public class LookupParameter : Parameter, IStatefulItem, ILookupParameter where T : class, IItem {
[Storable]
private string actualName;
public string ActualName {
get { return actualName; }
set {
if (value == null) throw new ArgumentNullException();
if (string.IsNullOrWhiteSpace(value)) {
actualName = Name;
OnActualNameChanged();
} else if (!actualName.Equals(value)) {
actualName = value;
OnActualNameChanged();
}
}
}
public string TranslatedName {
get {
string translatedName = Name;
GetValueParameterAndTranslateName(ExecutionContext, ref translatedName);
return translatedName;
}
}
public new T ActualValue {
get { return (T)base.ActualValue; }
set { base.ActualValue = value; }
}
private Lazy> cachedActualValues;
protected IItem CachedActualValue {
get { return cachedActualValues.Value.Value; }
set { cachedActualValues.Value.Value = value; }
}
private Lazy> executionContexts;
public IExecutionContext ExecutionContext {
get { return executionContexts.Value.Value; }
set {
if (value != executionContexts.Value.Value) {
executionContexts.Value.Value = value;
cachedActualValues.Value.Value = null;
}
}
}
[StorableConstructor]
protected LookupParameter(bool deserializing)
: base(deserializing) {
cachedActualValues = new Lazy>(() => { return new ThreadLocal(); }, LazyThreadSafetyMode.ExecutionAndPublication);
executionContexts = new Lazy>(() => { return new ThreadLocal(); }, LazyThreadSafetyMode.ExecutionAndPublication);
}
protected LookupParameter(LookupParameter original, Cloner cloner)
: base(original, cloner) {
actualName = original.actualName;
cachedActualValues = new Lazy>(() => { return new ThreadLocal(); }, LazyThreadSafetyMode.ExecutionAndPublication);
executionContexts = new Lazy>(() => { return new ThreadLocal(); }, LazyThreadSafetyMode.ExecutionAndPublication);
}
public LookupParameter()
: base("Anonymous", typeof(T)) {
this.actualName = Name;
this.Hidden = true;
cachedActualValues = new Lazy>(() => { return new ThreadLocal(); }, LazyThreadSafetyMode.ExecutionAndPublication);
executionContexts = new Lazy>(() => { return new ThreadLocal(); }, LazyThreadSafetyMode.ExecutionAndPublication);
}
public LookupParameter(string name)
: base(name, typeof(T)) {
this.actualName = Name;
this.Hidden = true;
cachedActualValues = new Lazy>(() => { return new ThreadLocal(); }, LazyThreadSafetyMode.ExecutionAndPublication);
executionContexts = new Lazy>(() => { return new ThreadLocal(); }, LazyThreadSafetyMode.ExecutionAndPublication);
}
public LookupParameter(string name, string description)
: base(name, description, typeof(T)) {
this.actualName = Name;
this.Hidden = true;
cachedActualValues = new Lazy>(() => { return new ThreadLocal(); }, LazyThreadSafetyMode.ExecutionAndPublication);
executionContexts = new Lazy>(() => { return new ThreadLocal(); }, LazyThreadSafetyMode.ExecutionAndPublication);
}
public LookupParameter(string name, string description, string actualName)
: base(name, description, typeof(T)) {
this.actualName = string.IsNullOrWhiteSpace(actualName) ? Name : actualName;
this.Hidden = true;
cachedActualValues = new Lazy>(() => { return new ThreadLocal(); }, LazyThreadSafetyMode.ExecutionAndPublication);
executionContexts = new Lazy>(() => { return new ThreadLocal(); }, LazyThreadSafetyMode.ExecutionAndPublication);
}
public override IDeepCloneable Clone(Cloner cloner) {
return new LookupParameter(this, cloner);
}
public override string ToString() {
if (Name.Equals(ActualName))
return Name;
else
return Name + ": " + ActualName;
}
protected static IValueParameter GetValueParameterAndTranslateName(IExecutionContext executionContext, ref string translatedName) {
IValueParameter valueParam;
ILookupParameter lookupParam;
IExecutionContext currentExecutionContext = executionContext;
while (currentExecutionContext != null) {
IParameter param = null;
while (currentExecutionContext != null && !currentExecutionContext.Parameters.TryGetValue(translatedName, out param))
currentExecutionContext = currentExecutionContext.Parent;
if (currentExecutionContext == null) break;
valueParam = param as IValueParameter;
lookupParam = param as ILookupParameter;
if ((valueParam == null) && (lookupParam == null))
throw new InvalidOperationException(
string.Format("Parameter look-up chain broken. Parameter \"{0}\" is not an \"{1}\" or an \"{2}\".",
translatedName, typeof(IValueParameter).GetPrettyName(), typeof(ILookupParameter).GetPrettyName())
);
if (valueParam != null) {
if (valueParam.Value != null) return valueParam;
else if (lookupParam == null) return valueParam;
}
translatedName = lookupParam.ActualName;
currentExecutionContext = currentExecutionContext.Parent;
}
return null;
}
protected static IVariable LookupVariable(IScope scope, string name) {
IVariable variable = null;
while (scope != null && !scope.Variables.TryGetValue(name, out variable))
scope = scope.Parent;
return scope != null ? variable : null;
}
protected override IItem GetActualValue() {
if (CachedActualValue != null) return CachedActualValue;
string translatedName = Name;
var value = GetValue(ExecutionContext, ref translatedName);
if (value != null && !(value is T))
throw new InvalidOperationException(
string.Format("Type mismatch. Variable \"{0}\" does not contain a \"{1}\".",
translatedName,
typeof(T).GetPrettyName())
);
CachedActualValue = value;
return value;
}
protected static IItem GetValue(IExecutionContext executionContext, ref string name) {
// try to get value from context stack
IValueParameter param = GetValueParameterAndTranslateName(executionContext, ref name);
if (param != null) return param.Value;
// try to get variable from scope
IVariable var = LookupVariable(executionContext.Scope, name);
return var != null ? var.Value : null;
}
protected override void SetActualValue(IItem value) {
if (!(value is T))
throw new InvalidOperationException(
string.Format("Type mismatch. Value is not a \"{0}\".",
typeof(T).GetPrettyName())
);
CachedActualValue = value;
string translatedName = Name;
SetValue(ExecutionContext, ref translatedName, value);
}
protected static void SetValue(IExecutionContext executionContext, ref string name, IItem value) {
// try to set value in context stack
IValueParameter param = GetValueParameterAndTranslateName(executionContext, ref name);
if (param != null) {
param.Value = value;
return;
}
// try to set value in scope
IVariable var = LookupVariable(executionContext.Scope, name);
if (var != null) {
var.Value = value;
return;
}
// create new variable
executionContext.Scope.Variables.Add(new Variable(name, value));
}
public virtual void InitializeState() {
}
public virtual void ClearState() {
if (cachedActualValues.IsValueCreated) {
cachedActualValues.Value.Dispose();
cachedActualValues = new Lazy>(() => { return new ThreadLocal(); }, LazyThreadSafetyMode.ExecutionAndPublication);
}
if (executionContexts.IsValueCreated) {
executionContexts.Value.Dispose();
executionContexts = new Lazy>(() => { return new ThreadLocal(); }, LazyThreadSafetyMode.ExecutionAndPublication);
}
}
public event EventHandler ActualNameChanged;
protected virtual void OnActualNameChanged() {
EventHandler handler = ActualNameChanged;
if (handler != null) handler(this, EventArgs.Empty);
OnToStringChanged();
}
}
}