Изменения документа Tools.Collections

Редактировал(а) Alexandr Fokin 2023/01/11 15:18

<
От версии < 10.5 >
отредактировано Alexandr Fokin
на 2022/10/04 17:03
К версии < 10.4 >
отредактировано Alexandr Fokin
на 2022/02/26 17:23
>
Изменить комментарий: Update document after refactoring.

Комментарий

Подробности

Свойства страницы
Содержимое
... ... @@ -6,16 +6,16 @@
6 6  Для обеспечения оптимистичной блокировки в LinkStorage используется специальный item с полем Stamp, по которому проверяется не был ли изменен элемент во время операции.
7 7  (Подробнее смотри ConcurrentDictionary)
8 8  
9 -----
10 10  
11 11  **1) LinkItemDictionary**
12 12  Интерфейс:
13 13  
14 -|AddLink|(% style="width:859px" %)(((
15 -|TKey key|ключ
16 -|Func<TKey, TData> addFactory|фабрика для нового значения
17 -|Func<ILinkItem<TKey, TData>, TData> updateFactory|фабрика для обновления существующего значения
18 -)))|(% style="width:528px" %)Если по ключу нет записи, то
13 +AddLink
14 +TKey key - ключ
15 +Func<TKey, TData> addFactory - фабрика для нового значения
16 +Func<ILinkItem<TKey, TData>, TData> updateFactory - фабрика для обновления существующего значения
17 +
18 +Если по ключу нет записи, то
19 19   добавить запись
20 20   счетчик записи = 1
21 21   вызвать addFactory(если не null) и заполнить value.Data
... ... @@ -22,19 +22,21 @@
22 22  Иначе если по ключу есть запись, то
23 23   Увеличить счетчик на 1
24 24   вызвать updateFactory(если не null) и обновить value.Data
25 -|RemoveLink|(% style="width:859px" %)(((
26 -|TKey key|ключ
27 -|Func<ILinkItem<TKey, TData>, TData> updateFactory|фабрика для обновления существующего значения
28 -)))|(% style="width:528px" %)Вызвать updateFactory(если не null) и обновить value.Data
25 +
26 +
27 +RemoveLink
28 +TKey key - ключ
29 +Func<ILinkItem<TKey, TData>, TData> updateFactory - фабрика для обновления существующего значения
30 +
31 +вызвать updateFactory(если не null) и обновить value.Data
29 29  Уменьшить счетчик на 1
30 30  Если значение счетчика <= 0
31 31   То удалить запись
32 32  
33 -----
34 34  
35 35  **2) ObjectLinkItemDictionary**
36 36  Данная коллекция оборачивает LinkItemDictionary, добавляя к контракту сущность объекта, ссылающегося на запись.
37 -Все объекты, ссылающиеся на запись хранятся в ImmutableHashSet.
39 +Все объекты, ссылающиеся на запись храняться в ImmutableHashSet.
38 38  
39 39  При AddLink, помимо увеличения счетчика в HashSet записи добавляется ссылающийся объект.
40 40  При RemoveLink, помимо уменьшения счетчика из HashSet удаляется ссылающийся объект.
... ... @@ -43,7 +43,6 @@
43 43  [[Разработка/NET/C#/ConcurrentDictionary>>https://wiki.denhome.ru/bin/view/Разработка/NET/C%23/ConcurrentDictionary/]]
44 44  https://stackoverflow.com/questions/39679779/how-to-achieve-remove-if-functionality-in-net-concurrentdictionary
45 45  
46 -----
47 47  
48 48  **3) SortedDictionarySortKeyItemKey**
49 49  
... ... @@ -50,7 +50,6 @@
50 50  Класс SortedDictionarySortKeyItemKey выступает в роли надстройки над SortedDictionary. Он позволяет одновременно использовать 2 типа ключей - TSortKey, TItemKey. В таком случае индексатор SortedDictionary будет работать по ключу TItemKey, а порядок элементов в SortedDictionary будет идти по TSortKey.
51 51  Также, параметр TSortKeyIsUnique позволяет указать, допусаеются ли одинаковые TSortKey для разных значений TItemKey.
52 52  
53 -----
54 54  
55 55  **4) Tools.Collections.Concurrent.AsyncBuffer**
56 56  
... ... @@ -63,3 +63,5 @@
63 63  Tools.Collections.Concurrent.AsyncBuffer.IConcurrentBuffer<T> - сам буфер
64 64  
65 65  Классы из Tools.Collections.Concurrent.AsyncBuffer.PriorityWrapper добавляют обертку над IConcurrentStore<T> и IConcurrentBuffer<T>, которая позволяет управлять приоритетами потребления элементов из буфера. По факту для каждого значения приоритета храниться свой собственный IConcurrentStore<T> (задаеться через конструктор), и элемент считывается из первого непустого IConcurrentStore<T> в порядке приоритета.
66 +
67 +