Make ILinks a true interface for dynamic polymorphism

csharp/Platform.Data/IDynamicLinks.cs

@@ -0,0 +1,94 @@
+using System;
+using System.Collections.Generic;
+using Platform.Delegates;
+
+#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member
+
+namespace Platform.Data
+{
+    /// <summary>
+    /// <para>Represents a dynamic polymorphic interface for manipulating data in the Links format.</para>
+    /// <para>Представляет динамический полиморфный интерфейс для манипуляции с данными в формате Links.</para>
+    /// </summary>
+    /// <remarks>
+    /// <para>This interface enables runtime polymorphism through virtual method dispatch, allowing different implementations to be used interchangeably at runtime.</para>
+    /// <para>Этот интерфейс обеспечивает полиморфизм времени выполнения через виртуальную диспетчеризацию методов, позволяя использовать различные реализации взаимозаменяемо во время выполнения.</para>
+    /// </remarks>
+    public interface IDynamicLinks
+    {
+        /// <summary>
+        /// <para>Counts and returns the total number of links in the storage that meet the specified restriction.</para>
+        /// <para>Подсчитывает и возвращает общее число связей находящихся в хранилище, соответствующих указанному ограничению.</para>
+        /// </summary>
+        /// <param name="restriction"><para>Restriction on the contents of links.</para><para>Ограничение на содержимое связей.</para></param>
+        /// <returns><para>The total number of links in the storage that meet the specified restriction.</para><para>Общее число связей находящихся в хранилище, соответствующих указанному ограничению.</para></returns>
+        object Count(IList<object>? restriction);
+
+        /// <summary>
+        /// <para>Passes through all the links matching the pattern, invoking a handler for each matching link.</para>
+        /// <para>Выполняет проход по всем связям, соответствующим шаблону, вызывая обработчик для каждой подходящей связи.</para>
+        /// </summary>
+        /// <param name="restriction">
+        /// <para>Restriction on the contents of links. Each constraint can have values: null - reference to void, any object - absence of constraint, specific values - concrete link indices.</para>
+        /// <para>Ограничение на содержимое связей. Каждое ограничение может иметь значения: null - ссылка на пустоту, любой объект - отсутствие ограничения, конкретные значения - индексы связей.</para>
+        /// </param>
+        /// <param name="handler"><para>A handler for each matching link.</para><para>Обработчик для каждой подходящей связи.</para></param>
+        /// <returns><para>Continue constant if the pass through the links was not interrupted, and Break constant otherwise.</para><para>Константа Continue, в случае если проход по связям не был прерван и константа Break в обратном случае.</para></returns>
+        object Each(IList<object>? restriction, Delegate? handler);
+
+        /// <summary>
+        /// <para>Creates a link.</para>
+        /// <para>Создаёт связь.</para>
+        /// <param name="substitution">
+        /// <para>The content of a new link. This argument is optional, if null is passed as value that means no content of a link is set.</para>
+        /// <para>Содержимое новой связи. Этот аргумент опционален, если null передан в качестве значения это означает, что никакого содержимого для связи не установлено.</para>
+        /// </param>
+        /// <param name="handler">
+        /// <para>A function to handle each executed change. This function can return continue constant to continue processing each change. Break constant can be used to stop receiving executed changes.</para>
+        /// <para>Функция для обработки каждого выполненного изменения. Эта функция может вернуть константу continue чтобы продолжить обрабатывать каждое изменение. Константа Break может быть использована для остановки получения выполненных изменений.</para>
+        /// </param>
+        /// </summary>
+        /// <returns>
+        /// <para>Continue constant if all executed changes are handled. Break constant if processing of handled changes is stopped.</para>
+        /// <para>Константа Continue если все выполненные изменения обработаны. Константа Break если обработка выполненных изменений остановлена.</para>
+        /// </returns>
+        object Create(IList<object>? substitution, Delegate? handler);
+
+        /// <summary>
+        /// <para>Updates a link with the specified restriction to a link with the specified new content.</para>
+        /// <para>Обновляет связь с указанным ограничением на связь с указанным новым содержимым.</para>
+        /// </summary>
+        /// <param name="restriction">
+        /// <para>Restriction on the contents of links. It is assumed that the link index will be specified and then its content will follow.</para>
+        /// <para>Ограничение на содержимое связей. Предполагается, что будет указан индекс связи и далее за ним будет следовать содержимое связи.</para>
+        /// </param>
+        /// <param name="substitution"><para>New content for the link.</para><para>Новое содержимое для связи.</para></param>
+        /// <param name="handler">
+        /// <para>A function to handle each executed change. This function can return continue constant to continue processing each change. Break constant can be used to stop receiving executed changes.</para>
+        /// <para>Функция для обработки каждого выполненного изменения. Эта функция может вернуть константу continue чтобы продолжить обрабатывать каждое изменение. Константа Break может быть использована для остановки получения выполненных изменений.</para>
+        /// </param>
+        /// <returns>
+        /// <para>Continue constant if all executed changes are handled. Break constant if processing of handled changes is stopped.</para>
+        /// <para>Константа Continue если все выполненные изменения обработаны. Константа Break если обработка выполненных изменений остановлена.</para>
+        /// </returns>
+        object Update(IList<object>? restriction, IList<object>? substitution, Delegate? handler);
+
+        /// <summary>
+        /// <para>Deletes links that match the specified restriction.</para>
+        /// <para>Удаляет связи соответствующие указанному ограничению.</para>
+        /// </summary>
+        /// <param name="restriction">
+        /// <para>Restriction on the content of a link. This argument is optional, if null is passed as value that means no restriction on the content of a link is set.</para>
+        /// <para>Ограничение на содержимое связи. Этот аргумент опционален, если null передан в качестве значения это означает, что никаких ограничений на содержимое связи не установлено.</para>
+        /// </param>
+        /// <param name="handler">
+        /// <para>A function to handle each executed change. This function can return continue constant to continue processing each change. Break constant can be used to stop receiving executed changes.</para>
+        /// <para>Функция для обработки каждого выполненного изменения. Эта функция может вернуть константу continue чтобы продолжить обрабатывать каждое изменение. Константа Break может быть использована для остановки получения выполненных изменений.</para>
+        /// </param>
+        /// <returns>
+        /// <para>Continue constant if all executed changes are handled. Break constant if processing of handled changes is stopped.</para>
+        /// <para>Константа Continue если все выполненные изменения обработаны. Константа Break если обработка выполненных изменений остановлена.</para>
+        /// </returns>
+        object Delete(IList<object>? restriction, Delegate? handler);
+    }
+}

csharp/Platform.Data/ILinks.cs

@@ -16,7 +16,7 @@ namespace Platform.Data
     /// <para>This interface is independent of the size of the content of the link, meaning it is suitable for both doublets, triplets, and link sequences of any size.</para>
     /// <para>Этот интерфейс не зависит от размера содержимого связи, а значит подходит как для дуплетов, триплетов и последовательностей связей любого размера.</para>
     /// </remarks>
-    public interface ILinks<TLinkAddress, TConstants>
+    public interface ILinks<TLinkAddress, TConstants> : IDynamicLinks
         where TLinkAddress : IUnsignedNumber<TLinkAddress>
         where TConstants : LinksConstants<TLinkAddress>
     {