Pzl-Component - История изменений

Victor Yukhtenko: /* The constant componentID_С */

2008-01-31T14:58:13Z

The constant componentID_С

← Предыдущая		Версия 16:58, 31 января 2008
Строка 97:		Строка 97:

	=Predefined constants of the base interface of the pzl-component=		=Predefined constants of the base interface of the pzl-component=
	===~~The constant~~ componentID_С===		===Constant componentID_С===
	The constant сomponentID_С defines the identifier of the component, which must be unique if possible in the global sense. It means that two programs in the global information space (and we do not even mention one computer), which use the component with the same identifier, may be sure that they use exactly the same pzl-component. This may be reached by the using of the Microsoft company approach to identify MSCOM components.		The constant сomponentID_С defines the identifier of the component, which must be unique if possible in the global sense. It means that two programs in the global information space (and we do not even mention one computer), which use the component with the same identifier, may be sure that they use exactly the same pzl-component. This may be reached by the using of the Microsoft company approach to identify MSCOM components.
	To fit this the pzl-technology uses the data structure with the functor uid:		To fit this the pzl-technology uses the data structure with the functor uid:

Victor Yukhtenko: /* Getting the information about the component */

2008-01-31T14:57:49Z

Getting the information about the component

← Предыдущая		Версия 16:57, 31 января 2008
Строка 389:		Строка 389:
	*getClassInfo(className,classVersion) - returns the information about the name and the version of the class pzlComponent		*getClassInfo(className,classVersion) - returns the information about the name and the version of the class pzlComponent

	To give the possbility to the external tools to access to the information about [[#~~The_ constant_componentID_С~~\|'''component identifier''']], [[#~~The_constant_~~ componentAlias_C\|'''component alias''']] и [[#~~The_constant_componentMetaInfo_C~~\|'''comonent metainfo''']], it is recommended to put the clauses listed below to the implementation of the base class of the component:		To give the possbility to the external tools to access to the information about [[#Constant_componentID_С\|'''component identifier''']], [[#Constant_ componentAlias_C\|'''component alias''']] и [[#Constant_componentMetaInfo_C\|'''comonent metainfo''']], it is recommended to put the clauses listed below to the implementation of the base class of the component:
	<vip>		<vip>
	clauses		clauses

Victor Yukhtenko: /* Getting the information about the component */

2008-01-31T14:56:25Z

Getting the information about the component

← Предыдущая		Версия 16:56, 31 января 2008
Строка 389:		Строка 389:
	*getClassInfo(className,classVersion) - returns the information about the name and the version of the class pzlComponent		*getClassInfo(className,classVersion) - returns the information about the name and the version of the class pzlComponent

	To give the possbility to the external tools to access to the information about [[#~~Constant_componentID_С~~\|'''component identifier''']], [[#~~Constant_~~ componentAlias_C\|'''component alias''']] и [[#~~Constant_componentMetaInfo_C~~\|'''comonent metainfo''']], it is recommended to put the clauses listed below to the implementation of the base class of the component:		To give the possbility to the external tools to access to the information about [[#The_ constant_componentID_С\|'''component identifier''']], [[#The_constant_ componentAlias_C\|'''component alias''']] и [[#The_constant_componentMetaInfo_C\|'''comonent metainfo''']], it is recommended to put the clauses listed below to the implementation of the base class of the component:
	<vip>		<vip>
	clauses		clauses

Victor Yukhtenko: /* Ограничения в несанкционированном использовании */

2008-01-31T14:54:10Z

Ограничения в несанкционированном использовании

← Предыдущая		Версия 16:54, 31 января 2008
Строка 398:		Строка 398:
	Remind that the declarations of these predicates you can find in the interface pzlComponent.		Remind that the declarations of these predicates you can find in the interface pzlComponent.

	==~~Ограничения в несанкционированном использовании~~==		==Unauthorized access restrictions==
	Pzl-~~Компонента не содержит никаких средств для ограничения ее использования~~. ~~Если программа получает доступ к контейнеру~~, ~~в котором расположена~~ pzl-~~Компонента~~, ~~и программе известны интерфейсы для общения с компонентной~~, ~~то эта pzl-Компонента оказывается доступной программе~~.		Pzl-componene doesn't contain any facility to restrict it's use. If the program can get an access to the pzl-container, where the pzl-component is placed, and the program knows the interfaces to communicate with the component, then this component is acessible by the program.

	Вы, ~~как автор~~ pzl-~~Компоненты, можете предусмотреть дополнительные меры по ограничению прав использования pzl-Компоненты~~.		Being the author of the component, you may provide the additional arrangements to restrict the rigts to use the pzl-component.

	~~Например~~, ~~Вы можете предусмотреть сеанс идентификации прав, в ходе которого в~~ pzl-~~Компоненту должна быть передана информация, подтверждающая права на использование данной компоненты~~.		Say, you may provide the special procedure to identify the rights to communicate with the pzl-component.

	~~Если текст программы pzl-Компоненты недоступен широкому кругу пользователей~~, ~~то такого рода защита от несанкционированного использования может оказаться достаточно эффективной~~.		If the source code of the component is not widely known, then this way of the setting of the safety may be enough efficient.

	=References=		=References=
	[[Category:VpPuZzleEn]]		[[Category:VpPuZzleEn]]

Victor Yukhtenko: /* Получение информации о компоненте */

2008-01-31T14:46:16Z

Получение информации о компоненте

← Предыдущая		Версия 16:46, 31 января 2008
Строка 383:		Строка 383:
	</vip>		</vip>

	==~~Получение информации о компоненте~~==		==Getting the information about the component==
	~~Как уже упоминалось, следующие предикаты объявлены в интерфейсе~~ pzlComponent ~~и поддерживаются содержательно~~ pzl-~~системой~~		As it was menioned before the following predicates are declared in the interface pzlComponent and these predicates are supported by the pzl-system
	*getContainerVersion() - ~~возвращает информацию о версии контейнера, в котором данная компонента содержится~~		*getContainerVersion() - returns the information about the pzl-container version
	*getContainerName() - ~~возвращает информацию об имени файла~~-~~контейнера~~, ~~в котором содержится данная компонента~~		*getContainerName() - returns the information about the name of the file-container, where the given component is placed
	*getClassInfo(className,classVersion) - ~~возвращает информации об имени и версии класса~~ pzlComponent		*getClassInfo(className,classVersion) - returns the information about the name and the version of the class pzlComponent

	~~Для того, чтобы внешние по отношению к данной компоненте средства могли бы получить информацию об~~ [[#~~Константа_componentID_С~~\|'''~~идентификаторе~~''']], [[#~~Константа_ componentAlias_C_(Условное_имя)~~\|'''~~условном наименовании~~''']] и [[#~~Константа_componentMetaInfo_C~~\|'''~~метаинформации~~''']], ~~рекомендуется помещать следующие клаузы в базовый класс pzl-компоненты~~:		To give the possbility to the external tools to access to the information about [[#Constant_componentID_С\|'''component identifier''']], [[#Constant_ componentAlias_C\|'''component alias''']] и [[#Constant_componentMetaInfo_C\|'''comonent metainfo''']], it is recommended to put the clauses listed below to the implementation of the base class of the component:
	<vip>		<vip>
	~~caluses~~		clauses
	getComponentID()= componentID_C.		getComponentID()= componentID_C.
	getComponentAlias() = componentAlias_C.		getComponentAlias() = componentAlias_C.
	getComponentMetaInfo() = componentMetaInfo_C		getComponentMetaInfo() = componentMetaInfo_C
	</vip>		</vip>
	~~Напоминаем, что объявления этих предикатов содержатся в интерфейсе~~ pzlComponent.		Remind that the declarations of these predicates you can find in the interface pzlComponent.

	==Ограничения в несанкционированном использовании==		==Ограничения в несанкционированном использовании==

Victor Yukhtenko: /* Registration */

2008-01-31T14:34:40Z

Registration

← Предыдущая		Версия 16:34, 31 января 2008
Строка 380:		Строка 380:
	<vip>		<vip>
	registryRunAbleTrue_C="True".		registryRunAbleTrue_C="True".
	registryRunAbleFalse_C="False".		registryRunAbleFalse_C="False".
	</vip>		</vip>

Victor Yukhtenko: /* Регистрация */

2008-01-31T14:33:20Z

Регистрация

← Предыдущая		Версия 16:33, 31 января 2008
Строка 350:		Строка 350:
	If the pzl-component is placed to the dll-container, then the debugging process must be started from the project of the dll-container. And this is the standard way of debugging the Dll in the Visual Prolog programming system.		If the pzl-component is placed to the dll-container, then the debugging process must be started from the project of the dll-container. And this is the standard way of debugging the Dll in the Visual Prolog programming system.

	==~~Регистрация~~==		==Registration==
	~~Если какой-либо класс и~~ pzl-~~компонента находятся в одной и той же сущности~~ (.EXE ~~или та же самая~~ DLL), ~~и при этом обращение производится в форме~~		If some class and pzl-component are placed in the same entity (.EXE or the same DLL), and the calling is made in the form
	<vip>		<vip>
	...		...
Строка 358:		Строка 358:
	...		...
	</vip>		</vip>
	~~то регистрация~~ pzl-~~Компоненты, к которой производится обращение, может не производиться~~.		then the registration of the called pzl-component is not necessary.

	~~Во всех остальных случаях компонента должна быть зарегистрирована~~		In all other cases the pzl-component must be registered at least in one of the places
	*~~либо в локальном файле пользователя~~		*local user-defined file
	*~~либо в реестре~~ LocalUser ~~системы~~ Windows (~~имя раздела~~ HKEY_CURRENT_USER)		*in the LocalUser Windows registry (the folder name HKEY_CURRENT_USER)
	*~~либо в реестре~~ LocalMashine ~~системы~~ Windows (~~имя раздела~~ HKEY_LOCAL_MACHINE)		*in the LocalMashine Windows registry (the folder name HKEY_LOCAL_MACHINE)

	'''~~Примечание~~.''' ~~Для регистрации компонент следует использовать специальные средства~~ pzl-~~Технологии~~. ~~Регистрация компонент вручную не рекомендуется~~.		'''Notice.''' To register pzl-components it is recommended to use the special tools of the pzl-technology. The manual regitration is not recommended.

	~~При регистрации компоненты в реестре системы~~ Windows ~~используются следующие имена директорий windows-реестра~~ (~~указаны в файле~~ VpPuZzle/System/Packs/pzlDomains.i)		The pzl-components are registered in the folders of the Windows registry (listed in the file VpPuZzle/System/Packs/pzlDomains.i)
	<vip>		<vip>
	constants		constants
Строка 377:		Строка 377:
	registryRunAble_C = "RunAble".		registryRunAble_C = "RunAble".
	</vip>		</vip>
	~~При этом для именования свойств компонент используются константы~~		The constants used for the registration:
	<vip>		<vip>
	registryRunAbleTrue_C="True".		registryRunAbleTrue_C="True".

Victor Yukhtenko: /* Отладка */

2008-01-31T14:20:09Z

Отладка

← Предыдущая		Версия 16:20, 31 января 2008
Строка 345:		Строка 345:
	Pzl-containers are unloading automatically, when there is no active objects in it.		Pzl-containers are unloading automatically, when there is no active objects in it.

	==~~Отладка~~==		==Debugging==
	~~Если~~ pzl-~~компонента находится в главном (исполняемом) приложении~~, ~~то отладка текста ее праграммы ничем не отличается от приемов отладки обычного класса системы Visual Prolog~~.		If the pzl-component placed in the main executable applicaion, then the debugging style is the same as the debugging style for the usual vip-classes.

	~~Если~~ pzl-~~компонента находится в pzl~~-~~Контейнере~~, ~~представляющем собой DLL, то процесс отладки должен начинаться с проекта этого контейнера (DLL)~~. ~~Впрочем, это типичный подход к отладке DLL, принятый в системе~~ Visual Prolog.		If the pzl-component is placed to the dll-container, then the debugging process must be started from the project of the dll-container. And this is the standard way of debugging the Dll in the Visual Prolog programming system.

	==Регистрация==		==Регистрация==

Victor Yukhtenko: /* Завершение использования */

2008-01-31T14:19:46Z

Завершение использования

← Предыдущая		Версия 16:19, 31 января 2008
Строка 340:		Строка 340:
	the class-delegate is not needed.		the class-delegate is not needed.

	==~~Завершение использования~~==		==The end of use==
	~~По завершении использования объекта компоненты все указатели на нее должны быть удалены~~. ~~Такое стандартное для~~ VIP ~~обращение с объектами в случае~~ pzl-~~Компоненты также приводит к гибели ее объекта~~.		When the use of the component is complete the all references to the object must be removed. This is the standard way of object handling in VIP and pzl-components have no difference here.

			Pzl-containers are unloading automatically, when there is no active objects in it.

	==Отладка==		==Отладка==

Victor Yukhtenko: /* Acessing to other classes and components */

2008-01-31T14:11:39Z

Acessing to other classes and components

← Предыдущая		Версия 16:11, 31 января 2008
Строка 312:		Строка 312:

	==Acessing to other classes and components==		==Acessing to other classes and components==
	The accessing to other classes and components ~~formt~~ the current ~~componetn has~~ not differ from the usual style of communication with classes and objects.		The accessing to other classes and components from the current component does not differ from the usual style of communication with classes and objects.
	It is needed to have in mind that to communicate with the component in the style like		It is needed to have in mind that to communicate with the component in the style like
	<vip>		<vip>