/* 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.Threading;
using XenAPI;
namespace XenAdmin.Utils
{
///
/// Get the UTC server time in an async fashion
///
/// - Updated server time is not guaranteed
/// - No retry
/// - Default return time is the time at which the class is constructed
///
public class AsyncServerTime
{
///
/// Event triggered when the server time is obtained
///
public event Action ServerTimeObtained;
private static readonly log4net.ILog log = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
///
/// Server time (UTC) - updated by thread and user is informed via the ServerTimeEventHandler
/// Default = DateTime.UtcNow
///
public DateTime ServerTime { get; private set; }
///
/// Constructs the class but doesn't trigger the fetch of the server time
///
public AsyncServerTime()
{
ServerTime = DateTime.UtcNow;
}
///
/// Get the server time for given host on a background thread
///
/// Connect to the ServerTimeEventHandler for updates otherwise you'll get the current UTC time
/// and it won't be updated
///
///
public void Fetch(Host host)
{
ThreadPool.QueueUserWorkItem(GetServerTime, host);
}
private void TriggerEvent()
{
if (ServerTimeObtained != null)
ServerTimeObtained();
}
private void GetServerTime(object state)
{
Host host = state as Host;
if (host == null || host.Connection == null)
{
log.ErrorFormat("Will not fetch server time: host or connection could not be resolved");
return;
}
try
{
//Note we're using the get_servertime call which returns the UTC time
ServerTime = Host.get_servertime(host.Connection.Session, host.opaque_ref);
TriggerEvent();
}
catch (Exception e)
{
log.ErrorFormat("Failed to fetch server time for host {0}: {1}", host.name_label, e);
}
}
}
}