/* * 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: * * 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.ComponentModel; using System.Globalization; using System.Linq; using Newtonsoft.Json; namespace XenAPI { /// /// A placeholder for a binary blob /// First published in XenServer 5.0. /// public partial class Blob : XenObject { #region Constructors public Blob() { } public Blob(string uuid, string name_label, string name_description, long size, bool pubblic, DateTime last_updated, string mime_type) { this.uuid = uuid; this.name_label = name_label; this.name_description = name_description; this.size = size; this.pubblic = pubblic; this.last_updated = last_updated; this.mime_type = mime_type; } /// /// Creates a new Blob from a Hashtable. /// Note that the fields not contained in the Hashtable /// will be created with their default values. /// /// public Blob(Hashtable table) : this() { UpdateFrom(table); } #endregion /// /// Updates each field of this instance with the value of /// the corresponding field of a given Blob. /// public override void UpdateFrom(Blob record) { uuid = record.uuid; name_label = record.name_label; name_description = record.name_description; size = record.size; pubblic = record.pubblic; last_updated = record.last_updated; mime_type = record.mime_type; } /// /// Given a Hashtable with field-value pairs, it updates the fields of this Blob /// with the values listed in the Hashtable. Note that only the fields contained /// in the Hashtable will be updated and the rest will remain the same. /// /// public void UpdateFrom(Hashtable table) { if (table.ContainsKey("uuid")) uuid = Marshalling.ParseString(table, "uuid"); if (table.ContainsKey("name_label")) name_label = Marshalling.ParseString(table, "name_label"); if (table.ContainsKey("name_description")) name_description = Marshalling.ParseString(table, "name_description"); if (table.ContainsKey("size")) size = Marshalling.ParseLong(table, "size"); if (table.ContainsKey("pubblic")) pubblic = Marshalling.ParseBool(table, "pubblic"); if (table.ContainsKey("last_updated")) last_updated = Marshalling.ParseDateTime(table, "last_updated"); if (table.ContainsKey("mime_type")) mime_type = Marshalling.ParseString(table, "mime_type"); } public bool DeepEquals(Blob other) { if (ReferenceEquals(null, other)) return false; if (ReferenceEquals(this, other)) return true; return Helper.AreEqual2(_uuid, other._uuid) && Helper.AreEqual2(_name_label, other._name_label) && Helper.AreEqual2(_name_description, other._name_description) && Helper.AreEqual2(_size, other._size) && Helper.AreEqual2(_pubblic, other._pubblic) && Helper.AreEqual2(_last_updated, other._last_updated) && Helper.AreEqual2(_mime_type, other._mime_type); } public override string SaveChanges(Session session, string opaqueRef, Blob server) { if (opaqueRef == null) { System.Diagnostics.Debug.Assert(false, "Cannot create instances of this type on the server"); return ""; } else { if (!Helper.AreEqual2(_name_label, server._name_label)) { Blob.set_name_label(session, opaqueRef, _name_label); } if (!Helper.AreEqual2(_name_description, server._name_description)) { Blob.set_name_description(session, opaqueRef, _name_description); } return null; } } /// /// Get a record containing the current state of the given blob. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given blob public static Blob get_record(Session session, string _blob) { return session.JsonRpcClient.blob_get_record(session.opaque_ref, _blob); } /// /// Get a reference to the blob instance with the specified UUID. /// First published in XenServer 5.0. /// /// The session /// UUID of object to return public static XenRef get_by_uuid(Session session, string _uuid) { return session.JsonRpcClient.blob_get_by_uuid(session.opaque_ref, _uuid); } /// /// Get all the blob instances with the given label. /// First published in XenServer 5.0. /// /// The session /// label of object to return public static List> get_by_name_label(Session session, string _label) { return session.JsonRpcClient.blob_get_by_name_label(session.opaque_ref, _label); } /// /// Get the uuid field of the given blob. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given blob public static string get_uuid(Session session, string _blob) { return session.JsonRpcClient.blob_get_uuid(session.opaque_ref, _blob); } /// /// Get the name/label field of the given blob. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given blob public static string get_name_label(Session session, string _blob) { return session.JsonRpcClient.blob_get_name_label(session.opaque_ref, _blob); } /// /// Get the name/description field of the given blob. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given blob public static string get_name_description(Session session, string _blob) { return session.JsonRpcClient.blob_get_name_description(session.opaque_ref, _blob); } /// /// Get the size field of the given blob. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given blob public static long get_size(Session session, string _blob) { return session.JsonRpcClient.blob_get_size(session.opaque_ref, _blob); } /// /// Get the public field of the given blob. /// First published in XenServer 6.1. /// /// The session /// The opaque_ref of the given blob public static bool get_public(Session session, string _blob) { return session.JsonRpcClient.blob_get_public(session.opaque_ref, _blob); } /// /// Get the last_updated field of the given blob. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given blob public static DateTime get_last_updated(Session session, string _blob) { return session.JsonRpcClient.blob_get_last_updated(session.opaque_ref, _blob); } /// /// Get the mime_type field of the given blob. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given blob public static string get_mime_type(Session session, string _blob) { return session.JsonRpcClient.blob_get_mime_type(session.opaque_ref, _blob); } /// /// Set the name/label field of the given blob. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given blob /// New value to set public static void set_name_label(Session session, string _blob, string _label) { session.JsonRpcClient.blob_set_name_label(session.opaque_ref, _blob, _label); } /// /// Set the name/description field of the given blob. /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given blob /// New value to set public static void set_name_description(Session session, string _blob, string _description) { session.JsonRpcClient.blob_set_name_description(session.opaque_ref, _blob, _description); } /// /// Set the public field of the given blob. /// First published in XenServer 6.1. /// /// The session /// The opaque_ref of the given blob /// New value to set public static void set_public(Session session, string _blob, bool _public) { session.JsonRpcClient.blob_set_public(session.opaque_ref, _blob, _public); } /// /// Create a placeholder for a binary blob /// First published in XenServer 5.0. /// /// The session /// The mime-type of the blob. Defaults to 'application/octet-stream' if the empty string is supplied public static XenRef create(Session session, string _mime_type) { return session.JsonRpcClient.blob_create(session.opaque_ref, _mime_type); } /// /// Create a placeholder for a binary blob /// First published in XenServer 5.0. /// /// The session /// The mime-type of the blob. Defaults to 'application/octet-stream' if the empty string is supplied /// True if the blob should be publicly available First published in XenServer 6.1. public static XenRef create(Session session, string _mime_type, bool _public) { return session.JsonRpcClient.blob_create(session.opaque_ref, _mime_type, _public); } /// /// /// First published in XenServer 5.0. /// /// The session /// The opaque_ref of the given blob public static void destroy(Session session, string _blob) { session.JsonRpcClient.blob_destroy(session.opaque_ref, _blob); } /// /// Return a list of all the blobs known to the system. /// First published in XenServer 5.0. /// /// The session public static List> get_all(Session session) { return session.JsonRpcClient.blob_get_all(session.opaque_ref); } /// /// Get all the blob Records at once, in a single XML RPC call /// First published in XenServer 5.0. /// /// The session public static Dictionary, Blob> get_all_records(Session session) { return session.JsonRpcClient.blob_get_all_records(session.opaque_ref); } /// /// Unique identifier/object reference /// public virtual string uuid { get { return _uuid; } set { if (!Helper.AreEqual(value, _uuid)) { _uuid = value; NotifyPropertyChanged("uuid"); } } } private string _uuid = ""; /// /// a human-readable name /// public virtual string name_label { get { return _name_label; } set { if (!Helper.AreEqual(value, _name_label)) { _name_label = value; NotifyPropertyChanged("name_label"); } } } private string _name_label = ""; /// /// a notes field containing human-readable description /// public virtual string name_description { get { return _name_description; } set { if (!Helper.AreEqual(value, _name_description)) { _name_description = value; NotifyPropertyChanged("name_description"); } } } private string _name_description = ""; /// /// Size of the binary data, in bytes /// public virtual long size { get { return _size; } set { if (!Helper.AreEqual(value, _size)) { _size = value; NotifyPropertyChanged("size"); } } } private long _size; /// /// True if the blob is publicly accessible /// First published in XenServer 6.1. /// public virtual bool pubblic { get { return _pubblic; } set { if (!Helper.AreEqual(value, _pubblic)) { _pubblic = value; NotifyPropertyChanged("pubblic"); } } } private bool _pubblic = false; /// /// Time at which the data in the blob was last updated /// [JsonConverter(typeof(XenDateTimeConverter))] public virtual DateTime last_updated { get { return _last_updated; } set { if (!Helper.AreEqual(value, _last_updated)) { _last_updated = value; NotifyPropertyChanged("last_updated"); } } } private DateTime _last_updated; /// /// The mime type associated with this object. Defaults to 'application/octet-stream' if the empty string is supplied /// public virtual string mime_type { get { return _mime_type; } set { if (!Helper.AreEqual(value, _mime_type)) { _mime_type = value; NotifyPropertyChanged("mime_type"); } } } private string _mime_type = ""; } }