Класс so_4::rt::comm::traffic_transformator_t

Граф наследования:so_4::rt::comm::traffic_transformator_t:

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

---

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

Интерфейс трансформатора коммуникационного трафика.

Начиная с:

v.4.2.7 Трансформатор трафика должен решать следующие задачи:

• трансформация исходного трафика (компрессия, шифрование, подпись и т.д.);
• накопление входящих пакетов, пока не будет получен достаточный для обратной трансформации объем;
• выполнение обратной трансформации трафика.

Трансформаторы не должны расчитывать на знание структуры подлежащего трансформированию трафика. Это позволит создавать цепочки трансформаторов. Например, компрессор, затем шифратор, затем подписыватель.

v.4.3.1

Трансформатор не должен теперь хранить трансформированный исходящий трафик. Вместо этого метод out_transform должен помещать результат трансформации в указанный буфер-приемник.

Открытые члены
virtual so_4::ret_code_t	in_transform (const void *what, unsigned int what_size, oess_1::io::obinstream_t &to, size_t &transformed_size)=0
	Выполнить обратную трансформацию входяшего трафика.
virtual so_4::ret_code_t	out_transform (const void *what, size_t what_size, oess_1::io::obinstream_t &to)=0
	Выполнить трансформацию очередной порции.

---

Методы

virtual so_4::ret_code_t so_4::rt::comm::traffic_transformator_t::in_transform	(	const void *	what,
		unsigned int	what_size,
		oess_1::io::obinstream_t &	to,
		size_t &	transformed_size
	)			[pure virtual]

Выполнить обратную трансформацию входяшего трафика.

Может получиться так, что во входящем трафике недостаточно информации для успешной детрансформации. В этом случае входящие данные должны быть сохранены внутри трансформатора, а в transformed_size должен быть возвращен 0.

Возвращает:

so_4::rt::comm::success в случае отсутствия ошибок.

Аргументы:

what	Очередная порция входящего трафика.
what_size	Размер порции.
to	Куда помещаеть результат детрансформации. Преобразованные данные записываются в конец буфера.
transformed_size	Приемник объема полученных в результате детрансформации данных.

Замещается в so_4::rt::comm::zlib_transformator_t.

virtual so_4::ret_code_t so_4::rt::comm::traffic_transformator_t::out_transform	(	const void *	what,
		size_t	what_size,
		oess_1::io::obinstream_t &	to
	)			[pure virtual]

Выполнить трансформацию очередной порции.

Преобразовованые данные должны дописываться в конец буфера to.

Возвращает:

so_4::rt::comm::success в случае отсутствия ошибок.

Аргументы:

what	Что нужно преобразовывать.
what_size	Объем данных для преобразования.
to	Приемник преобразованных данных.

Замещается в so_4::rt::comm::zlib_transformator_t.