/* * 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 { /// /// Repository for updates /// First published in 1.301.0. /// public partial class Repository : XenObject { #region Constructors public Repository() { } public Repository(string uuid, string name_label, string name_description, string binary_url, string source_url, bool update, string hash, bool up_to_date, string gpgkey_path) { this.uuid = uuid; this.name_label = name_label; this.name_description = name_description; this.binary_url = binary_url; this.source_url = source_url; this.update = update; this.hash = hash; this.up_to_date = up_to_date; this.gpgkey_path = gpgkey_path; } /// /// Creates a new Repository from a Hashtable. /// Note that the fields not contained in the Hashtable /// will be created with their default values. /// /// public Repository(Hashtable table) : this() { UpdateFrom(table); } #endregion /// /// Updates each field of this instance with the value of /// the corresponding field of a given Repository. /// public override void UpdateFrom(Repository record) { uuid = record.uuid; name_label = record.name_label; name_description = record.name_description; binary_url = record.binary_url; source_url = record.source_url; update = record.update; hash = record.hash; up_to_date = record.up_to_date; gpgkey_path = record.gpgkey_path; } /// /// Given a Hashtable with field-value pairs, it updates the fields of this Repository /// 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("binary_url")) binary_url = Marshalling.ParseString(table, "binary_url"); if (table.ContainsKey("source_url")) source_url = Marshalling.ParseString(table, "source_url"); if (table.ContainsKey("update")) update = Marshalling.ParseBool(table, "update"); if (table.ContainsKey("hash")) hash = Marshalling.ParseString(table, "hash"); if (table.ContainsKey("up_to_date")) up_to_date = Marshalling.ParseBool(table, "up_to_date"); if (table.ContainsKey("gpgkey_path")) gpgkey_path = Marshalling.ParseString(table, "gpgkey_path"); } public bool DeepEquals(Repository other) { if (ReferenceEquals(null, other)) return false; if (ReferenceEquals(this, other)) return true; return Helper.AreEqual2(this._uuid, other._uuid) && Helper.AreEqual2(this._name_label, other._name_label) && Helper.AreEqual2(this._name_description, other._name_description) && Helper.AreEqual2(this._binary_url, other._binary_url) && Helper.AreEqual2(this._source_url, other._source_url) && Helper.AreEqual2(this._update, other._update) && Helper.AreEqual2(this._hash, other._hash) && Helper.AreEqual2(this._up_to_date, other._up_to_date) && Helper.AreEqual2(this._gpgkey_path, other._gpgkey_path); } public override string SaveChanges(Session session, string opaqueRef, Repository 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)) { Repository.set_name_label(session, opaqueRef, _name_label); } if (!Helper.AreEqual2(_name_description, server._name_description)) { Repository.set_name_description(session, opaqueRef, _name_description); } if (!Helper.AreEqual2(_gpgkey_path, server._gpgkey_path)) { Repository.set_gpgkey_path(session, opaqueRef, _gpgkey_path); } return null; } } /// /// Get a record containing the current state of the given Repository. /// First published in 1.301.0. /// /// The session /// The opaque_ref of the given repository public static Repository get_record(Session session, string _repository) { return session.JsonRpcClient.repository_get_record(session.opaque_ref, _repository); } /// /// Get a reference to the Repository instance with the specified UUID. /// First published in 1.301.0. /// /// The session /// UUID of object to return public static XenRef get_by_uuid(Session session, string _uuid) { return session.JsonRpcClient.repository_get_by_uuid(session.opaque_ref, _uuid); } /// /// Get all the Repository instances with the given label. /// First published in 1.301.0. /// /// The session /// label of object to return public static List> get_by_name_label(Session session, string _label) { return session.JsonRpcClient.repository_get_by_name_label(session.opaque_ref, _label); } /// /// Get the uuid field of the given Repository. /// First published in 1.301.0. /// /// The session /// The opaque_ref of the given repository public static string get_uuid(Session session, string _repository) { return session.JsonRpcClient.repository_get_uuid(session.opaque_ref, _repository); } /// /// Get the name/label field of the given Repository. /// First published in 1.301.0. /// /// The session /// The opaque_ref of the given repository public static string get_name_label(Session session, string _repository) { return session.JsonRpcClient.repository_get_name_label(session.opaque_ref, _repository); } /// /// Get the name/description field of the given Repository. /// First published in 1.301.0. /// /// The session /// The opaque_ref of the given repository public static string get_name_description(Session session, string _repository) { return session.JsonRpcClient.repository_get_name_description(session.opaque_ref, _repository); } /// /// Get the binary_url field of the given Repository. /// First published in 1.301.0. /// /// The session /// The opaque_ref of the given repository public static string get_binary_url(Session session, string _repository) { return session.JsonRpcClient.repository_get_binary_url(session.opaque_ref, _repository); } /// /// Get the source_url field of the given Repository. /// First published in 1.301.0. /// /// The session /// The opaque_ref of the given repository public static string get_source_url(Session session, string _repository) { return session.JsonRpcClient.repository_get_source_url(session.opaque_ref, _repository); } /// /// Get the update field of the given Repository. /// First published in 1.301.0. /// /// The session /// The opaque_ref of the given repository public static bool get_update(Session session, string _repository) { return session.JsonRpcClient.repository_get_update(session.opaque_ref, _repository); } /// /// Get the hash field of the given Repository. /// First published in 1.301.0. /// /// The session /// The opaque_ref of the given repository public static string get_hash(Session session, string _repository) { return session.JsonRpcClient.repository_get_hash(session.opaque_ref, _repository); } /// /// Get the up_to_date field of the given Repository. /// First published in 1.301.0. /// Deprecated since 23.12.0-next. /// /// The session /// The opaque_ref of the given repository [Deprecated("23.12.0-next")] public static bool get_up_to_date(Session session, string _repository) { return session.JsonRpcClient.repository_get_up_to_date(session.opaque_ref, _repository); } /// /// Get the gpgkey_path field of the given Repository. /// Experimental. First published in 22.12.0. /// /// The session /// The opaque_ref of the given repository public static string get_gpgkey_path(Session session, string _repository) { return session.JsonRpcClient.repository_get_gpgkey_path(session.opaque_ref, _repository); } /// /// Set the name/label field of the given Repository. /// First published in 1.301.0. /// /// The session /// The opaque_ref of the given repository /// New value to set public static void set_name_label(Session session, string _repository, string _label) { session.JsonRpcClient.repository_set_name_label(session.opaque_ref, _repository, _label); } /// /// Set the name/description field of the given Repository. /// First published in 1.301.0. /// /// The session /// The opaque_ref of the given repository /// New value to set public static void set_name_description(Session session, string _repository, string _description) { session.JsonRpcClient.repository_set_name_description(session.opaque_ref, _repository, _description); } /// /// Add the configuration for a new repository /// First published in 1.301.0. /// /// The session /// The name of the repository /// The description of the repository /// Base URL of binary packages in this repository /// Base URL of source packages in this repository /// True if the repository is an update repository. This means that updateinfo.xml will be parsed /// The GPG public key file name public static XenRef introduce(Session session, string _name_label, string _name_description, string _binary_url, string _source_url, bool _update, string _gpgkey_path) { return session.JsonRpcClient.repository_introduce(session.opaque_ref, _name_label, _name_description, _binary_url, _source_url, _update, _gpgkey_path); } /// /// Add the configuration for a new repository /// First published in 1.301.0. /// /// The session /// The name of the repository /// The description of the repository /// Base URL of binary packages in this repository /// Base URL of source packages in this repository /// True if the repository is an update repository. This means that updateinfo.xml will be parsed /// The GPG public key file name public static XenRef async_introduce(Session session, string _name_label, string _name_description, string _binary_url, string _source_url, bool _update, string _gpgkey_path) { return session.JsonRpcClient.async_repository_introduce(session.opaque_ref, _name_label, _name_description, _binary_url, _source_url, _update, _gpgkey_path); } /// /// Remove the repository record from the database /// First published in 1.301.0. /// /// The session /// The opaque_ref of the given repository public static void forget(Session session, string _repository) { session.JsonRpcClient.repository_forget(session.opaque_ref, _repository); } /// /// Remove the repository record from the database /// First published in 1.301.0. /// /// The session /// The opaque_ref of the given repository public static XenRef async_forget(Session session, string _repository) { return session.JsonRpcClient.async_repository_forget(session.opaque_ref, _repository); } /// /// Set the file name of the GPG public key of the repository /// Experimental. First published in 22.12.0. /// /// The session /// The opaque_ref of the given repository /// The file name of the GPG public key of the repository public static void set_gpgkey_path(Session session, string _repository, string _value) { session.JsonRpcClient.repository_set_gpgkey_path(session.opaque_ref, _repository, _value); } /// /// Set the file name of the GPG public key of the repository /// Experimental. First published in 22.12.0. /// /// The session /// The opaque_ref of the given repository /// The file name of the GPG public key of the repository public static XenRef async_set_gpgkey_path(Session session, string _repository, string _value) { return session.JsonRpcClient.async_repository_set_gpgkey_path(session.opaque_ref, _repository, _value); } /// /// Return a list of all the Repositorys known to the system. /// First published in 1.301.0. /// /// The session public static List> get_all(Session session) { return session.JsonRpcClient.repository_get_all(session.opaque_ref); } /// /// Get all the Repository Records at once, in a single XML RPC call /// First published in 1.301.0. /// /// The session public static Dictionary, Repository> get_all_records(Session session) { return session.JsonRpcClient.repository_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 = ""; /// /// Base URL of binary packages in this repository /// public virtual string binary_url { get { return _binary_url; } set { if (!Helper.AreEqual(value, _binary_url)) { _binary_url = value; NotifyPropertyChanged("binary_url"); } } } private string _binary_url = ""; /// /// Base URL of source packages in this repository /// public virtual string source_url { get { return _source_url; } set { if (!Helper.AreEqual(value, _source_url)) { _source_url = value; NotifyPropertyChanged("source_url"); } } } private string _source_url = ""; /// /// True if updateinfo.xml in this repository needs to be parsed /// public virtual bool update { get { return _update; } set { if (!Helper.AreEqual(value, _update)) { _update = value; NotifyPropertyChanged("update"); } } } private bool _update = false; /// /// SHA256 checksum of latest updateinfo.xml.gz in this repository if its 'update' is true /// public virtual string hash { get { return _hash; } set { if (!Helper.AreEqual(value, _hash)) { _hash = value; NotifyPropertyChanged("hash"); } } } private string _hash = ""; /// /// True if all hosts in pool is up to date with this repository /// public virtual bool up_to_date { get { return _up_to_date; } set { if (!Helper.AreEqual(value, _up_to_date)) { _up_to_date = value; NotifyPropertyChanged("up_to_date"); } } } private bool _up_to_date = false; /// /// The file name of the GPG public key of this repository /// Experimental. First published in 22.12.0. /// public virtual string gpgkey_path { get { return _gpgkey_path; } set { if (!Helper.AreEqual(value, _gpgkey_path)) { _gpgkey_path = value; NotifyPropertyChanged("gpgkey_path"); } } } private string _gpgkey_path = ""; } }