Класс Logger
#include <QtCrypto>
Диаграмма кооперации класса QCA::Logger:
Публичные типы
| enum | Severity { Quiet = 0 , Emergency = 1 , Alert = 2 , Critical = 3 , Error = 4 , Warning = 5 , Notice = 6 , Information = 7 , Debug = 8 } |
Публичные функции
| QStringList | currentLogDevices () const |
| Severity | level () const |
| void | logBinaryMessage (const QByteArray &blob, Severity=Information) |
| void | logTextMessage (const QString &message, Severity=Information) |
| void | registerLogDevice (AbstractLogDevice *logger) |
| void | setLevel (Severity level) |
| void | unregisterLogDevice (const QString &loggerName) |
Дружественные функции и классы
| class | Global |
Подробное описание
Простая система ведения журнала.
Этот класс обеспечивает простой, но гибкий подход к ведению журнала, который может использоваться для отладки или диагностики работы системы.
Для каждого приложения, использующего QCA, есть один Logger. Не нужно создавать Logger
самостоятельно — QCA автоматически создаёт его при запуске. Можно получить доступ к Logger,
используя глобальный метод
QCA::logger().
По умолчанию Logger принимает все сообщения (двоичные и текстовые). Если нужно получить доступ к этим сообщениям, необходимо создать подкласс AbstractLogDevice и зарегистрировать его (с помощью registerLogDevice()). Затем можно будет выполнить любое подходящее действие (например, показать сообщение пользователю с помощью графического интерфейса, войти в файл или отправить стандартную ошибку).
Описание перечислений
Severity
| enum QCA::Logger::Severity |
Серьёзность сообщения.
Эта информация может использоваться устройством журналирования для определения соответствующего действия.
Quiet |
Quiet: отключить логирование |
Emergency |
Emergency: система непригодна для использования |
Alert |
Alert: действия необходимо предпринять немедленно |
Critical |
Critical: критические состояния |
Error |
Error: условия ошибки |
Warning |
Warning: условия предупреждения |
Notice |
Notice: нормальное, но серьёзное состояние |
Information |
Informational: информационные сообщения |
Debug |
Debug: сообщения уровня отладки |
Описание методов
level()
| Severity QCA::Logger::level () const | inline |
Возвращает текущий уровень логирования.
Возвращает текущий уровень.
setLevel()
| void QCA::Logger::setLevel (Severity level) |
Устанавливает текущий уровень логирования.
Параметры
| level | Новый уровень логирования |
Регистрируются только уровни серьёзности, меньшие или равные уровню логирования.
logTextMessage()
| void QCA::Logger::logTextMessage (const QString & message, Severity = Information ) |
Записывает сообщение на все доступные устройства журналирования.
Параметры
| message | Текст для регистрации |
logBinaryMessage()
| void QCA::Logger::logBinaryMessage (const QByteArray & blob, Severity = Information ) |
Записывает большой двоичный объект на все доступные устройства ведения журнала.
Параметры
| blob | Информация для регистрации |
Примечание.
То, как данные обрабатываются, довольно специфично для журнала. Например, данные могут быть зарегистрированы как двоичные или каким-то образом закодированы.
registerLogDevice()
| void QCA::Logger::registerLogDevice (AbstractLogDevice * logger) |
Добавляет подкласс AbstractLogDevice к существующему списку средств ведения журнала.
Параметры
| logger | LogDevice для добавления |
unregisterLogDevice()
| void QCA::Logger::unregisterLogDevice (const QString & loggerName) |
Удаляет подкласс AbstractLogDevice из существующего списка средств ведения журнала.
Параметры
| loggerName | Имя LogDevice, которое нужно удалить |
Примечание.
Если существует несколько устройств с одинаковыми именами, все они будут удалены.
currentLogDevices()
| QStringList QCA::Logger::currentLogDevices () const |
Получает список имён всех зарегистрированных устройств журналов.