/* * 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: * * 1) Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * 2) 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; using System.Collections.Generic; using System.Net; using System.Runtime.Serialization; using XenAPI; using XenCenterLib; namespace XenAdmin.Core { [Serializable] public class EventFromBlockedException : Exception { public EventFromBlockedException() { } public EventFromBlockedException(string message) : base(message) { } public EventFromBlockedException(string message, Exception exception) : base(message, exception) { } protected EventFromBlockedException(SerializationInfo info, StreamingContext context) : base(info, context) { } } public static class XenObjectDownloader { private static readonly log4net.ILog log = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); private const double EVENT_FROM_TIMEOUT = 30; // 30 seconds /// /// Gets all objects from the server. Used in order to fill the cache. /// This function implements the new event system, available from in API version 1.9. /// In the new event system, (GetAllRecords + GetEvents) sequence will replace (RegisterForEvents + DownloadObjects + GetNextEvents). /// /// The session over which to download the objects. Must not be null. /// The queue that the ObjectChanges will be put into. Must not be null. /// Used by GetEvents(). /// Used by GetEvents(). public static void GetAllObjects(Session session, LockFreeQueue changes, HTTP.FuncBool cancelled, ref string token) { // download objects that are not covered by event.from(), e.g. Roles var roleRecords = Role.get_all_records(session); foreach (KeyValuePair, Role> entry in roleRecords) changes.Enqueue(new ObjectChange(typeof(Role), entry.Key.opaque_ref, entry.Value)); // get all objects with event.from() token = ""; GetEvents(session, changes, cancelled, ref token); } /// /// Blocks until events are sent on the session, or timeout is reached, then processes any received events and adds them /// to eventQueue. This function implements the new event system, available in API version 1.9. /// In the new event system, (GetAllRecords + GetEvents) sequence will replace (RegisterForEvents + DownloadObjects + GetNextEvents). /// /// /// /// /// A token used by event.from(). /// It should be the empty string when event.from is first called, which is the replacement of get_all_records. /// public static void GetEvents(Session session, LockFreeQueue eventQueue, HTTP.FuncBool cancelled, ref string token) { Proxy_Event[] proxyEvents = {}; Event[] events = {}; try { var classes = new [] { "*" }; // classes that we are interested in receiving events from var eventResult = Event.from(session, classes, token, EVENT_FROM_TIMEOUT); if (session.JsonRpcClient != null) { var batch = (EventBatch)eventResult; events = batch.events; token = batch.token; } else { var evts = (Events)eventResult; proxyEvents = evts.events; token = evts.token; } } catch (WebException e) { // Catch timeout, and turn it into an EventFromBlockedException so we can recognise it later (CA-33145) if (e.Status == WebExceptionStatus.Timeout) throw new EventFromBlockedException(); else throw; } if (cancelled()) return; //We want to do the marshalling on this background thread so as not to block the gui thread if (session.JsonRpcClient != null) { foreach (Event evt in events) { var objectChange = ProcessEvent(evt.class_, evt.operation, evt.opaqueRef, evt.snapshot, false); if (objectChange != null) eventQueue.Enqueue(objectChange); } } else { foreach (Proxy_Event proxyEvent in proxyEvents) { var objectChange = ProcessEvent(proxyEvent.class_, proxyEvent.operation, proxyEvent.opaqueRef, proxyEvent.snapshot, true); if (objectChange != null) eventQueue.Enqueue(objectChange); } } } /// /// Returns null if we get an event we're not interested in, or an unparseable event (e.g. for an object type we don't know about). /// private static ObjectChange ProcessEvent(string class_, string operation, string opaqueRef, object snapshot, bool marshall) { switch (class_.ToLowerInvariant()) { case "session": case "event": case "vtpm": case "user": case "secret": // We don't track events on these objects return null; default: Type typ = Marshalling.GetXenAPIType(class_); if (typ == null) { log.DebugFormat("Unknown {0} event for class {1}.", operation, class_); return null; } switch (operation) { case "add": case "mod": var marshalled = marshall ? Marshalling.convertStruct(typ, (Hashtable)snapshot) : snapshot; return new ObjectChange(typ, opaqueRef, marshalled); case "del": return new ObjectChange(typ, opaqueRef, null); default: log.DebugFormat("Unknown event operation {0} for opaque ref {1}", operation, opaqueRef); return null; } } } } }