QTemporaryFile и QTemporaryDir: временные файлы без утечек

Введение

Временные файлы используются повсеместно: для промежуточных результатов обработки, кэширования, атомарной записи, обмена данными между процессами. Ручное управление такими файлами чревато утечками — забытый remove() оставляет мусор на диске, особенно при аварийном завершении приложения. Qt решает эту проблему классами QTemporaryFile и QTemporaryDir, которые автоматически удаляют свои файлы при разрушении объекта.

Концепция

QTemporaryFile создаёт файл с гарантированно уникальным именем в системной временной директории (или в указанной) и по умолчанию удаляет его автоматически, когда объект выходит из области видимости. QTemporaryDir делает то же самое для целой директории, рекурсивно удаляя всё её содержимое.

Главное отличие от обычного QFile: уникальность имени гарантируется атомарно на уровне ОС, что исключает состояние гонки между несколькими процессами или потоками, пытающимися создать «временный» файл с похожим именем.

Пример кода: QTemporaryFile и QTemporaryDir

#include <QTemporaryFile>
#include <QTemporaryDir>
#include <QDebug>
#include <QDir>
#include <QFile>

void temporaryFileExample()
{
    QTemporaryFile tempFile;
    tempFile.setFileTemplate(QDir::tempPath() + "/myapp_XXXXXX.tmp");

    if (!tempFile.open()) {
        qWarning() << "Не удалось создать временный файл";
        return;
    }

    qDebug() << "Создан временный файл:" << tempFile.fileName();

    tempFile.write("Промежуточные данные обработки\n");
    tempFile.flush();

    // Если файл нужно сохранить после завершения работы программы,
    // отключаем автоудаление и переименовываем/копируем его в нужное место.
    tempFile.setAutoRemove(false);
    QString permanentName = QDir::tempPath() + "/saved_result.dat";
    tempFile.close(); // важно закрыть перед копированием/переименованием
    if (QFile::exists(permanentName))
        QFile::remove(permanentName);
    QFile::rename(tempFile.fileName(), permanentName);

    qDebug() << "Файл сохранён как:" << permanentName;

    // tempFile выходит из области видимости — поскольку autoRemove
    // выключен и файл уже переименован, ничего лишнего не произойдёт.
}

void temporaryDirExample()
{
    QTemporaryDir tempDir;
    if (!tempDir.isValid()) {
        qWarning() << "Не удалось создать временную директорию";
        return;
    }

    qDebug() << "Временная директория:" << tempDir.path();

    // Создаём внутри неё несколько файлов для промежуточной обработки
    for (int i = 0; i < 3; ++i) {
        QFile f(tempDir.filePath(QString("chunk_%1.bin").arg(i)));
        f.open(QIODevice::WriteOnly);
        f.write(QByteArray(1024, char('A' + i)));
    }

    qDebug() << "Содержимое:" << QDir(tempDir.path()).entryList(QDir::Files);

    // При выходе из функции tempDir уничтожается, и вся директория
    // со всеми файлами рекурсивно удаляется автоматически.
}

int main()
{
    temporaryFileExample();
    temporaryDirExample();
    return 0;
}

Пояснения к коду

setFileTemplate() задаёт шаблон имени с последовательностью XXXXXX, которая заменяется случайными символами для гарантии уникальности. Если шаблон не задан, Qt использует системный временный каталог и стандартный префикс на основе имени приложения.

Метод fileName() возвращает реальное имя созданного файла — оно становится известно только после успешного open(), так как именно в этот момент происходит атомарное резервирование имени.

Подводные камни

1. Файл нужно закрыть перед переименованием. Как показано в примере, попытка переименовать ещё открытый QTemporaryFile на некоторых ОС (особенно Windows) завершится ошибкой, так как файл заблокирован самим процессом.

1. Автоудаление и копирование путаются местами. Если нужно сохранить временный файл навсегда, недостаточно просто скопировать данные — нужно либо setAutoRemove(false), либо явно скопировать содержимое в новый QFile и оставить временный файл удаляемым.

1. QTemporaryDir удаляет всё рекурсивно. Будьте осторожны — если внутри временной директории случайно создана символическая ссылка на важные данные, рекурсивное удаление может затронуть их (зависит от платформы и того, следует ли удаление по симлинкам).

1. Аварийное завершение процесса. Автоудаление работает через деструктор C++, поэтому при крахе процесса (segfault, kill -9) файлы могут остаться на диске. Для критичных систем стоит предусмотреть периодическую очистку «осиротевших» временных файлов по возрасту.

1. Права доступа. По умолчанию временные файлы создаются с ограниченными правами (только для текущего пользователя), что обычно правильно для безопасности, но может мешать, если файл должен быть доступен другому процессу, запущенному от другого пользователя.

QTemporaryFile и QTemporaryDir — пример того, как RAII-идиома C++ органично сочетается с управлением ресурсами файловой системы, избавляя разработчика от ручной очистки в каждом коде выхода из функции.

================================================================================