Serialization - singleton

Boost , ,

Motivation

Features

Class Interface

Requirements

Examples

Multi-Threading

Motivation

• Некоторые статические переменные и постоянные записи данных относятся к другим. Последовательность инициализации не может быть произвольной, но должна быть в правильной последовательности.
• Ряд статических переменных не упоминается явно и без особых мер предосторожности будет удален большинством оптимизаторов кода.
• Многие из этих переменных создаются шаблонами, и необходимо соблюдать особую осторожность, чтобы убедиться, что они реализованы.
• В многопоточной системе возможно, что эти статические переменные будут доступны одновременно отдельными потоками. Это создаст условия расы с непредсказуемым поведением.

Features

• Любой экземпляр будет построен до того, как будет предпринята попытка получить к нему доступ.
• Any instance created with a template is guaranteed to be instantiated.
• Regardless of whether or not an instance has been explicitly referred to, it will not be stripped by the optimizer when the executable is built in release mode.
• All instances are constructed before main is called regardless of where they might be referenced within the program. In a multi-tasking system, this guarantees that there will be no race conditions during the construction of any instance. No thread locking is required to guarantee this.
• The above implies that any const instances are thread-safe during the whole program. Again, no thread locking is required.
• If a mutable instance is created, and such an instance is modified after main is called in a multi-threading system, there exists the possibility that a race condition will occur. The serialization library takes care that in the few places where a mutable singleton is required, it is not altered after main is called. For a more general purpose usage, thread locking on this singleton could easily be implemented. But as the serialization library didn't require it, it wasn't implemented.

Class Interface

namespace boost { 
namespace serialization {
template 
class singleton : public boost::noncopyable
{
public:
    static const T & get_const_instance();
    static T & get_mutable_instance();
    static bool is_destroyed();
};
} // namespace serialization 
} // namespace boost

static const T & get_const_instance();

Retrieve a constant reference to the singleton for this type.

static T & get_mutable_instance();

Retrieve a mutable reference to the singleton for this type.

static bool is_destroyed();

Return true if the destructor on this singleton has been called. Otherwise, return false.

Requirements

Examples

Первый способ иллюстрируется выдержкой из файлаextended_type_info.cpp, который содержит следующий код:

typedef std::setktmap; ... void extended_type_info::key_register (const char *key) {... result = singleton::get_mutable_instance().insert(this);

Второй способ — использовать.singletonкак один из базовых классов типа. Об этом свидетельствует упрощенный отрывок из.extended_type_info_typeid.hpp

templateclass extended_type_info_typeid : public detail::extended_type_info_typeid_0, public singleton>{класс друзей singleton>;; private: // частный конструктор для ингибирования любого существования, отличного от // статического. Примечание: не все компиляторы поддерживают это!!! extended_type_info_typeid() : details::extended_type_info_typeid_0(){ type_register(typeid(T)); } ~extended_type_info_typeid(){}...};

extended_type_info_typeid< T>::get_const_instance()

Многопоточность

Не звоните get_mutable_instance, когда работает более одного потока.Все синглтоны, используемые в библиотеке сериализации, следуют этому правилу. Для того, чтобы помочь обнаружить случайные нарушения этого правила существуют функции блокировки/разблокировки.

void boost::singleton_module::lock(); void boost::singleton_module::unlock(); bool boost::serialization::singleton_module::is_locked();

© CopyrightRobert Ramey2007. Распространяется под лицензией Boost Software License, версия 1.0. (См. сопроводительный файл LICENSE_1_0.txt или копию по адресу http://www.boost.org/LICENSE_1_0.txt)

Статья Serialization - singleton раздела может быть полезна для разработчиков на c++ и boost.

:: Главная :: ::