#region License Information /* HeuristicLab * Copyright (C) 2002-2013 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.Linq; using HeuristicLab.Common; using HeuristicLab.Core; using HeuristicLab.Parameters; using HeuristicLab.Persistence.Default.CompositeSerializers.Storable; namespace HeuristicLab.Operators { [Item("InstrumentedOperator", "A operator that can execute pre- and post actions.")] [StorableClass] public abstract class InstrumentedOperator : SingleSuccessorOperator { private const string BeforeExecutionOperatorsParameterName = "BeforeExecutionOperators"; private const string AfterExecutionOperatorsParameterName = "AfterExecutionOperators"; private IFixedValueParameter BeforeExecutionOperatorsParameter { get { return (IFixedValueParameter)Parameters[BeforeExecutionOperatorsParameterName]; } } private IFixedValueParameter AfterExecutionOperatorsParameter { get { return (IFixedValueParameter)Parameters[AfterExecutionOperatorsParameterName]; } } public OperatorList BeforeExecutionOperators { get { return BeforeExecutionOperatorsParameter.Value; } } public OperatorList AfterExecutionOperators { get { return AfterExecutionOperatorsParameter.Value; } } [StorableConstructor] protected InstrumentedOperator(bool deserializing) : base(deserializing) { } protected InstrumentedOperator(InstrumentedOperator original, Cloner cloner) : base(original, cloner) { } protected InstrumentedOperator() : base() { Parameters.Add(new FixedValueParameter(BeforeExecutionOperatorsParameterName, "Actions that are executed before the execution of the operator", new OperatorList())); Parameters.Add(new FixedValueParameter(AfterExecutionOperatorsParameterName, "Actions that are executed after the execution of the operator", new OperatorList())); BeforeExecutionOperatorsParameter.Hidden = true; AfterExecutionOperatorsParameter.Hidden = true; } [StorableHook(HookType.AfterDeserialization)] private void AfterDeserialization() { // BackwardsCompatibility3.3 #region Backwards compatible code, remove with 3.4 if (!Parameters.ContainsKey(BeforeExecutionOperatorsParameterName)) { Parameters.Add(new FixedValueParameter(BeforeExecutionOperatorsParameterName, "Actions that are executed before the execution of the operator", new OperatorList())); BeforeExecutionOperatorsParameter.Hidden = true; } if (!Parameters.ContainsKey(AfterExecutionOperatorsParameterName)) { Parameters.Add(new FixedValueParameter(AfterExecutionOperatorsParameterName, "Actions that are executed after the execution of the operator", new OperatorList())); AfterExecutionOperatorsParameter.Hidden = true; } #endregion } public sealed override IOperation Apply() { //to speed up the execution call instrumented apply directly if no before operators exists if (!BeforeExecutionOperators.Any()) return InstrumentedApply(); //build before operations var opCol = new OperationCollection(); foreach (var beforeAction in BeforeExecutionOperators) { var beforeActionOperation = ExecutionContext.CreateOperation(beforeAction); opCol.Add(beforeActionOperation); } //build operation for the instrumented apply opCol.Add(CreateInstrumentedOperation(this)); return opCol; } public virtual IOperation InstrumentedApply() { if (!AfterExecutionOperators.Any()) { if (Successor != null) return ExecutionContext.CreateOperation(Successor); return null; } var opCol = new OperationCollection(); foreach (var afterAction in AfterExecutionOperators) { var afterActionOperation = ExecutionContext.CreateOperation(afterAction); opCol.Add(afterActionOperation); } if (Successor != null) opCol.Add(ExecutionContext.CreateOperation(Successor)); return opCol; } } }