Класс trace_stream_t

#include <types.hpp>

Граф наследования:trace_stream_t:

Полный список членов класса

---

Подробное описание

Интерфейс потока трассировочной и восстановочной информации.

Начиная с:

v.1.4.0

Методы append и reverse_replay можно вызывать только после успешного обращения к методам open или create.

Методы is_exists и destroy можно вызывать вне зависимости от того, открыт ли trace-stream или нет.

Открытые члены
virtual void	open (const std::string &physic_name, const config_t &config, bool is_read_only)=0
virtual void	create (const std::string &physic_name, const config_t &config)=0
virtual void	destroy (const std::string &physic_name)=0
virtual bool	is_exists (const std::string &physic_name)=0
virtual void	append (const trace_stream_item_t &item)=0
virtual void	reverse_replay (committer_t &committer, trace_file_number_set_t *used_files=0, trace_file_number_set_t *unused_files=0, std::ostream *verbose_stream=0)=0
virtual void	close ()=0

---

Методы

virtual void append

(

const trace_stream_item_t &

item

)

[pure virtual]

Дописать в trace-stream описание очередной транзакции.

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

Замещается в std_trace_stream_t и pseudo_trace_stream_t.

virtual void close

(

)

[pure virtual]

Закрыть trace-stream.

Замещается в std_trace_stream_t и pseudo_trace_stream_t.

virtual void create	(	const std::string &	physic_name,
		const config_t &	config
	)			[pure virtual]

Создать trace-stream.

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

Аргументы:

physic_name	Физическое имя создаваемой БД.
config	Конфигурация создаваемой БД.

Замещается в std_trace_stream_t и pseudo_trace_stream_t.

virtual void destroy

(

const std::string &

physic_name

)

[pure virtual]

Удалить trace-stream.

Удаляет все найденые трассировочные файлы.

Аргументы:

physic_name

Физическое имя БД, для которой уничтожаются трасировочные файлы.

Замещается в std_trace_stream_t и pseudo_trace_stream_t.

virtual bool is_exists

(

const std::string &

physic_name

)

[pure virtual]

Проверить существование trace-stream.

Возвращает:

true, если существует хотя бы один trace-файл.

Аргументы:

physic_name

Физическое имя БД для которой проверяется существование trace-stream.

Замещается в std_trace_stream_t и pseudo_trace_stream_t.

virtual void open	(	const std::string &	physic_name,
		const config_t &	config,
		bool	is_read_only
	)			[pure virtual]

Открыть trace-stream.

Если нет ни одного трассировочного файла, то порождается исключение.

Аргументы:

physic_name	Физическое имя БД.
config	Конфигурация БД.
is_read_only	Открывать в режиме read-only?

Замещается в std_trace_stream_t и pseudo_trace_stream_t.

virtual void reverse_replay	(	committer_t &	committer,
		trace_file_number_set_t *	used_files = 0,
		trace_file_number_set_t *	unused_files = 0,
		std::ostream *	verbose_stream = 0
	)			[pure virtual]

Выполнить обратное воспроизведение trace-файлов.

Каждая сформированная страница основного файла передается на фиксацию объекту committer-у.

Обратный просмотр завершается когда обнаруживается, что все страницы основного файла были перезаписаны и в оставшихся trace-файлах находятся уже устаревшие значения.

В used_files возвращаются номера trace-файлов, значения которых были использованны для восстановления значений БД. В unused_files возращаются имена trace-файлов, значения которых полностью устарели.

Аргументы:

verbose_stream

Необязательный поток для выдачи информации о ходе обратного воспроизведения trace-файлов.

Замещается в std_trace_stream_t и pseudo_trace_stream_t.

---

Объявления и описания членов классов находятся в файлах:

• oess_1/db/storage/trx/h/types.hpp
• oess_1/db/storage/trx/types.cpp

---