Skip to content

Latest commit

 

History

History
88 lines (73 loc) · 4.28 KB

configuration-loading-RU.md

File metadata and controls

88 lines (73 loc) · 4.28 KB

Загрузка конфигурации

Конфигурация LogIt++ разделена на явные этапы:

JSON value или text
    -> ConfigurationDocument
    -> validation и materialization
    -> разрешение programmatic bindings
    -> создание runtime logger'ов

Основная semantic model и runtime-слои не зависят от JSON-библиотеки. JSON frontend является optional и использует nlohmann::json только при включённой опции LOGIT_WITH_JSON_CONFIG=ON.

Включение JSON frontend

Установите nlohmann_json либо разрешите fallback из дерева исходников:

cmake -S . -B build \
  -DLOGIT_WITH_JSON_CONFIG=ON \
  -DLOGIT_USE_SUBMODULES=ON

Установленный пакет с этой опцией использует find_dependency(nlohmann_json 3.11 CONFIG). Установка сборки с bundled fallback намеренно запрещена: для экспортируемого пакета установите nlohmann_json отдельно.

Разбор JSON

При включённой опции <logit.hpp> предоставляет overload'ы для JSON-текста и уже разобранного значения nlohmann::json:

#include <logit.hpp>

const std::string text = R"json({
  "schema_version": 1,
  "loggers": [{
    "id": "application-file",
    "type": "file",
    "backend": {
      "directory": "logs",
      "async": true,
      "use_dedicated_executor": true,
      "queue_capacity": 8192,
      "queue_policy": "block"
    }
  }]
})json";

logit::ConfigurationDocument document;
logit::ConfigurationDiagnostics diagnostics;
if (!logit::parse_configuration_json(text, document, diagnostics)) {
    // Обработайте diagnostics.items().
}

Разбор не создаёт logger'ы и заменяет document только после полного успеха. Frontend возвращает path-aware diagnostics для JSON syntax и shape/conversion ошибок; синтаксические ошибки используют категорию configuration_parse_failed. Backend schema validation выполняется отдельной core-фазой: unknown fields, backend types, enum/named values, defaults и feature availability могут быть диагностированы materialize_configuration(), а не JSON conversion. Floating-point значения JSON отклоняются, поскольку в schema v1 предусмотрены только signed и unsigned integer значения.

Следующие этапы вызываются явно через materialize_configuration() и instantiate_configuration(). Frontend не читает файлы, не вводит собственные defaults, не разрешает callback'и и не создаёт logger'ы. instantiate_configuration() остаётся compatibility API для backend-instantiation: factory сама владеет level logger'а и не создаёт formatter из materialized strategy. Для атомарного применения strategy используйте prepare_configuration(): он создаёт formatter и назначает explicit level или default TRACE. Properties input и hot reload пока не реализованы.

Для подготовки runtime-пар доступен prepare_configuration(). Он возвращает ConfigurationPreparedSet: стабильный ID logger'а, конкретные ILogger, ILogFormatter и применённый LogLevel. При отсутствии level используется TRACE; formatter schema v1 имеет тип simple, defaults публичного SimpleLogFormatter::Config, а затем применяет явные pattern и JSON overrides. Prepared result использует shared ownership в соответствии с существующим factory API. Logger::add_logger() пока принимает unique ownership, поэтому регистрация остаётся отдельной границей; подготовка не изменяет глобальный singleton поэлементно.