/* Copyright (c) Citrix Systems, Inc. * All rights reserved. * * 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 System.Threading; using System.Windows.Forms; using XenAdmin.Controls; using XenAPI; namespace XenAdmin.Wizards.GenericPages { public interface IEnableableXenObjectComboBoxItem : IEnableableComboBoxItem { IXenObject Item { get; } } public class DelayLoadingOptionComboBoxItem : IEnableableXenObjectComboBoxItem { /// /// Event raised when the reason is updated /// public event Action ReasonUpdated; public Object ParentComboBox; private string failureReason; private IXenObject xenObject; private const int DEFAULT_RETRIES = 10; private const int DEFAULT_TIMEOUT = 200; private readonly List _filters; /// /// Creates a new class instance and starts a thread to load data /// public DelayLoadingOptionComboBoxItem(IXenObject xenObject, List filters) { this.xenObject = xenObject; _filters = filters; } public void CopyFrom(DelayLoadingOptionComboBoxItem toCopy) { xenObject = toCopy.xenObject; failureReason = toCopy.FailureReason; Enabled = toCopy.Enabled; PreferAsSelectedItem = toCopy.PreferAsSelectedItem; } /// /// Underlying Xen Object /// public IXenObject Item { get { return xenObject; } } /// /// You would prefer this item to be the one that is selected /// As the items are threaded they may exist and be disabled but required /// as a selected item if they load successfully. /// /// Use this in the event handler for the ReasonUpdated flag to find out /// which item should be the selected one and thus which to /// set in the combo box /// public bool PreferAsSelectedItem { get; set; } /// /// Create a thread and fetch the reason /// public void LoadAsync() { //Set default reason without going through setter so as not to trigger the event failureReason = Messages.DELAY_LOADING_COMBO_BOX_WAITING; ThreadPool.QueueUserWorkItem(delegate { FetchFailureReasonWithRetry(DEFAULT_RETRIES, DEFAULT_TIMEOUT); }); } /// /// Fetch the reason on the current thread /// public void LoadSync() { FetchFailureReasonWithRetry(DEFAULT_RETRIES, DEFAULT_TIMEOUT); } public void CancelFilters() { foreach (ReasoningFilter filter in _filters) filter.Cancel(); } /// /// Triggers event when setting the reason /// private void FetchFailureReasonWithRetry(int retries, int timeOut) { do { try { FailureReason = FetchFailureReason(); return; } catch { if (retries > 0) Thread.Sleep(timeOut); } } while (retries-- > 0); FailureReason = Messages.DELAY_LOADED_COMBO_BOX_ITEM_FAILURE_UNKOWN; } /// /// Trigger event /// private void OnReasonChanged() { if (ReasonUpdated != null) ReasonUpdated(this); } public bool Enabled { get; private set; } /// /// Setter will trigger reason updated event /// If no failure result is found on setting set the enabled /// private string FailureReason { get { return failureReason; } set { if (failureReason == value) return; failureReason = value; Enabled = String.IsNullOrEmpty(failureReason); OnReasonChanged(); } } /// /// This will format the xen object and reason together /// /// public override string ToString() { if (string.IsNullOrEmpty(FailureReason)) return Item.Name(); return String.Format(Messages.DELAY_LOADED_COMBO_BOX_ITEM_FAILURE_REASON, Item.Name(), FailureReason); } /// /// Fetch the reason from somewhere that may take some time /// Called in a separate thread by the constructor /// Returning String.Empty or null will mean no failure has been found /// /// protected virtual string FetchFailureReason() { foreach (ReasoningFilter filter in _filters) { if (filter.FailureFoundFor(Item)) { return filter.Reason; } } return string.Empty; } } }