#region Copyright notice and license
// Protocol Buffers - Google's data interchange format
// Copyright 2008 Google Inc. All rights reserved.
//
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file or at
// https://developers.google.com/open-source/licenses/bsd
#endregion
using System;
using System.Collections;
using System.Collections.Generic;
using System.Linq;
namespace 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 readonly 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);
}
}
}