Система управления банком данных - История изменений

Андрей Чусов в 11:24, 15 июля 2015

2015-07-15T11:24:37Z

@@ Строка 726: / Строка 726: @@
 === Интерфейс обработчика событий IGroupEventSrc, связанных с группой ===
 === Интерфейс перечисления групп базы данных IEnumGroups ===
 === Интерфейс IElement, связанный с элементами хранимых данных ===

Андрей Чусов: /* Интерфейс базы данных IDatabase */

2015-07-15T10:17:22Z

Интерфейс базы данных IDatabase

← Предыдущая		Версия 20:17, 15 июля 2015
Строка 314:		Строка 314:
	</source>		</source>

	Функция, устанавливающая клиентский обработчик событий для текущего экземпляра базы данных. Обработчик событий задается указателем на абстрактный класс <code>[[Клиенский интерфейс обработчика событий IDatabaseEventSrcId \| IDatabaseEventSrcId]]</code>. Время жизни обработчика регулируется внутренним счетчиком ссылок, который инкрементируется при вызове функции. Необходимость в обработчике событий <code>IDatabaseEventSrcId</code> пока под вопросом, как и, соответственно, метода, поэтому метод можно пока не реализовывать.		Функция, устанавливающая клиентский обработчик событий для текущего экземпляра базы данных. Обработчик событий задается указателем на абстрактный класс <code>[[#Клиенский интерфейс обработчика событий IDatabaseEventSrcId \| IDatabaseEventSrcId]]</code>. Время жизни обработчика регулируется внутренним счетчиком ссылок, который инкрементируется при вызове функции. Необходимость в обработчике событий <code>IDatabaseEventSrcId</code> пока под вопросом, как и, соответственно, метода, поэтому метод можно пока не реализовывать.

	Параметры:		Параметры:

Андрей Чусов в 10:13, 15 июля 2015

2015-07-15T10:13:20Z

Внесённые изменения

Андрей Чусов в 09:07, 15 июля 2015

2015-07-15T09:07:37Z

Внесённые изменения

Андрей Чусов: /* Клиенский интерфейс обработчика событий IDatabaseEventSrc */

2015-07-15T08:37:05Z

Клиенский интерфейс обработчика событий IDatabaseEventSrc

← Предыдущая		Версия 18:37, 15 июля 2015
Строка 440:		Строка 440:

	<source lang=cpp>		<source lang=cpp>
	return_code_t OnSetElementData(/in, zero_terminated/ const char* group_name, /in, zero_terminated/ const char* element_name, /in, byte_size(element_data_size)/ const void* element_data, /in/ uint32_t element_data_size);		return_code_t OnSetElementData(/in, zero_terminated/ const char* group_name, /in, zero_terminated/ const char* element_name,
			/in, byte_size(element_data_size)/ const void* element_data, /in/ uint32_t element_data_size);
	</source>		</source>

Андрей Чусов: /* Клиенский интерфейс обработчика событий IDatabaseEventSrc */

2015-07-15T08:35:15Z

Клиенский интерфейс обработчика событий IDatabaseEventSrc

← Предыдущая		Версия 18:35, 15 июля 2015
Строка 331:		Строка 331:

	=== Клиенский интерфейс обработчика событий IDatabaseEventSrc ===		=== Клиенский интерфейс обработчика событий IDatabaseEventSrc ===

			Клиентский интерфейс обратного вызова, задающий методы, которые вызываются сервером при наступлении событий, связанных с текущей базой данных.

			<source lang=cpp>
			uint32_t AddRef();
			</source>

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

			Возвращаемое значение:

			Результирующее значение счетчика.

			<source lang=cpp>
			uint32_t Release();
			</source>

			Функция, выполняющая декремент счетчика ссылок, связанного с сервером, а также удаление объекта из памяти, если счетчик в результате декремента достигает нуля.

			Возвращаемое значение:

			Результирующее значение счетчика.


			<source lang=cpp>
			return_code_t OnDeleteGroup(/in, zero_terminated/ const char* group_name);
			</source>

			Событие, генерируемое при удалении группы с заданным именем.

			Параметры:

			* <code>group_name</code> - имя удаленной группы.


			<source lang=cpp>
			return_code_t OnDeleteElement(/in, zero_terminated/ const char* group_name, /in, zero_terminated/ const char* element_name);
			</source>

			Событие, генерируемое при удалении элемента.

			Параметры:

			* <code>group_name</code> - имя группы, которой принадлежал удаленный элемент.
			* <code>element_name</code> - имя удаленного элемента.


			<source lang=cpp>
			return_code_t OnRenameGroup(/in, zero_terminated/ const char* old_group_name, /in, zero_terminated/ const char* new_group_name);
			</source>

			Событие, генерируемое при переименовании группы.

			Параметры:

			* <code>old_group_name</code> - старое имя переименованной группы.
			* <code>new_group_name</code> - новое имя переименованной группы.


			<source lang=cpp>
			return_code_t OnRenameElement(/in, zero_terminated/ const char* group_name, /in, zero_terminated/ const char* old_element_name, /in, zero_terminated/ const char* new_element_name);
			</source>

			Событие, генерируемое при переименовании элемента.

			Параметры:

			* <code>group_name</code> - имя группы, содержащей переименованный элемент.
			* <code>old_element_name</code> - старое имя переименованного элемента.
			* <code>new_element_name</code> - новое имя переименованного элемента.


			<source lang=cpp>
			return_code_t OnAddGroup(/in, zero_terminated/ const char* group_name);
			</source>

			Событие, генерируемое при создании группы с указанным именем.

			Параметры:

			* <code>group_name</code> - имя созданной группы.


			<source lang=cpp>
			return_code_t OnAddElement(/in, zero_terminated/ const char* group_name, /in, zero_terminated/ const char* element_name);
			</source>

			Событие, генерируемое при создании элемента.

			Параметры:

			* <code>group_name</code> - имя группы, которой принадлежит созданный элемент.
			* <code>element_name</code> - имя созданного элемента.


			<source lang=cpp>
			return_code_t OnMoveElement(/in, zero_terminated/ const char* old_group_name, /in, zero_terminated/ const char* element_name, /in, zero_terminated/ const char* new_group_name);
			</source>

			Событие, генерируемое при переименовании элемента.

			Параметры:

			* <code>old_group_name</code> - имя группы, которой принадлежал элемент до перемещения.
			* <code>element_name</code> - имя перемещенного элемента.
			* <code>new_group_name</code> - имя группы, в которую элемент был перемещен.


			<source lang=cpp>
			return_code_t OnSetElementData(/in, zero_terminated/ const char* group_name, /in, zero_terminated/ const char* element_name, /in, byte_size(element_data_size)/ const void* element_data, /in/ uint32_t element_data_size);
			</source>

			Событие, генерируемое при установке новых данных элемента.

			Параметры:

			* <code>group_name</code> - имя группы, которой принадлежит элемент.
			* <code>element_name</code> - имя элемента.
			* <code>element_data</code> - указатель на установленные данные элемента.
			* <code>element_data_size</code> - байтовый размер установленных данных элемента.

	=== Клиенский интерфейс обработчика событий IDatabaseEventSrcId ===		=== Клиенский интерфейс обработчика событий IDatabaseEventSrcId ===

Андрей Чусов: /* Общие требования */

2015-07-15T08:13:29Z

Общие требования

← Предыдущая		Версия 18:13, 15 июля 2015
Строка 8:		Строка 8:

	=== Общие требования ===		=== Общие требования ===

			==== Интерфейсы ====

	# Интерфейс должен предоставляться so/dll-библиотекой, выполняющей роль внутрипроцессного прокси сервера, работающего на стороне клиента, и выполняющего функции по формированию SQL-запросов.		# Интерфейс должен предоставляться so/dll-библиотекой, выполняющей роль внутрипроцессного прокси сервера, работающего на стороне клиента, и выполняющего функции по формированию SQL-запросов.
Строка 15:		Строка 17:
	# Строковые параметры должны завершаться нулем.		# Строковые параметры должны завершаться нулем.
	# Интерфейсные методы не должны генерировать исключения и использовать другие языковые конструкции кроме указанных выше. Разрешается использование наследования.		# Интерфейсные методы не должны генерировать исключения и использовать другие языковые конструкции кроме указанных выше. Разрешается использование наследования.

			==== Управление памятью ====

	# При передаче входного параметра метода прокси-серверу ответственность за управление соответствующей памятью лежит на клиенте.		# При передаче входного параметра метода прокси-серверу ответственность за управление соответствующей памятью лежит на клиенте.
	# Память, выделенная на этапе "прокси сервер-СУБД" должна освобождаться на этом же этапе, если она не передается клиенту прокси-сервера.		# Память, выделенная на этапе "прокси сервер-СУБД" должна освобождаться на этом же этапе, если она не передается клиенту прокси-сервера.
	# Выходные параметры, память для хранения которых выделяется прокси-сервером, должны освобождаться клиентом посредством статического вызова <code>FreeData</code> интерфейса <code>IServerControl</code> либо вызовом <code>Release</code> полученного от сервера компонента.		# Выходные параметры, память для хранения которых выделяется прокси-сервером, должны освобождаться клиентом посредством статического вызова <code>FreeData</code> интерфейса <code>IServerControl</code> либо вызовом <code>Release</code> полученного от сервера компонента.

			==== Генерация событий ====

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

	''Ниже представлено описание требуемых интерфейсов СУБД и их методов в контексте клиента прокси-сервера и с использованием синтаксиса C++, соответствующего более общему (независимому от языка) синтаксису, используемому на диаграмме.''		''Ниже представлено описание требуемых интерфейсов СУБД и их методов в контексте клиента прокси-сервера и с использованием синтаксиса C++, соответствующего более общему (независимому от языка) синтаксису, используемому на диаграмме.''

Андрей Чусов: /* Общие требования */

2015-07-15T08:02:02Z

Общие требования

← Предыдущая		Версия 18:02, 15 июля 2015
Строка 18:		Строка 18:
	# Память, выделенная на этапе "прокси сервер-СУБД" должна освобождаться на этом же этапе, если она не передается клиенту прокси-сервера.		# Память, выделенная на этапе "прокси сервер-СУБД" должна освобождаться на этом же этапе, если она не передается клиенту прокси-сервера.
	# Выходные параметры, память для хранения которых выделяется прокси-сервером, должны освобождаться клиентом посредством статического вызова <code>FreeData</code> интерфейса <code>IServerControl</code> либо вызовом <code>Release</code> полученного от сервера компонента.		# Выходные параметры, память для хранения которых выделяется прокси-сервером, должны освобождаться клиентом посредством статического вызова <code>FreeData</code> интерфейса <code>IServerControl</code> либо вызовом <code>Release</code> полученного от сервера компонента.
			# Генерация всех клиентских событий - то есть вызов всех методов клиентских обработчиков событий - осуществляется по факту их наступления. Т.е. сначала сервером осуществляется действие, для которого в дальнейшем, если это требуется, генерируется событие.

	''Ниже представлено описание требуемых интерфейсов СУБД и их методов в контексте клиента прокси-сервера и с использованием синтаксиса C++, соответствующего более общему (независимому от языка) синтаксису, используемому на диаграмме.''		''Ниже представлено описание требуемых интерфейсов СУБД и их методов в контексте клиента прокси-сервера и с использованием синтаксиса C++, соответствующего более общему (независимому от языка) синтаксису, используемому на диаграмме.''

Андрей Чусов: /* Методы */

2015-07-15T07:40:13Z

Методы

← Предыдущая		Версия 17:40, 15 июля 2015
Строка 177:		Строка 177:
	* <code>principal_name</code> Логин пользователя, от имени которого делается вызов.		* <code>principal_name</code> Логин пользователя, от имени которого делается вызов.
	* <code>password</code> Пароль пользователя, от имени которого делается вызов.		* <code>password</code> Пароль пользователя, от имени которого делается вызов.
	* <code>dacl</code> Указатель на память, на выходе принимающий адрес буфера, в который записывается бинарное представление DACL базы данных.		* <code>dacl</code> Указатель на память, на выходе принимающий адрес буфера, в который записывается бинарное представление DACL базы данных. Буфер должен освобождаться вызовом FreeData интерфейса IServerControl.
	* <code>dacl_size</code> Байтовый размер DACL.</code>		* <code>dacl_size</code> Байтовый размер DACL.</code>

Андрей Чусов: /* Интерфейс базы данных IDatabase */

2015-07-15T07:37:26Z

Интерфейс базы данных IDatabase

← Предыдущая		Версия 17:37, 15 июля 2015
Строка 311:		Строка 311:

	<source lang=cpp>		<source lang=cpp>
	return_code_t DisconnectEventHandler(std::uint32_t ~~event_handler_t~~);		return_code_t DisconnectEventHandler(std::uint32_t event_handler_tag);
	</source>		</source>

Строка 317:		Строка 317:

	Параметры:		Параметры:
	<code>~~event_handler_t~~</code> Маркер, идентифицирующий экземпляр обработчика событий и полученный в результате вызова методов <code>ConnectEventHandler</code> или <code>ConnectEventHandlerId</code>.		<code>event_handler_tag</code> Маркер, идентифицирующий экземпляр обработчика событий и полученный в результате вызова методов <code>ConnectEventHandler</code> или <code>ConnectEventHandlerId</code>.

	=== Клиенский интерфейс обработчика событий IDatabaseEventSrc ===		=== Клиенский интерфейс обработчика событий IDatabaseEventSrc ===