silverbulleters / bsl-platform-context

Контекст платформы 1С:Предприятие 8

Контекст платформы 1С:Предприятие

Предоставление контекста платформы 1С:Предприятие в виде Java библиотеки.

Возможности

Доступны данные:

• Типы платформы
• События платформы

Поддерживаемые версии платформы: 8.2.19 - 8.3.20

Примеры

Инициализация

List<PlatformEdition> editions = List.of(PlatformEdition.VERSION_8_2_19);
BSLPlatformContext platformContext = new BSLPlatformContext(editions);

Получение набора событий

// ...
Set<Event> events = platformContext.getEventsByPlatform(PlatformEdition.VERSION_8_2_19);
events.forEach(event -> {
  // имя события на русском
  System.out.println(event.getName().getNameRu());

  event.getTypes().forEach(platformTypeReference -> {
      // идентификаторы возможных типов события
      System.out.println(platformTypeReference.getValue());
  });
});

Как вести разработку

Для разработки используются следующие таргеты:

• JDK 11
• IntelliJ IDEA 2021.1.1

Лицензия

Используется лицензия GPL-3.0 License

bsl-platform-context's Issues

Заготовка проекта

Добавить идентификаторы ХранилищаНастроек

• SETTINGS_STORAGE_MANAGER

Свойства типов

Сводная информация по наличию глобальных методов в определённых версиях платформы 1С

CI

• Сборка
• Проверка
• Анализ в SonarSource

Свойства типов

Вид типа платформы

• Перечисление
• Тип

API: Список свойств глобального контекста

Минимизация размера JSON

На текущий момент в ресурсах data содержится около 15МБ данных. Эти данные можно сжать с помощью GZip и научить ReadDataCollector читатать поток текста из архива.

API: тип платформы по имени

Механизм патчей контекста

В справке есть ошибки. Их можно исправить в данных, но нужно уметь эти данные сохранить при перезагрузке контекста. Пример ошибки:

На самом деле это свойство read and write.

Javadoc

• Сайт-заглушка на mkdocs
• Публикация Javadoc на GitHub Pages

Контекст выполнения

Контекст выполнения есть у:

• Типов
• Методов
• Свойств
• События

Поддержка контекста 8.3.20

Gradle 7 + обновление зависимостей

Значения типов

Для перечислений

Получение глобальных асинхронных методов

Сигнатуры методов и событий

• Общие поля (name, description, constructor, parameters)
• Параметры методов

Хранение json данных выгрузки контекста как binary

Diff для json выгрузки контекста бесполезен.

Добавить обработку перечисления "Клавиша"

У перечисления "Клавиша" значения представляют собой не "конкретные" значения, а их диапазон. Необходимо раскрыть этот диапазон на множество конкретных значений

Методы типов платформы

Дано

• Список имен методов на двух языках для каждого типа (например, https://github.com/silverbulleters/bsl-platform-context/blob/develop/src/main/resources/data/8_2_19.json#L8)
• Класс ContextType - определение типа платформы
• Класс Method - определение метода
• Отправная точка тест BSLPlatformContextTest.testReadingDataFromFile и ReadDataCollector

Нужно

• Загрузить методы для типов платформы