Комментарий

• Свойства страницы (3 изменено, 0 добавлено, 0 удалено)

Подробности

Свойства страницы

Название

...	...	@@ -1,1 +1,1 @@
1		-ManagetLinkCollection
	1	+Tools.Collections

Родительский документ

...	...	@@ -1,1 +1,1 @@
1		-Проекты и репозитории.WebHome
	1	+Проекты и репозитории.Библиотеки.WebHome

Содержимое

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