Класс 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

Получает список имён всех зарегистрированных устройств журналов.