#region Copyright notice and license // Protocol Buffers - Google's data interchange format // Copyright 2008 Google Inc. All rights reserved. // https://developers.google.com/protocol-buffers/ // // 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. // * Neither the name of Google Inc. nor the names of its // contributors may be used to endorse or promote products derived from // this software without specific prior written permission. // // 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 // OWNER 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. #endregion using System; using System.Collections; using System.Collections.Generic; using System.Linq; namespace LC.Google.Protobuf { /// /// Provides extensions to messages while parsing. This API is experimental and subject to change. /// public sealed class ExtensionRegistry : ICollection, IDeepCloneable { internal sealed class ExtensionComparer : IEqualityComparer { public bool Equals(Extension a, Extension b) { return new ObjectIntPair(a.TargetType, a.FieldNumber).Equals(new ObjectIntPair(b.TargetType, b.FieldNumber)); } public int GetHashCode(Extension a) { return new ObjectIntPair(a.TargetType, a.FieldNumber).GetHashCode(); } internal static ExtensionComparer Instance = new ExtensionComparer(); } private IDictionary, Extension> extensions; /// /// Creates a new empty extension registry /// public ExtensionRegistry() { extensions = new Dictionary, Extension>(); } private ExtensionRegistry(IDictionary, Extension> collection) { extensions = collection.ToDictionary(k => k.Key, v => v.Value); } /// /// Gets the total number of extensions in this extension registry /// public int Count => extensions.Count; /// /// Returns whether the registry is readonly /// bool ICollection.IsReadOnly => false; internal bool ContainsInputField(uint lastTag, Type target, out Extension extension) { return extensions.TryGetValue(new ObjectIntPair(target, WireFormat.GetTagFieldNumber(lastTag)), out extension); } /// /// Adds the specified extension to the registry /// public void Add(Extension extension) { ProtoPreconditions.CheckNotNull(extension, nameof(extension)); extensions.Add(new ObjectIntPair(extension.TargetType, extension.FieldNumber), extension); } /// /// Adds the specified extensions to the registry /// public void AddRange(IEnumerable extensions) { ProtoPreconditions.CheckNotNull(extensions, nameof(extensions)); foreach (var extension in extensions) { Add(extension); } } /// /// Clears the registry of all values /// public void Clear() { extensions.Clear(); } /// /// Gets whether the extension registry contains the specified extension /// public bool Contains(Extension item) { ProtoPreconditions.CheckNotNull(item, nameof(item)); return extensions.ContainsKey(new ObjectIntPair(item.TargetType, item.FieldNumber)); } /// /// Copies the arrays in the registry set to the specified array at the specified index /// /// The array to copy to /// The array index to start at void ICollection.CopyTo(Extension[] array, int arrayIndex) { ProtoPreconditions.CheckNotNull(array, nameof(array)); if (arrayIndex < 0 || arrayIndex >= array.Length) { throw new ArgumentOutOfRangeException(nameof(arrayIndex)); } if (array.Length - arrayIndex < Count) { throw new ArgumentException("The provided array is shorter than the number of elements in the registry"); } for (int i = 0; i < array.Length; i++) { Extension extension = array[i]; extensions.Add(new ObjectIntPair(extension.TargetType, extension.FieldNumber), extension); } } /// /// Returns an enumerator to enumerate through the items in the registry /// /// Returns an enumerator for the extensions in this registry public IEnumerator GetEnumerator() { return extensions.Values.GetEnumerator(); } /// /// Removes the specified extension from the set /// /// The extension /// true if the extension was removed, otherwise false public bool Remove(Extension item) { ProtoPreconditions.CheckNotNull(item, nameof(item)); return extensions.Remove(new ObjectIntPair(item.TargetType, item.FieldNumber)); } IEnumerator IEnumerable.GetEnumerator() => GetEnumerator(); /// /// Clones the registry into a new registry /// public ExtensionRegistry Clone() { return new ExtensionRegistry(extensions); } } }