/* Copyright (c) Cloud Software Group, Inc.
*
* Redistribution and use in source and binary forms,
* with or without modification, are permitted provided
* that the following conditions are met:
*
* * Redistributions of source code must retain the above
* copyright notice, this list of conditions and the
* following disclaimer.
* * Redistributions in binary form must reproduce the above
* copyright notice, this list of conditions and the
* following disclaimer in the documentation and/or other
* materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
* CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*/
using System;
using System.Collections.Generic;
using XenAdmin.Core;
using XenAdmin.Network;
using XenAPI;
using System.Linq;
namespace XenAdmin.Actions
{
///
/// Run several actions. The outer action is asynchronous, but the sub-actions are run synchronously within it.
///
public class MultipleAction : AsyncAction, IDisposable
{
private static readonly log4net.ILog _log = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
private readonly List _subActions;
private readonly string _endDescription;
private readonly bool _stopOnFirstException;
public bool ShowSubActionsDetails { get; }
public string SubActionTitle { get; private set; }
public string SubActionDescription { get; private set; }
public MultipleAction(IXenConnection connection, string title, string startDescription,
string endDescription, List subActions, bool suppressHistory = false,
bool showSubActionsDetails = false, bool stopOnFirstException = false)
: base(connection, title, startDescription, suppressHistory)
{
_endDescription = endDescription;
_subActions = subActions;
ShowSubActionsDetails = showSubActionsDetails;
_stopOnFirstException = stopOnFirstException;
Completed += MultipleAction_Completed;
RegisterEvents();
}
///
/// The multiple action gets its ApiMethodsToRoleCheck by accumulating the lists from each of the sub-actions
///
public override RbacMethodList GetApiMethodsToRoleCheck
{
get
{
var list = new RbacMethodList();
foreach (var subAction in _subActions)
list.AddRange(subAction.GetApiMethodsToRoleCheck);
return list;
}
}
protected sealed override void Run()
{
PercentComplete = 0;
var exceptions = new List();
RecomputeCanCancel();
RunSubActions(exceptions);
Tick(100, _endDescription);
if (exceptions.Count > 1)
{
foreach (var e in exceptions)
_log.Error(e);
Exception = new Exception(Messages.SOME_ERRORS_ENCOUNTERED);
}
if (Cancelling)
Exception = new CancelledException();
}
public override void RecomputeCanCancel()
{
CanCancel = !IsCompleted && _subActions.Any(a => !a.IsCompleted);
}
protected override void CancelRelatedTask()
{
foreach (var subAction in _subActions.Where(a => !a.IsCompleted))
{
subAction.Cancel();
}
}
private void RegisterEvents()
{
foreach (var subAction in _subActions)
subAction.Changed += SubActionChanged;
}
private void DeRegisterEvents()
{
foreach (var subAction in _subActions)
subAction.Changed -= SubActionChanged;
}
private void SubActionChanged(ActionBase sender)
{
if (sender is AsyncAction subAction)
{
SubActionTitle = subAction.Title;
SubActionDescription = subAction.Description;
RecalculatePercentComplete();
OnChanged();
}
}
protected virtual void RecalculatePercentComplete()
{
int total = 0;
int n = _subActions.Count;
foreach (var action in _subActions)
total += action.PercentComplete;
PercentComplete = total / n;
}
protected virtual void RunSubActions(List exceptions)
{
foreach (var subAction in _subActions)
{
if (Cancelling) // don't start any more actions
break;
try
{
SubActionTitle = subAction.Title;
subAction.RunSync(Session);
}
catch (Exception e)
{
if (e is Failure f && Connection != null && f.ErrorDescription[0] == Failure.RBAC_PERMISSION_DENIED)
Failure.ParseRBACFailure(f, Connection, Session ?? Connection.Session);
exceptions.Add(e);
// Record the first exception we come to. Though later if there are more than one we will replace this with non specific one.
if (Exception == null)
Exception = e;
if (_stopOnFirstException)
break;
}
}
}
protected virtual void MultipleAction_Completed(ActionBase sender)
{
// The MultipleAction can sometimes complete prematurely, for example
// if the sudo dialog is cancelled, of (less likely) if one of the
// sub-actions throws an exception in its GetApiMethodsToRoleCheck.
// In this case, we need to cancel this action's sub-actions.
foreach (var subAction in _subActions)
{
if (!subAction.IsCompleted)
subAction.Cancel();
}
}
#region IDisposable Members
public void Dispose()
{
DeRegisterEvents();
}
#endregion
}
}