Merge pull request #235 from sharwell/CloudDNS

Preliminary support for Cloud DNS

Author: sharwell

src/corelib/Core/Synchronous/DnsServiceExtensions.cs

@@ -0,0 +1,90 @@
+namespace net.openstack.Providers.Rackspace.Objects.Dns
+{
+    using Newtonsoft.Json;
+
+    /// <summary>
+    /// Represents a change made to a DNS record.
+    /// </summary>
+    /// <seealso cref="DnsDomainChange"/>
+    /// <seealso cref="IDnsService.ListDomainChangesAsync"/>
+    /// <seealso href="http://docs.rackspace.com/cdns/api/v1.0/cdns-devguide/content/List_Domain_Changes.html">List Domain Changes (Rackspace Cloud DNS Developer Guide - API v1.0)</seealso>
+    /// <threadsafety static="true" instance="false"/>
+    /// <preliminary/>
+    [JsonObject(MemberSerialization.OptIn)]
+    public class DnsChange
+    {
+#pragma warning disable 649 // Field 'fieldName' is never assigned to, and will always have its default value {value}
+        /// <summary>
+        /// This is the backing field for the <see cref="Field"/> property.
+        /// </summary>
+        [JsonProperty("field")]
+        private string _field;
+
+        /// <summary>
+        /// This is the backing field for the <see cref="OriginalValue"/> property.
+        /// </summary>
+        [JsonProperty("originalValue")]
+        private string _originalValue;
+
+        /// <summary>
+        /// This is the backing field for the <see cref="NewValue"/> property.
+        /// </summary>
+        [JsonProperty("newValue")]
+        private string _newValue;
+#pragma warning restore 649
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DnsChange"/> class during
+        /// JSON deserialization.
+        /// </summary>
+        [JsonConstructor]
+        protected DnsChange()
+        {
+        }
+
+        /// <summary>
+        /// Gets the name of the field which changed.
+        /// </summary>
+        /// <value>
+        /// The name of the field which changed, or <c>null</c> if the JSON response from the
+        /// server did not include this property.
+        /// </value>
+        public string Field
+        {
+            get
+            {
+                return _field;
+            }
+        }
+
+        /// <summary>
+        /// Gets the value of the field before the change was made.
+        /// </summary>
+        /// <value>
+        /// The original value of the field which changed, or <c>null</c> if the JSON response
+        /// from the server did not include this property.
+        /// </value>
+        public string OriginalValue
+        {
+            get
+            {
+                return _originalValue;
+            }
+        }
+
+        /// <summary>
+        /// Gets the value of the field after the change was made.
+        /// </summary>
+        /// <value>
+        /// The new value of the field which changed, or <c>null</c> if the JSON response
+        /// from the server did not include this property.
+        /// </value>
+        public string NewValue
+        {
+            get
+            {
+                return _newValue;
+            }
+        }
+    }
+}

src/corelib/Providers/Rackspace/CloudDnsProvider.cs

@@ -0,0 +1,73 @@
+namespace net.openstack.Providers.Rackspace.Objects.Dns
+{
+    using System;
+    using System.Collections.Generic;
+    using System.Collections.ObjectModel;
+    using System.Linq;
+    using Newtonsoft.Json;
+
+    /// <summary>
+    /// Represents the configuration of a collection of domains being added to the DNS service.
+    /// </summary>
+    /// <remarks>
+    /// <note type="inherit">
+    /// This class can be extended if a server extension requires additional information (beyond
+    /// the <c>domains</c> property which is already supported) be sent in the body of a
+    /// <strong>Create Domain</strong> API call.
+    /// </note>
+    /// </remarks>
+    /// <seealso cref="IDnsService.CreateDomainsAsync"/>
+    /// <threadsafety static="true" instance="false"/>
+    /// <preliminary/>
+    [JsonObject(MemberSerialization.OptIn)]
+    public class DnsConfiguration
+    {
+        /// <summary>
+        /// This is the backing field for the <see cref="DomainConfigurations"/> property.
+        /// </summary>
+        [JsonProperty("domains")]
+        private readonly DnsDomainConfiguration[] _domainConfiguration;
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DnsConfiguration"/> class for the
+        /// specified domains.
+        /// </summary>
+        /// <param name="domainConfigurations">A collection of <see cref="DnsDomainConfiguration"/> objects describing the domains.</param>
+        /// <exception cref="ArgumentNullException">If <paramref name="domainConfigurations"/> is <c>null</c>.</exception>
+        /// <exception cref="ArgumentException">If <paramref name="domainConfigurations"/> contains a <c>null</c> value.</exception>
+        public DnsConfiguration(params DnsDomainConfiguration[] domainConfigurations)
+            : this(domainConfigurations.AsEnumerable())
+        {
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DnsConfiguration"/> class for the
+        /// specified domains.
+        /// </summary>
+        /// <param name="domainConfigurations">A collection of <see cref="DnsDomainConfiguration"/> objects describing the domains.</param>
+        /// <exception cref="ArgumentNullException">If <paramref name="domainConfigurations"/> is <c>null</c>.</exception>
+        /// <exception cref="ArgumentException">If <paramref name="domainConfigurations"/> contains a <c>null</c> value.</exception>
+        public DnsConfiguration(IEnumerable<DnsDomainConfiguration> domainConfigurations)
+        {
+            if (domainConfigurations == null)
+                throw new ArgumentNullException("domainConfigurations");
+
+            _domainConfiguration = domainConfigurations.ToArray();
+
+            if (_domainConfiguration.Contains(null))
+                throw new ArgumentException("domainConfigurations cannot contain any null values.", "domainConfigurations");
+        }
+
+        /// <summary>
+        /// Gets a collection of the <see cref="DnsDomainConfiguration"/> objects describing
+        /// domains in this configuration.
+        /// </summary>
+        public ReadOnlyCollection<DnsDomainConfiguration> DomainConfigurations
+        {
+            get
+            {
+                return new ReadOnlyCollection<DnsDomainConfiguration>(_domainConfiguration);
+            }
+        }
+    }
+}