| | | 1 | | // Licensed to the .NET Foundation under one or more agreements. |
| | | 2 | | // The .NET Foundation licenses this file to you under the MIT license. |
| | | 3 | | |
| | | 4 | | using System.Collections; |
| | | 5 | | using System.Collections.Generic; |
| | | 6 | | using System.Diagnostics; |
| | | 7 | | |
| | | 8 | | namespace System.Text.Json.Serialization |
| | | 9 | | { |
| | | 10 | | /// <summary> |
| | | 11 | | /// A list of configuration items that can be locked for modification |
| | | 12 | | /// </summary> |
| | | 13 | | [DebuggerDisplay("{DebuggerDisplay,nq}")] |
| | | 14 | | [DebuggerTypeProxy(typeof(ConfigurationList<>.ConfigurationListDebugView))] |
| | | 15 | | internal abstract class ConfigurationList<TItem> : IList<TItem> |
| | | 16 | | { |
| | | 17 | | protected readonly List<TItem> _list; |
| | | 18 | | |
| | 0 | 19 | | public ConfigurationList(IEnumerable<TItem>? source = null) |
| | 0 | 20 | | { |
| | 0 | 21 | | _list = source is null ? new List<TItem>() : new List<TItem>(source); |
| | 0 | 22 | | } |
| | | 23 | | |
| | | 24 | | public abstract bool IsReadOnly { get; } |
| | | 25 | | protected abstract void OnCollectionModifying(); |
| | 0 | 26 | | protected virtual void OnCollectionModified() { } |
| | 0 | 27 | | protected virtual void ValidateAddedValue(TItem item) { } |
| | | 28 | | |
| | | 29 | | public TItem this[int index] |
| | | 30 | | { |
| | | 31 | | get |
| | 0 | 32 | | { |
| | 0 | 33 | | return _list[index]; |
| | 0 | 34 | | } |
| | | 35 | | set |
| | 0 | 36 | | { |
| | 0 | 37 | | ArgumentNullException.ThrowIfNull(value); |
| | | 38 | | |
| | 0 | 39 | | OnCollectionModifying(); |
| | 0 | 40 | | ValidateAddedValue(value); |
| | 0 | 41 | | _list[index] = value; |
| | 0 | 42 | | OnCollectionModified(); |
| | 0 | 43 | | } |
| | | 44 | | } |
| | | 45 | | |
| | 0 | 46 | | public int Count => _list.Count; |
| | | 47 | | |
| | | 48 | | public void Add(TItem item) |
| | 0 | 49 | | { |
| | 0 | 50 | | ArgumentNullException.ThrowIfNull(item); |
| | | 51 | | |
| | 0 | 52 | | OnCollectionModifying(); |
| | 0 | 53 | | ValidateAddedValue(item); |
| | 0 | 54 | | _list.Add(item); |
| | 0 | 55 | | OnCollectionModified(); |
| | 0 | 56 | | } |
| | | 57 | | |
| | | 58 | | public void Clear() |
| | 0 | 59 | | { |
| | 0 | 60 | | OnCollectionModifying(); |
| | 0 | 61 | | _list.Clear(); |
| | 0 | 62 | | OnCollectionModified(); |
| | 0 | 63 | | } |
| | | 64 | | |
| | 0 | 65 | | public bool Contains(TItem item) => _list.Contains(item); |
| | | 66 | | |
| | | 67 | | public void CopyTo(TItem[] array, int arrayIndex) |
| | 0 | 68 | | { |
| | 0 | 69 | | _list.CopyTo(array, arrayIndex); |
| | 0 | 70 | | } |
| | | 71 | | |
| | 0 | 72 | | public List<TItem>.Enumerator GetEnumerator() => _list.GetEnumerator(); |
| | | 73 | | |
| | 0 | 74 | | public int IndexOf(TItem item) => _list.IndexOf(item); |
| | | 75 | | |
| | | 76 | | public void Insert(int index, TItem item) |
| | 0 | 77 | | { |
| | 0 | 78 | | ArgumentNullException.ThrowIfNull(item); |
| | | 79 | | |
| | 0 | 80 | | OnCollectionModifying(); |
| | 0 | 81 | | ValidateAddedValue(item); |
| | 0 | 82 | | _list.Insert(index, item); |
| | 0 | 83 | | OnCollectionModified(); |
| | 0 | 84 | | } |
| | | 85 | | |
| | | 86 | | public bool Remove(TItem item) |
| | 0 | 87 | | { |
| | 0 | 88 | | OnCollectionModifying(); |
| | 0 | 89 | | bool removed = _list.Remove(item); |
| | 0 | 90 | | if (removed) |
| | 0 | 91 | | { |
| | 0 | 92 | | OnCollectionModified(); |
| | 0 | 93 | | } |
| | | 94 | | |
| | 0 | 95 | | return removed; |
| | 0 | 96 | | } |
| | | 97 | | |
| | | 98 | | public void RemoveAt(int index) |
| | 0 | 99 | | { |
| | 0 | 100 | | OnCollectionModifying(); |
| | 0 | 101 | | _list.RemoveAt(index); |
| | 0 | 102 | | OnCollectionModified(); |
| | 0 | 103 | | } |
| | | 104 | | |
| | | 105 | | IEnumerator<TItem> IEnumerable<TItem>.GetEnumerator() |
| | 0 | 106 | | { |
| | 0 | 107 | | return _list.GetEnumerator(); |
| | 0 | 108 | | } |
| | | 109 | | |
| | | 110 | | IEnumerator IEnumerable.GetEnumerator() |
| | 0 | 111 | | { |
| | 0 | 112 | | return _list.GetEnumerator(); |
| | 0 | 113 | | } |
| | | 114 | | |
| | | 115 | | [DebuggerBrowsable(DebuggerBrowsableState.Never)] |
| | 0 | 116 | | private string DebuggerDisplay => $"Count = {Count}, IsReadOnly = {IsReadOnly}"; |
| | | 117 | | |
| | 0 | 118 | | private sealed class ConfigurationListDebugView(ConfigurationList<TItem> collection) |
| | | 119 | | { |
| | | 120 | | [DebuggerBrowsable(DebuggerBrowsableState.RootHidden)] |
| | 0 | 121 | | public TItem[] Items => collection._list.ToArray(); |
| | | 122 | | } |
| | | 123 | | } |
| | | 124 | | } |
| | | 125 | | |