Реализован функционал интерфейсов

Author: Macegor

packagedef

@@ -1,5 +1,5 @@
 Описание.Имя("fint")
-	.Версия("0.1.2")
+	.Версия("0.1.3")
 	.Автор("Андрей Савадеров (Macegor)")
     .АдресАвтора("[email protected]")
     .Описание("Фреймворк реализующий строгую типизацию, принципы ООП и DI")

readme.md

@@ -20,6 +20,10 @@
       - [Наследник: Круг {#наследник-круг}](#наследник-круг-наследник-круг)
       - [Наследник: Прямоугольник {#наследник-прямоугольник}](#наследник-прямоугольник-наследник-прямоугольник)
       - [Полиморфизм в массиве фигур {#полиморфизм-в-массиве-фигур}](#полиморфизм-в-массиве-фигур-полиморфизм-в-массиве-фигур)
+    - [Интерфейсы {#интерфейсы}](#интерфейсы-интерфейсы)
+      - [Базовый интерфейс: ОбработчикЗапроса {#базовый-интерфейс-обработчикзапроса}](#базовый-интерфейс-обработчикзапроса-базовый-интерфейс-обработчикзапроса)
+      - [Реализация интерфейса: СвойОбработчикЗапросов {#реализация-интерфейса-свойобработчикзапросов}](#реализация-интерфейса-свойобработчикзапросов-реализация-интерфейса-свойобработчикзапросов)
+      - [Использование интерфейса {#использование-интерфейса}](#использование-интерфейса-использование-интерфейса)
 
 ## Возможности {#возможности}
 
@@ -429,7 +433,7 @@
 КонецПроцедуры
 ```
 
-В `Круг` импортируется `Фигура`, наследуется через `&Наследует`. Свойство `Радиус` типизировано и защищено. Метод `Площадь()` переопределяет базовый, вычисляя площадь по формуле π\*r², возвращая `&Число`. Конструктор вызывает `Базовый.Конструктор()` для инициализации родительских свойств.
+В `Круг` импортируется `Фигура`, наследуется через `&Наследует`. Свойство `Радиус` типизировано и защищено. Метод `Площадь()` переопределяет базовый, вычисляя площадь по формуле π*r², возвращая `&Число`. Конструктор вызывает `Базовый.Конструктор()` для инициализации родительских свойств.
 
 #### Наследник: Прямоугольник {#наследник-прямоугольник}
 
@@ -459,7 +463,7 @@
 КонецПроцедуры
 ```
 
-Аналогично `Круг`, но с двумя свойствами `Ширина` и `Высота`. `Площадь()` вычисляет ширину \* высоту. Показан комментарий о возможном вызове `Базовый.Площадь()` для демонстрации доступа к родительским методам.
+Аналогично `Круг`, но с двумя свойствами `Ширина` и `Высота`. `Площадь()` вычисляет ширину * высоту. Показан комментарий о возможном вызове `Базовый.Площадь()` для демонстрации доступа к родительским методам.
 
 #### Полиморфизм в массиве фигур {#полиморфизм-в-массиве-фигур}
 
@@ -500,3 +504,94 @@
 Как вы можете наблюдать, аннотации типов всегда прописываются перед ключевыми словами: `Перем`, `Функция`, и перед названиями параметров. Это не обязательно, просто код так выглядит чище. Самое главное — чтобы аннотация типа была самой последней.
 
 [↑ В начало](#оглавление)
+
+### Интерфейсы {#интерфейсы}
+
+Интерфейсы в Fint позволяют определять контракты для классов, обеспечивая полиморфизм без реализации конкретной логики. Интерфейс объявляется аннотацией `&Интерфейс` и содержит абстрактные методы (без тела), которые должны быть реализованы в классах, наследующих интерфейс. Реализация происходит через аннотацию `&Наследует("ИмяИнтерфейса")`, аналогично наследованию от классов. Это позволяет использовать объекты разных классов через общий интерфейс, поддерживая принцип "программируй на интерфейсах".
+
+Интерфейсы полезны для определения поведения, которое должно быть общим для нескольких классов, без привязки к конкретной реализации. Методы интерфейса могут иметь типизацию параметров и возвращаемых значений, обеспечивая строгую типизацию.
+
+#### Базовый интерфейс: ОбработчикЗапроса {#базовый-интерфейс-обработчикзапроса}
+
+Рассмотрим интерфейс `ОбработчикЗапроса` из пространства `fint_web`, который определяет контракт для обработки HTTP-запросов. Он содержит три абстрактных метода: для отправки ответа, отправки ошибки и проверки статуса отправки.
+
+```bsl
+&Интерфейс
+Перем Этот;
+
+Процедура ОтправитьОтвет() Экспорт
+КонецПроцедуры
+
+Процедура ОтправитьОшибку(&Число ТекстОшибки) Экспорт
+КонецПроцедуры
+
+&Булево Функция Отправлен() Экспорт
+КонецФункции
+```
+
+Здесь аннотация `&Интерфейс` указывает, что это интерфейс. Методы объявлены как абстрактные (без тела), с типизацией: `ОтправитьОшибку` принимает параметр типа `&Число`, `Отправлен()` возвращает `&Булево`. Реализация этих методов обязательна в наследующих классах; вызов нереализованного метода приведёт к ошибке.
+
+#### Реализация интерфейса: СвойОбработчикЗапросов {#реализация-интерфейса-свойобработчикзапросов}
+
+Класс `СвойОбработчикЗапросов` реализует интерфейс `ОбработчикЗапроса`. Для этого импортируется пространство `fint_web`, наследуется интерфейс через `&Наследует`, и переопределяются все методы интерфейса.
+
+```bsl
+&Импорт("fint_web")
+Перем ОбработчикЗапроса;
+
+&Наследует("ОбработчикЗапроса")
+Перем Этот, Базовый;
+
+Процедура ОтправитьОтвет() Экспорт
+КонецПроцедуры
+
+Процедура ОтправитьОшибку(&Число ТекстОшибки) Экспорт
+КонецПроцедуры
+
+&Булево Функция Отправлен() Экспорт
+	Возврат Истина;
+КонецФункции
+```
+
+Импорт `fint_web` делает интерфейс доступным. Аннотация `&Наследует("ОбработчикЗапроса")` указывает на реализацию интерфейса. Методы переопределяются: `ОтправитьОтвет()` и `ОтправитьОшибку()` оставлены пустыми (можно добавить логику), `Отправлен()` возвращает `Истина`, соответствуя типизации `&Булево`. Поскольку интерфейс не имеет конструктора, конструктор в реализации опционален. Переменная `Базовый` здесь не используется, так как интерфейс абстрактный, но доступна для будущих расширений.
+
+#### Использование интерфейса {#использование-интерфейса}
+
+Интерфейсы позволяют работать с объектами полиморфно: переменная может хранить экземпляр любого класса, реализующего интерфейс, и вызывать методы через контракт. Это упрощает замену реализаций без изменения кода.
+
+Пример в точке входа или другом классе:
+
+```bsl
+&Импорт("fint_web")
+Перем ОбработчикЗапроса;
+
+&Импорт
+Перем СвойОбработчикЗапросов;
+
+&ТочкаВхода
+Перем Этот;
+
+Процедура Конструктор(&ФиксированныйМассив Аргументы) Экспорт
+
+    // Создание экземпляра реализации
+    КонкретныйОбработчик = СвойОбработчикЗапросов.Создать();
+    
+    // Полиморфное использование: переменная типа интерфейса
+    Обработчик = КонкретныйОбработчик; // Присваивание реализации
+    
+    // Вызов методов интерфейса (полиморфизм)
+    Обработчик.ОтправитьОтвет();
+    Обработчик.ОтправитьОшибку(500);
+    
+    Если Обработчик.Отправлен() Тогда
+        Сообщить("Ответ отправлен успешно");
+    Иначе
+        Сообщить("Ответ не отправлен");
+    КонецЕсли;
+
+КонецПроцедуры
+```
+
+Здесь переменная `Обработчик` типизирована как `&ОбработчикЗапроса`, что обеспечивает проверку типов. Создаётся экземпляр `СвойОбработчикЗапросов`, присваивается переменной интерфейса, и вызываются методы. Если добавить другую реализацию (например, `ДругойОбработчик`), код останется неизменным — полиморфизм позволит заменить без рефакторинга. Все вызовы обеспечивают строгую типизацию и инкапсуляцию Fint.
+
+[↑ В начало](#оглавление)