#region License Information
/* HeuristicLab
* Copyright (C) 2002-2008 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.Collections.Generic;
using System.Text;
using System.Xml;
namespace HeuristicLab.Core {
public abstract class OperatorBase : ConstrainedItemBase, IOperator {
private string myName;
public string Name {
get { return myName; }
set {
if (myName != value) {
myName = value;
OnNameChanged();
}
}
}
public virtual string Description {
get { return "No operator description available."; }
}
protected bool myCanceled;
public bool Canceled {
get { return myCanceled; }
}
private bool myBreakpoint;
public bool Breakpoint {
get { return myBreakpoint; }
set {
if (value != myBreakpoint) {
myBreakpoint = value;
OnBreakpointChanged();
}
}
}
private List mySubOperators;
public virtual IList SubOperators {
get { return mySubOperators.AsReadOnly(); }
}
private Dictionary myVariableInfos;
public virtual ICollection VariableInfos {
get { return myVariableInfos.Values; }
}
private Dictionary myVariables;
public virtual ICollection Variables {
get { return myVariables.Values; }
}
protected OperatorBase() {
myName = this.GetType().Name;
myCanceled = false;
myBreakpoint = false;
mySubOperators = new List();
myVariableInfos = new Dictionary();
myVariables = new Dictionary();
}
public override object Clone(IDictionary clonedObjects) {
OperatorBase clone = (OperatorBase)base.Clone(clonedObjects);
clone.myName = Name;
clone.mySubOperators.Clear();
for (int i = 0; i < SubOperators.Count; i++)
clone.AddSubOperator((IOperator)Auxiliary.Clone(SubOperators[i], clonedObjects));
clone.myVariableInfos.Clear();
foreach (IVariableInfo variableInfo in myVariableInfos.Values)
clone.AddVariableInfo((IVariableInfo)Auxiliary.Clone(variableInfo, clonedObjects));
clone.myVariables.Clear();
foreach (IVariable variable in myVariables.Values)
clone.AddVariable((IVariable)Auxiliary.Clone(variable, clonedObjects));
return clone;
}
public override IView CreateView() {
return new OperatorBaseView(this);
}
#region SubOperator Methods
public virtual void AddSubOperator(IOperator subOperator) {
mySubOperators.Add(subOperator);
OnSubOperatorAdded(subOperator, mySubOperators.Count - 1);
}
public virtual bool TryAddSubOperator(IOperator subOperator) {
mySubOperators.Add(subOperator);
if (IsValid()) {
OnSubOperatorAdded(subOperator, mySubOperators.Count - 1);
return true;
} else {
mySubOperators.RemoveAt(mySubOperators.Count - 1);
return false;
}
}
public virtual bool TryAddSubOperator(IOperator subOperator, out ICollection violatedConstraints) {
mySubOperators.Add(subOperator);
if (IsValid(out violatedConstraints)) {
OnSubOperatorAdded(subOperator, mySubOperators.Count - 1);
return true;
} else {
mySubOperators.RemoveAt(mySubOperators.Count - 1);
return false;
}
}
public virtual void AddSubOperator(IOperator subOperator, int index) {
mySubOperators.Insert(index, subOperator);
OnSubOperatorAdded(subOperator, index);
}
public virtual bool TryAddSubOperator(IOperator subOperator, int index) {
mySubOperators.Insert(index, subOperator);
if (IsValid()) {
OnSubOperatorAdded(subOperator, index);
return true;
} else {
mySubOperators.RemoveAt(index);
return false;
}
}
public virtual bool TryAddSubOperator(IOperator subOperator, int index, out ICollection violatedConstraints) {
mySubOperators.Insert(index, subOperator);
if (IsValid(out violatedConstraints)) {
OnSubOperatorAdded(subOperator, index);
return true;
} else {
mySubOperators.RemoveAt(index);
return false;
}
}
public virtual void RemoveSubOperator(int index) {
IOperator op = mySubOperators[index];
mySubOperators.RemoveAt(index);
OnSubOperatorRemoved(op, index);
}
public virtual bool TryRemoveSubOperator(int index) {
IOperator op = mySubOperators[index];
mySubOperators.RemoveAt(index);
if (IsValid()) {
OnSubOperatorRemoved(op, index);
return true;
} else {
mySubOperators.Insert(index, op);
return false;
}
}
public virtual bool TryRemoveSubOperator(int index, out ICollection violatedConstraints) {
IOperator op = mySubOperators[index];
mySubOperators.RemoveAt(index);
if (IsValid(out violatedConstraints)) {
OnSubOperatorRemoved(op, index);
return true;
} else {
mySubOperators.Insert(index, op);
return false;
}
}
#endregion
#region VariableInfo Methods
public virtual IVariableInfo GetVariableInfo(string formalName) {
IVariableInfo info;
if (myVariableInfos.TryGetValue(formalName, out info))
return info;
else
return null;
}
public virtual void AddVariableInfo(IVariableInfo variableInfo) {
myVariableInfos.Add(variableInfo.FormalName, variableInfo);
OnVariableInfoAdded(variableInfo);
}
public virtual bool TryAddVariableInfo(IVariableInfo variableInfo) {
myVariableInfos.Add(variableInfo.FormalName, variableInfo);
if (IsValid()) {
OnVariableInfoAdded(variableInfo);
return true;
} else {
myVariableInfos.Remove(variableInfo.FormalName);
return false;
}
}
public virtual bool TryAddVariableInfo(IVariableInfo variableInfo, out ICollection violatedConstraints) {
myVariableInfos.Add(variableInfo.FormalName, variableInfo);
if (IsValid(out violatedConstraints)) {
OnVariableInfoAdded(variableInfo);
return true;
} else {
myVariableInfos.Remove(variableInfo.FormalName);
return false;
}
}
public virtual void RemoveVariableInfo(string formalName) {
IVariableInfo variableInfo;
if (myVariableInfos.TryGetValue(formalName, out variableInfo)) {
myVariableInfos.Remove(formalName);
OnVariableInfoRemoved(variableInfo);
}
}
public virtual bool TryRemoveVariableInfo(string formalName) {
IVariableInfo variableInfo;
if (myVariableInfos.TryGetValue(formalName, out variableInfo)) {
myVariableInfos.Remove(formalName);
if (IsValid()) {
OnVariableInfoRemoved(variableInfo);
return true;
} else {
myVariableInfos.Add(formalName, variableInfo);
return false;
}
}
return true;
}
public virtual bool TryRemoveVariableInfo(string formalName, out ICollection violatedConstraints) {
IVariableInfo variableInfo;
if (myVariableInfos.TryGetValue(formalName, out variableInfo)) {
myVariableInfos.Remove(formalName);
if (IsValid(out violatedConstraints)) {
OnVariableInfoRemoved(variableInfo);
return true;
} else {
myVariableInfos.Add(formalName, variableInfo);
return false;
}
}
violatedConstraints = new List();
return true;
}
#endregion
#region Variable Methods
public virtual IVariable GetVariable(string name) {
IVariable variable;
if (myVariables.TryGetValue(name, out variable))
return variable;
else
return null;
}
public virtual void AddVariable(IVariable variable) {
myVariables.Add(variable.Name, variable);
variable.NameChanging += new EventHandler(Variable_NameChanging);
variable.NameChanged += new EventHandler(Variable_NameChanged);
OnVariableAdded(variable);
}
public virtual bool TryAddVariable(IVariable variable) {
myVariables.Add(variable.Name, variable);
if (IsValid()) {
variable.NameChanging += new EventHandler(Variable_NameChanging);
variable.NameChanged += new EventHandler(Variable_NameChanged);
OnVariableAdded(variable);
return true;
} else {
myVariableInfos.Remove(variable.Name);
return false;
}
}
public virtual bool TryAddVariable(IVariable variable, out ICollection violatedConstraints) {
myVariables.Add(variable.Name, variable);
if (IsValid(out violatedConstraints)) {
variable.NameChanging += new EventHandler(Variable_NameChanging);
variable.NameChanged += new EventHandler(Variable_NameChanged);
OnVariableAdded(variable);
return true;
} else {
myVariableInfos.Remove(variable.Name);
return false;
}
}
public virtual void RemoveVariable(string name) {
IVariable variable;
if (myVariables.TryGetValue(name, out variable)) {
variable.NameChanging -= new EventHandler(Variable_NameChanging);
variable.NameChanged -= new EventHandler(Variable_NameChanged);
myVariables.Remove(name);
OnVariableRemoved(variable);
}
}
public virtual bool TryRemoveVariable(string name) {
IVariable variable;
if (myVariables.TryGetValue(name, out variable)) {
myVariables.Remove(name);
if (IsValid()) {
variable.NameChanging -= new EventHandler(Variable_NameChanging);
variable.NameChanged -= new EventHandler(Variable_NameChanged);
OnVariableRemoved(variable);
return true;
} else {
myVariables.Add(name, variable);
return false;
}
}
return true;
}
public virtual bool TryRemoveVariable(string name, out ICollection violatedConstraints) {
IVariable variable;
if (myVariables.TryGetValue(name, out variable)) {
myVariables.Remove(name);
if (IsValid(out violatedConstraints)) {
variable.NameChanging -= new EventHandler(Variable_NameChanging);
variable.NameChanged -= new EventHandler(Variable_NameChanged);
OnVariableRemoved(variable);
return true;
} else {
myVariables.Add(name, variable);
return false;
}
}
violatedConstraints = new List();
return true;
}
private void Variable_NameChanging(object sender, NameChangingEventArgs e) {
e.Cancel = myVariables.ContainsKey(e.Name);
}
private void Variable_NameChanged(object sender, EventArgs e) {
IVariable variable = (IVariable)sender;
string oldName = null;
foreach (KeyValuePair element in myVariables) {
if (element.Value == variable)
oldName = element.Key;
}
myVariables.Remove(oldName);
myVariables.Add(variable.Name, variable);
}
public T GetVariableValue(string formalName, IScope scope, bool recursiveLookup) where T : class, IItem {
return GetVariableValue(formalName, scope, recursiveLookup, true);
}
public T GetVariableValue(string formalName, IScope scope, bool recursiveLookup, bool throwOnError) where T : class, IItem {
return (T)GetVariableValue(formalName, scope, recursiveLookup, throwOnError);
}
public IItem GetVariableValue(string formalName, IScope scope, bool recursiveLookup) {
return GetVariableValue(formalName, scope, recursiveLookup, true);
}
public virtual IItem GetVariableValue(string formalName, IScope scope, bool recursiveLookup, bool throwOnError) {
IVariableInfo info = GetVariableInfo(formalName);
if (info.Local) {
IVariable variable;
if (myVariables.TryGetValue(info.ActualName, out variable))
return variable.Value;
else {
if (throwOnError)
throw new ArgumentException("Variable " + info.ActualName + " not found");
else
return null;
}
} else {
return scope.GetVariableValue(formalName, recursiveLookup, throwOnError);
}
}
#endregion
public virtual IOperation Execute(IScope scope) {
myCanceled = false;
foreach (IVariableInfo variableInfo in VariableInfos)
scope.AddAlias(variableInfo.FormalName, variableInfo.ActualName);
IOperation next = Apply(scope);
foreach (IVariableInfo variableInfo in VariableInfos)
scope.RemoveAlias(variableInfo.FormalName);
OnExecuted();
return next;
}
public virtual void Abort() {
myCanceled = true;
}
public virtual IOperation Apply(IScope scope) {
return null;
}
public event EventHandler NameChanged;
protected virtual void OnNameChanged() {
if (NameChanged != null) {
NameChanged(this, new EventArgs());
}
}
public event EventHandler BreakpointChanged;
protected virtual void OnBreakpointChanged() {
if (BreakpointChanged != null) {
BreakpointChanged(this, new EventArgs());
}
}
public event EventHandler SubOperatorAdded;
protected virtual void OnSubOperatorAdded(IOperator subOperator, int index) {
if (SubOperatorAdded != null)
SubOperatorAdded(this, new OperatorIndexEventArgs(subOperator, index));
}
public event EventHandler SubOperatorRemoved;
protected virtual void OnSubOperatorRemoved(IOperator subOperator, int index) {
if (SubOperatorRemoved != null)
SubOperatorRemoved(this, new OperatorIndexEventArgs(subOperator, index));
}
public event EventHandler VariableInfoAdded;
protected virtual void OnVariableInfoAdded(IVariableInfo variableInfo) {
if (VariableInfoAdded != null)
VariableInfoAdded(this, new VariableInfoEventArgs(variableInfo));
}
public event EventHandler VariableInfoRemoved;
protected virtual void OnVariableInfoRemoved(IVariableInfo variableInfo) {
if (VariableInfoRemoved != null)
VariableInfoRemoved(this, new VariableInfoEventArgs(variableInfo));
}
public event EventHandler VariableAdded;
protected virtual void OnVariableAdded(IVariable variable) {
if (VariableAdded != null)
VariableAdded(this, new VariableEventArgs(variable));
}
public event EventHandler VariableRemoved;
protected virtual void OnVariableRemoved(IVariable variable) {
if (VariableRemoved != null)
VariableRemoved(this, new VariableEventArgs(variable));
}
public event EventHandler Executed;
protected virtual void OnExecuted() {
if (Executed != null) {
Executed(this, new EventArgs());
}
}
#region Persistence Methods
public override XmlNode GetXmlNode(string name, XmlDocument document, IDictionary persistedObjects) {
XmlNode node = base.GetXmlNode(name, document, persistedObjects);
XmlAttribute nameAttribute = document.CreateAttribute("Name");
nameAttribute.Value = Name;
node.Attributes.Append(nameAttribute);
if (Breakpoint) {
XmlAttribute breakpointAttribute = document.CreateAttribute("Breakpoint");
breakpointAttribute.Value = Breakpoint.ToString();
node.Attributes.Append(breakpointAttribute);
}
XmlNode subOperatorsNode = document.CreateNode(XmlNodeType.Element, "SubOperators", null);
for (int i = 0; i < SubOperators.Count; i++)
subOperatorsNode.AppendChild(PersistenceManager.Persist(SubOperators[i], document, persistedObjects));
node.AppendChild(subOperatorsNode);
XmlNode infosNode = document.CreateNode(XmlNodeType.Element, "VariableInfos", null);
foreach (IVariableInfo info in myVariableInfos.Values)
infosNode.AppendChild(PersistenceManager.Persist(info, document, persistedObjects));
node.AppendChild(infosNode);
XmlNode variablesNode = document.CreateNode(XmlNodeType.Element, "Variables", null);
foreach (IVariable variable in myVariables.Values)
variablesNode.AppendChild(PersistenceManager.Persist(variable, document, persistedObjects));
node.AppendChild(variablesNode);
return node;
}
public override void Populate(XmlNode node, IDictionary restoredObjects) {
base.Populate(node, restoredObjects);
myName = node.Attributes["Name"].Value;
if (node.Attributes["Breakpoint"] != null)
myBreakpoint = bool.Parse(node.Attributes["Breakpoint"].Value);
XmlNode subOperatorsNode = node.SelectSingleNode("SubOperators");
for (int i = 0; i < subOperatorsNode.ChildNodes.Count; i++)
AddSubOperator((IOperator)PersistenceManager.Restore(subOperatorsNode.ChildNodes[i], restoredObjects));
XmlNode infosNode = node.SelectSingleNode("VariableInfos");
myVariableInfos.Clear();
foreach (XmlNode infoNode in infosNode.ChildNodes)
AddVariableInfo((IVariableInfo)PersistenceManager.Restore(infoNode, restoredObjects));
XmlNode variablesNode = node.SelectSingleNode("Variables");
myVariables.Clear();
foreach (XmlNode variableNode in variablesNode.ChildNodes)
AddVariable((IVariable)PersistenceManager.Restore(variableNode, restoredObjects));
}
#endregion
}
}