#include <boost/log/attributes/attribute.hpp>
#include <boost/log/attributes/attribute_value.hpp>
#include <boost/log/attributes/attribute_value_impl.hpp>

Разработка собственных атрибутов довольно проста. Как правило, вы должны сделать следующее:

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

С точки зрения библиотеки каждое значение атрибута считается независимым от других значений атрибута или самого атрибута. Тем не менее, все еще можно реализовать атрибуты, которые также являются значениями атрибутов, что позволяет в некоторых случаях оптимизировать производительность. Это возможно, если выполняются следующие требования:

В качестве специального случая для второго пункта можно хранить значения атрибутов (или их части) в нитевидном хранилище. Однако в этом случае пользователь должен правильно реализовать метод detach_from_thread реализации значения атрибута. Результат этого метода - другое значение атрибута - должен быть независимым от потока, в который он вызывается, но его сохраненное значение должно быть эквивалентно исходному значению атрибута. Этот метод будет называться библиотекой, когда значение атрибута переходит в поток, который отличается от потока, где он был создан. На данный момент это произойдет только в случае асинхронных рубок .

Но в подавляющем большинстве случаев значения атрибутов должны быть автономными объектами, не зависящими от других сущностей. На самом деле этот случай настолько распространен, что библиотека предоставляет готовый к использованию шаблон класса реализации значений атрибутов attribute_value_impl и make_attribute_value функция генератора. Шаблон класса должен быть инстанцирован по типу сохраненного значения, а сохраненное значение должно быть предоставлено конструктору класса. Например, давайте реализуем атрибут, который возвращает время безотказной работы системы за секунды. Это класс реализации атрибутов.

// The function returns the system uptime, in seconds
unsigned int get_uptime();
// Attribute implementation class
class system_uptime_impl :
    public logging::attribute::impl
{
public:
    // The method generates a new attribute value
    logging::attribute_value get_value()
    {
        return attrs::make_attribute_value(get_uptime());
    }
};

Поскольку нет необходимости в специальных классах значений атрибутов, мы можем использовать функцию make_attribute_value для создания оболочки значений.

	Tip
	Для таких случаев, когда значение атрибута может быть получено в одном вызове функции, обычно удобнее использовать атрибут .

Класс интерфейса атрибута можно определить следующим образом:

// Attribute interface class
class system_uptime :
    public logging::attribute
{
public:
    system_uptime() : logging::attribute(new system_uptime_impl())
    {
    }
    // Attribute casting support
    explicit system_uptime(attrs::cast_source const& source) : logging::attribute(source.as< system_uptime_impl >())
    {
    }
};

Как упоминалось ранее, конструктор по умолчанию создает экземпляр реализации так, чтобы построенный по умолчанию атрибут мог использоваться библиотекой.

Второй конструктор добавляет поддержку литья атрибутов. Аргумент конструктора содержит ссылку на объект реализации атрибута и, называя as на нем, конструктор пытается отодвинуть его к объекту реализации нашего пользовательского атрибута. Метод as вернется NULL, если извержение не удается, что приводит к пустому атрибуту, построенному в случае отказа.

Определив эти два класса, атрибут можно использовать с библиотекой как обычно:

void init_logging()
{
    boost::shared_ptr< logging::core > core = logging::core::get();
    // ...
    // Add the uptime attribute to the core
    core->add_global_attribute("SystemUptime", system_uptime());
}

См. полный код .