source: branches/ParameterBinding/HeuristicLab.Core/3.3/ParameterizedNamedItem.cs @ 5608

#region License Information
/* HeuristicLab
 * Copyright (C) 2002-2010 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 <http://www.gnu.org/licenses/>.
 */
#endregion

using System.Collections.Generic;
using System.Linq;
using HeuristicLab.Common;
using HeuristicLab.Persistence.Default.CompositeSerializers.Storable;
using System.Linq.Expressions;

namespace HeuristicLab.Core {
  /// <summary>
  /// A base class for items which have a name and contain parameters.
  /// </summary>
  [Item("ParameterizedNamedItem", "A base class for items which have a name and contain parameters.")]
  [StorableClass]
  public abstract class ParameterizedNamedItem : NamedItem, IParameterizedNamedItem {
    [Storable]
    protected List<IItemBinding> parameterBindingList;
    public List<IItemBinding> ParameterBindingList {
      get { return parameterBindingList; }
    }
    [Storable]
    private ParameterCollection parameters;
    protected ParameterCollection Parameters {
      get { return parameters; }
    }
    private ReadOnlyKeyedItemCollection<string, IParameter> readOnlyParameters;
    IKeyedItemCollection<string, IParameter> IParameterizedItem.Parameters {
      get {
        if (readOnlyParameters == null) readOnlyParameters = parameters.AsReadOnly();
        return readOnlyParameters;
      }
    }

    [StorableConstructor]
    protected ParameterizedNamedItem(bool deserializing) : base(deserializing) { }
    protected ParameterizedNamedItem(ParameterizedNamedItem original, Cloner cloner)
      : base(original, cloner) {
      parameters = cloner.Clone(original.parameters);
      readOnlyParameters = null;
    }
    protected ParameterizedNamedItem()
      : base() {
      name = ItemName;
      description = ItemDescription;
      parameterBindingList = new List<IItemBinding>();
      parameters = new ParameterCollection();
      readOnlyParameters = null;
    }
    protected ParameterizedNamedItem(string name)
      : base(name) {
      description = ItemDescription;
      parameterBindingList = new List<IItemBinding>();
      parameters = new ParameterCollection();
      readOnlyParameters = null;
    }
    protected ParameterizedNamedItem(string name, ParameterCollection parameters)
      : base(name) {
      description = ItemDescription;
      parameterBindingList = new List<IItemBinding>();
      this.parameters = parameters;
      readOnlyParameters = null;
    }
    protected ParameterizedNamedItem(string name, string description)
      : base(name, description) {
      parameterBindingList = new List<IItemBinding>();
      parameters = new ParameterCollection();
      readOnlyParameters = null;
    }
    protected ParameterizedNamedItem(string name, string description, ParameterCollection parameters)
      : base(name, description) {
      parameterBindingList = new List<IItemBinding>();
      this.parameters = parameters;
      readOnlyParameters = null;
    }

    public virtual void CollectParameterValues(IDictionary<string, IItem> values) {
      foreach (IValueParameter param in parameters.OfType<IValueParameter>()) {
        if (param.GetsCollected && param.Value != null) values.Add(param.Name, param.Value);
        if (param.Value is IParameterizedItem) {
          Dictionary<string, IItem> children = new Dictionary<string, IItem>();
          ((IParameterizedItem)param.Value).CollectParameterValues(children);
          foreach (string key in children.Keys)
            values.Add(param.Name + "." + key, children[key]);
        }
      }
    }

    protected virtual void AddBinding(string targetPath, string sourcePath) {
      ItemBinding binding = new ItemBinding(this, targetPath, this, sourcePath);
      parameterBindingList.Add(binding);
      binding.Bind();
    }

    protected virtual void AddBinding(string targetPath, string sourcePath, LambdaExpression func) {
      ItemBinding binding = new ItemBinding(this, targetPath, this, sourcePath, func);
      parameterBindingList.Add(binding);
      binding.Bind();
    }

    protected virtual void AddSourceBinding(IDeepCloneable target, string targetPath, string sourcePath) {
      ItemBinding binding = new ItemBinding(target, targetPath, this, sourcePath);
      parameterBindingList.Add(binding);
      binding.Bind();
    }

    protected virtual void AddTargetBinding(string targetPath, IDeepCloneable source, string sourcePath) {
      ItemBinding binding = new ItemBinding(this, targetPath, source, sourcePath);
      parameterBindingList.Add(binding);
      binding.Bind();
    }

    [StorableHook(HookType.AfterDeserialization)]
    private void AfterDeserialization() {
      //BackwardsCompatibility3.3
      #region Remove this code when going to 3.4
      if (parameterBindingList == null)
        parameterBindingList = new List<IItemBinding>();
      #endregion
    }
  }
}