useyourmind - single page application framework
Фреймворк для разработки одностраничных веб-приложений
Структура приложения
/
Модули приложения:
-
starter.exe запуск приложения и управления процессами.
-
webserver.exe веб-сервер.
-
showdata.exe контроллер сеанса, интерфейс приложения.
-
dataserver.exe сервер данных (обработка запросов к данным).
-
onesharp.dll библиотека функций языка 1С.
/doc
Документация в формате markdown
/data
Файлы данных пользователей
/os
Исходный код под OneScript (больше не поддерживается)
/resource
Файлы веб-интерфейса
/src
Исходный код проекта в С#
Для запуска локально на своем компьютере необходимо:
Скачать последнюю версию useyourmind: https://github.com/vasvl123/useyourmind/releases
Под Windows:
Установить библиотеку .Net версии не ниже 4.5
Перейти в папку useyourmind и выполнить команду: starter.exe
Открыть в браузере ссылку: http://localhost:8888
Под Linux:
Установить пакет mono-complete не ниже 5.2.
Перейти в папку useyourmind и выполнить команду: mono starter.exe
Открыть в браузере ссылку: http://localhost:8888
Запустить в режиме сайта на порту 8080: mono starter.exe site 8080
Демонстрация работы фреймворка: https://onesharp.net/
Описание:
Модуль starter.exe запускает процессы webserver.exe, dataserver.exe. Отдельные процессы showdata.exe запускается для каждого пользовательского соединения. Каждый процесс использует отдельный TCP порт для обмена данными.
Веб-сервер (модуль webserver.exe) может запускается в локальном режиме, или в режиме веб-сайта. По умолчанию принимает подключения на порту 8888.
Файл контейнера данных (.sdb) содержит заголовки и файлы данных. Доступ к файлам данных осуществляется через отдельный процесс - сервер данных (dataserver.exe). Сервер обрабатывает запросы ассинхронно, отдавая результаты по мере выполнения запросов.
Файл данных *.sd - это текстовый файл, каждая строка которого хранит один узел DOM. Свойства узлов хранятся в виде пары ключ - значение, разделенные символом табуляции. Код узла соответствует номеру строки в файле. Узел загружается в память в виде структуры, содержащей стандартные свойства: Код, Имя, Значение, и ссылки на другие узлы: Соседний, Дочерний, Атрибут, Старший, Родитель.
Модуль процесса пользователя (showdata.exe) хранит текущее состояние сеанса, производит обработку запросов пользователя, содержит редактор структуры данных. Редактор запускается в отдельном окне из главного меню программы. Для изменения структуры данных нужно выбрать нужный узел и выполнить с ним действия. Узлы можно создавать, удалять, копировать, вырезать и вставлять, изменять имя и значение. Имя узла - его тип - определяет, как он будет обрабатываться внутренним интерпретатором (класс pagedata).
Модуль интерпретатора формирует представление данных для отображения в браузере. Имя узла опреляет каким образом он будет обработан интерпретатором.
- О (Объект) - имеет структуру свойств и включает в себя другие объекты.
- Ф (Функция) - вызывает функцию из подключаемой библиотеки. Результат выполнения функции отображается как содержимое узла и может быть интерпретирован.
- А (Аргумент) - аргумент функции.
- О (Оператор) - выполняет действие над вложенными узлами.
- С (Ссылка) - устанавливает связь со свойством объекта.
- З (Значение) - интерпретирует значение свойства объекта.
- Свойство - получает значение свойства ссылки (структуры)
- Атрибут - получает значение атрибута узла.
- Первый, Соседний - передает ссылку на текущий или соседний узел.
- Истина, Ложь, Неопределенно, Пустой, Число, Строка - передает соответствующее значение. Теги HTML передаются в виде HTML разметки.
Результат (в виде обычного HTML) передается браузеру и загружается в определяемый идентификатором узел DOM страницы. Для работы с DOM используется библиотека JQuery. В качестве шаблона используется CoreUI и BootStrap 4.
Используется библиотека onesharp.net https://github.com/vasvl123/onesharp.net