Как переопределить FileOpen в MQL4 для сохранения логов в JSON

Суть: Переопределение стандартных функций ввода-вывода в MQL4 выполняется с помощью макросов препроцессора #define. Это позволяет перенаправить вызовы FileOpen, FileWrite и FileClose на пользовательские функции, которые автоматически форматируют записываемые данные в валидный JSON-формат (JSON Lines), не нарушая при этом структуру существующего кода советника.

Содержание

Исходный код

Для реализации структурированного логирования мы создадим заголовочный файл JsonLogger.mqh. Он содержит функции-обертки и макросы для подмены стандартных системных вызовов. При работе с большими объемами данных, например, когда выполняется экспорт тиковой истории из MT5 в CSV с помощью CopyTicksRange, структурирование логов становится критически важным для последующего автоматизированного анализа.

//+------------------------------------------------------------------+
//|                                                   JsonLogger.mqh |
//|                                      Copyright 2024, Finfluct.   |
//+------------------------------------------------------------------+
#property copyright "Finfluct"
#property strict

// Вспомогательная функция для экранирования спецсимволов JSON
string EscapeJson(string text)
{
   StringReplace(text, "\\", "\\\\");
   StringReplace(text, "\"", "\\\"");
   StringReplace(text, "\n", "\\n");
   StringReplace(text, "\r", "\\r");
   StringReplace(text, "\t", "\\t");
   return text;
}

// Кастомная функция открытия файла
int CustomFileOpen(string file_name, int open_flags, ushort delimiter=';', uint codepage=CP_ACP)
{
   // Принудительно открываем файл в текстовом режиме для записи JSON Lines
   return FileOpen(file_name, open_flags | FILE_TXT | FILE_ANSI, delimiter, codepage);
}

// Кастомная функция записи структурированного JSON
void CustomFileWrite(int file_handle, string message, string level = "INFO")
{
   if(file_handle == INVALID_HANDLE) return;

   string time_str = TimeToString(TimeLocal(), TIME_DATE|TIME_SECONDS);
   string escaped_msg = EscapeJson(message);

   // Формируем JSON-строку (формат JSON Lines)
   string json_line = StringFormat("{\"timestamp\":\"%s\",\"level\":\"%s\",\"symbol\":\"%s\",\"period\":%d,\"message\":\"%s\"}",
                                   time_str, level, _Symbol, _Period, escaped_msg);

   FileWrite(file_handle, json_line);
}

// Кастомное закрытие файла
void CustomFileClose(int file_handle)
{
   if(file_handle != INVALID_HANDLE)
   { 
      FileClose(file_handle);
   }
}

// Переопределение стандартных функций через макросы препроцессора
#define FileOpen CustomFileOpen
#define FileWrite CustomFileWrite
#define FileClose CustomFileClose

Ниже представлен пример советника JsonLogEA.mq4, демонстрирующий бесшовную интеграцию логирования. Обратите внимание, что код советника использует стандартные имена функций, но благодаря подключению заголовочного файла они автоматически заменяются на наши кастомные JSON-обработчики.

//+------------------------------------------------------------------+
//|                                                    JsonLogEA.mq4 |
//|                                      Copyright 2024, Finfluct.   |
//+------------------------------------------------------------------+
#property copyright "Finfluct"
#property strict

// Подключаем наш логгер до начала использования файловых функций
#include 

int log_handle = INVALID_HANDLE;

int OnInit()
{
   // Вызов FileOpen автоматически перенаправляется в CustomFileOpen
   log_handle = FileOpen("ea_logs.jsonl", FILE_WRITE|FILE_READ);
   if(log_handle == INVALID_HANDLE)
   {
      Print("Ошибка открытия файла логов");
      return INIT_FAILED;
   }
   
   // Запись лога в формате JSON
   FileWrite(log_handle, "Советник успешно инициализирован", "INFO");
   return INIT_SUCCEEDED;
}

void OnDeinit(const int reason)
{
   FileWrite(log_handle, "Советник деинициализирован", "WARNING");
   FileClose(log_handle);
}

void OnTick()
{
   static int tick_count = 0;
   tick_count++;
   
   if(tick_count % 10 == 0)
   { 
      string msg = StringFormat("Обработано %d тиков. Текущий Bid: %g", tick_count, Bid);
      FileWrite(log_handle, msg, "DEBUG");
   }
}

Разбор параметров

file_name: Имя файла лога. Передается в стандартную функцию FileOpen. Наш оберточный метод автоматически добавляет флаги FILE_TXT и FILE_ANSI для корректной записи текстовых строк.
message: Текстовое сообщение лога. Перед записью строка проходит обязательную очистку и экранирование спецсимволов (кавычек, обратных слэшей и переносов строк) для предотвращения поломки JSON-структуры.
level: Уровень логирования (например, INFO, WARNING, ERROR). Позволяет классифицировать записи для последующей фильтрации в системах анализа логов.

Как запустить

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

1. Создайте файл JsonLogger.mqh в папке MQL4/Include/ вашего терминала MetaTrader 4 и скопируйте туда код библиотеки.

2. Создайте новый советник в MQL4/Experts/, подключите заголовочный файл с помощью директивы #include в самом начале файла (до любого использования файловых функций).

3. Скомпилируйте советник и запустите его на графике. Файл лога будет создан в папке MQL4/Files/.

Такой подход часто применяется в высокочастотных торговых системах, например, при реализации алгоритма Bid/Ask Imbalance в MQL5, где скорость записи и удобство парсинга логов напрямую влияют на скорость отладки.

Если вы разрабатываете сложные аналитические модули, такие как расчет корреляции VIX и валют в MT5 через Custom Symbol, структурированный лог в формате JSON позволит легко передавать данные во внешние BI-системы или Python-скрипты для визуализации.