Class PzlPort - История изменений

Victor Yukhtenko: /* References */

2008-01-30T08:01:27Z

References

← Предыдущая		Версия 10:01, 30 января 2008
Строка 123:		Строка 123:
	}}		}}
	=References=		=References=
	[[Category:~~VpPuZzle~~]]		[[Category:VpPuZzleEn]]

Victor Yukhtenko: /* pzlPort::setComponentRegisterFileName/1 */

2008-01-29T21:12:10Z

pzlPort::setComponentRegisterFileName/1

← Предыдущая		Версия 23:12, 29 января 2008
Строка 84:		Строка 84:
	If there is no file with the given name ''ComponentRegisterFileName'', then the exception is genereated with the text		If there is no file with the given name ''ComponentRegisterFileName'', then the exception is genereated with the text
	<vip>"The file <ComponentRegisterFileName> can not be found"</vip>		<vip>"The file <ComponentRegisterFileName> can not be found"</vip>
	While checking the file existence the system exception are possible and they are stored with the message <vip>"System Error while checking the file <ComponentRegisterFileName> existence"</vip>. The error code will be stored also.		While checking the file existence the system exception are possible and they are stored with the message <vip>"System Error while checking the file <ComponentRegisterFileName> existence"</vip>
			The error code will be stored also.
	\|example=		\|example=
	<vip>		<vip>

Victor Yukhtenko в 21:08, 29 января 2008

2008-01-29T21:08:43Z

← Предыдущая		Версия 23:08, 29 января 2008
Строка 1:		Строка 1:
	{{copyright}}		{{copyright}}

	'''package PzlPort'''		'''package PzlPort'''

Victor Yukhtenko: /* pzlPort::setComponentRegisterFileName/1 */

2008-01-29T21:05:15Z

pzlPort::setComponentRegisterFileName/1

← Предыдущая		Версия 23:05, 29 января 2008
Строка 79:		Строка 79:
	The content validation of the file ''ComponentRegisterFileName'' while the predicate '''''setComponentRegisterFileName''''' performing is not used. But the file must exist.		The content validation of the file ''ComponentRegisterFileName'' while the predicate '''''setComponentRegisterFileName''''' performing is not used. But the file must exist.

	It is possible to get the name of the component registration file, assigned at the pzl-system by the use of the predicate call <vip>RegistryFileStatus=pzl::getComponentRegisterFileName()/</vip> The predicate pzl::getComponentRegisterFileName() returns the term, which reflects the status of the assignment of the file. If the file name has been assigned successfully, then the name will be returned as the parameter of the term.		It is possible to get the name of the component registration file, assigned at the pzl-system by the use of the predicate call <vip>RegistryFileStatus=pzl::getComponentRegisterFileName()</vip> The predicate pzl::getComponentRegisterFileName() returns the term, which reflects the status of the assignment of the file. If the file name has been assigned successfully, then the name will be returned as the parameter of the term.
	\|except=		\|except=
	If there is no file with the given name ''ComponentRegisterFileName'', then the exception is genereated with the text		If there is no file with the given name ''ComponentRegisterFileName'', then the exception is genereated with the text

Victor Yukhtenko: /* pzlPort::setComponentRegisterFileName/1 */

2008-01-29T21:04:08Z

pzlPort::setComponentRegisterFileName/1

← Предыдущая		Версия 23:04, 29 января 2008
Строка 66:		Строка 66:
	Set the name of the component registry file		Set the name of the component registry file
	\|full=		\|full=
	The file ComponentRegisterFileName is one of the places, where the information regarding the pzl-components at the given computer is stored. The other place of store is the Windows registry. When the siarching process runs the component registry file is used first. If the file dosn't exist or the component is not registered there, then the search process continued in ~~hte~~ Windows registry.		The file ComponentRegisterFileName is one of the places, where the information regarding the pzl-components at the given computer is stored. The other place of store is the Windows registry. When the siarching process runs the component registry file is used first. If the file dosn't exist or the component is not registered there, then the search process continued in the Windows registry.

	The information in the component registry file is stored in the Visual Prolog term format (save-consult data format). Before the component may be used at the given computer, it must be registered at this computer. The applicaion, which uses the pzl-technology may avoid the use of the component registry file or the applicaion may assign the use of the file by using the predicate setComponentRegisterFileName/1.		The information in the component registry file is stored in the Visual Prolog term format (save-consult data format). Before the component may be used at the given computer, it must be registered at this computer. The applicaion, which uses the pzl-technology may avoid the use of the component registry file or the applicaion may assign the use of the file by using the predicate setComponentRegisterFileName/1.
Строка 99:		Строка 99:
	</vip>		</vip>
	}}		}}

	==pzlPort::isInitialized/0==		==pzlPort::isInitialized/0==
	{{predicate		{{predicate

Victor Yukhtenko в 21:01, 29 января 2008

2008-01-29T21:01:34Z

← Предыдущая		Версия 23:01, 29 января 2008
Строка 66:		Строка 66:
	Set the name of the component registry file		Set the name of the component registry file
	\|full=		\|full=
	The file ComponentRegisterFileName is one of the places, where the information regarding the pzl-components at the given computer is stored. ~~Другим хранилищем является реестр~~ Windows. ~~При поиске информации о месте расположения компоненты, файл регистрации используется первым~~. ~~Если файла нет или компонента в нем не зарегистрирована~~, ~~то поиск продолжается в системном реестре~~ Windows.		The file ComponentRegisterFileName is one of the places, where the information regarding the pzl-components at the given computer is stored. The other place of store is the Windows registry. When the siarching process runs the component registry file is used first. If the file dosn't exist or the component is not registered there, then the search process continued in hte Windows registry.

	~~Информация в файле-реестре компонент хранится в формате термов, принятом в системе~~ Visual Prolog (save-consult). ~~Прежде чем компонента может быть использована на данном компьютере~~, ~~она должна быть на нем зарегистрирована~~. ~~Приложение~~, ~~которое использует~~ pzl-технологию, может либо не использовать файл-реестр компонент либо может назначить использование этого файла путем установки его имени с помощью предиката setComponentRegisterFileName/1.		The information in the component registry file is stored in the Visual Prolog term format (save-consult data format). Before the component may be used at the given computer, it must be registered at this computer. The applicaion, which uses the pzl-technology may avoid the use of the component registry file or the applicaion may assign the use of the file by using the predicate setComponentRegisterFileName/1.

	~~Параметр~~ ''ComponentRegisterFileName'' ~~должен быть либо полным именем файла~~, ~~либо относительным именем относительно места расположения главного исполняемого приложения~~.		The parameter ''ComponentRegisterFileName'' must be the full path to the file, or it may be relative to the directory, where the main applicaion is placed.
	~~Имя расширения файла~~ pzl-~~системой не регламентируется~~. ~~Рекомендуемое имя расширения~~ - '''.PZR'''.		The file extension is not strongly defined in the pzl-system. The recommended file extension is - '''.PZR'''.

	~~Установка имени файла после старта приложения может быть осуществлена только один раз~~.		The component registration file of the applicaion may be assigned only once. While the repetitive assignement the existence of the previous assignment is not checked.
	~~При повторном назначении файла-реестра существование предыдущего назначения не проверяется~~.

	~~Загрузка данных о регистрации компонент производится только один раз при первом обращении к какой-либо~~ pzl-~~компоненте~~. Соответственно, добавление информации о регистрации в этот же файл или изменение этой информации после того, как приложение обратилось к этому файлу, не могут повлиять на уже работающее приложение.		The component registration data is load only once while the first access to an any pzl-component. Thus the second (and further) file assignment is not make influence on the component registration.

	~~Корректность содержимого файла~~ ''ComponentRegisterFileName'' ~~при выполнении предиката~~ '''''setComponentRegisterFileName''''' ~~не проверяется~~. ~~Но файл должен существовать~~.		The content validation of the file ''ComponentRegisterFileName'' while the predicate '''''setComponentRegisterFileName''''' performing is not used. But the file must exist.

	~~Получение имени файла-реестра~~, ~~установленного в~~ pzl-~~системе возможно с помощью обращения~~		It is possible to get the name of the component registration file, assigned at the pzl-system by the use of the predicate call <vip>RegistryFileStatus=pzl::getComponentRegisterFileName()/</vip> The predicate pzl::getComponentRegisterFileName() returns the term, which reflects the status of the assignment of the file. If the file name has been assigned successfully, then the name will be returned as the parameter of the term.
	<vip>RegistryFileStatus=pzl::getComponentRegisterFileName().</vip> ~~При этом возвращается не непосредственно имя файла~~, ~~а терм, определяющий состояние назначения файла-реестра, в том числе и имя файла~~, ~~если было проведено назначение~~.
	\|except=		\|except=
	~~При отсутствии файла с именем, установленным параметром~~ ''ComponentRegisterFileName'', ~~генерируется исключение с текстом~~		If there is no file with the given name ''ComponentRegisterFileName'', then the exception is genereated with the text
	<vip>"The file <ComponentRegisterFileName> can not be found"</vip>		<vip>"The file <ComponentRegisterFileName> can not be found"</vip>
			While checking the file existence the system exception are possible and they are stored with the message <vip>"System Error while checking the file <ComponentRegisterFileName> existence"</vip>. The error code will be stored also.
	При проверке существования файла возможны системные исключения, связанные с особенностями файловой системы операционной системы с сообщением
	<vip>"System Error while checking the file <ComponentRegisterFileName> existence"</vip> ~~и сохранением кода ошибки~~.
	\|example=		\|example=
	<vip>		<vip>
Строка 110:		Строка 106:
	Checking of the initialization status of the VpPuZzle system		Checking of the initialization status of the VpPuZzle system
	\|full=		\|full=
	~~Позволяет выяснить, была ли выполнена инициализация~~ pzl-системы, то есть доступна ли она для использования. Положительный исход проверки дает положительный ответ на этот вопрос. ~~Соответственно~~, ~~отрицательный - отрицательный~~.		Makes it possible to check whether the initialization of the pzl-system was performed. If the result of the check is positive, then predicate succeeds.
	\|example=		\|example=
	<vip>		<vip>

Victor Yukhtenko в 11:15, 29 января 2008

2008-01-29T11:15:47Z

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

Victor Yukhtenko: Новая: {{copyright}} =Назначение= Класс pzlPort является ядром системы VpPuzzle и предназначен для обеспечения работы с pzl...

2008-01-28T19:53:27Z

Новая: {{copyright}} =Назначение= Класс pzlPort является ядром системы VpPuzzle и предназначен для обеспечения работы с pzl...

Новая страница

{{copyright}}
=Назначение=

Класс pzlPort является ядром системы VpPuzzle и предназначен для обеспечения работы с pzl-компонентами. Этот класс обязательно должен включаться в проект главного приложения, генерирующего исполняемый (.EXE) файл.

Обращения к предикатам этого класса возможны только из классов главного исполняемого приложения. Компоненты, помещенные в DLL-контейнеры, не могут обращаться к предикатам этого класса.

=Список предикатов класса=
{|cellspacing="0" border="1" style="float:center;background:#F9F9F9;color:black;"
|-
|[[#core::classInfo/0|classInfo]].
Получение информации о классе
|-
|[[#pzlPort::init/0|init:()]].
Инициализация системы VpPuZzle
|-
|[[#pzlPort::setComponentRegisterFileName/1|setComponentRegisterFileName:(string ComponentRegisterFileName)]].
Установка имени файла-реестра компонент
|-
|[[#pzlPort::isInitialized/0|isInitialized:() determ]].
Проверка инициализации системы VpPuZzle
|}

=Используемые дополнительные ресурсы=
Обязательно:
*использование библиотеки pzlPort_XX.lib, где XX - квалификатор лицензии. Библиотека фактически содержит имплементацию класса pzlPort и включает имплементацию свойств pzl-Контейнера главного исполняемого приложения.
*наличие пакета pzlConfig, который участвует в процессе инициализации.

=Описание предикатов класса=
==core::classInfo/0==
<vip>classInfo:().</vip>
Получение информации о классе.

'''Описание'''

Является типичным предикатом, который автоматически генерируется при генерации текста любого класса средствами IDE системы VIP. Описание и порядок использования предиката - см. руководства VIP.

==pzlPort::init/0==
<vip>init:().</vip>
Инициализация системы VpPuzzle.

'''Описание'''

Этот предикат всегда должен быть первым предикатом, к которому производится обращение. После инициализации возможны обращения к другим классам pzl-системы.

Инициализация pzl-системы может быть выполнена как немедленно после старта приложения, так и в любой другой момент, когда возникает необходимость в начале ее использования.
Деинициализация системы невозможна.

Повторная инициализация игнорируется.

'''Исключения'''

Предикат при исполнении не генерирует исключения. Повторная инициализация игнорируется.

'''Пример'''

<vip>
clauses
run():-
pzlPort::init(),
TaskWindow = taskWindow::new(),
...
</vip>

==pzlPort::setComponentRegisterFileName/1==
<vip>setComponentRegisterFileName:(string ComponentRegisterFileName).</vip>
Установка имени файла-реестра компонент.

Файл ComponentRegisterFileName является одним из хринилищ информации о pzl-компонентах на данном компьютере. Другим хранилищем является реестр Windows. При поиске информации о месте расположения компоненты, файл регистрации используется первым. Если файла нет или компонента в нем не зарегистрирована, то поиск продолжается в системном реестре Windows.

Информация в файле-реестре компонент хранится в формате термов, принятом в системе Visual Prolog (save-consult). Прежде чем компонента может быть использована на данном компьютере, она должна быть на нем зарегистрирована. Приложение, которое использует pzl-технологию, может либо не использовать файл-реестр компонент либо может назначить использование этого файла путем установки его имени с помощью предиката setComponentRegisterFileName/1.

'''Описание'''

Параметр ''ComponentRegisterFileName'' должен быть либо полным именем файла, либо относительным именем относительно места расположения главного исполняемого приложения.
Имя расширения файла pzl-системой не регламентируется. Рекомендуемое имя расширения - '''.PZR'''.

Установка имени файла после старта приложения может быть осуществлена только один раз.
При повторном назначении файла-реестра существование предыдущего назначения не проверяется.

Загрузка данных о регистрации компонент производится только один раз при первом обращении к какой-либо pzl-компоненте. Соответственно, добавление информации о регистрации в этот же файл или изменение этой информации после того, как приложение обратилось к этому файлу, не могут повлиять на уже работающее приложение.

Корректность содержимого файла ''ComponentRegisterFileName'' при выполнении предиката '''''setComponentRegisterFileName''''' не проверяется. Но файл должен существовать.

Получение имени файла-реестра, установленного в pzl-системе возможно с помощью обращения
<vip>RegistryFileStatus=pzl::getComponentRegisterFileName().</vip> При этом возвращается не непосредственно имя файла, а терм, определяющий состояние назначения файла-реестра, в том числе и имя файла, если было проведено назначение.

'''Исключения'''

При отсутствии файла с именем, установленным параметром ''ComponentRegisterFileName'', генерируется исключение с текстом
<vip>"The file <ComponentRegisterFileName> can not be found"</vip>

При проверке существования файла возможны системные исключения, связанные с особенностями файловой системы операционной системы с сообщением
<vip>"System Error while checking the file <ComponentRegisterFileName> existence"</vip> и сохранением кода ошибки.

'''Пример'''
<vip>
class predicates
runProfile:(window TaskWindow,string RegistryFileName,string InitialComponent).
clauses
runProfile(_TaskWindow,RegistryFileName,_InitialComponent):-
not(RegistryFileName=""),
trap(pzlPort::setComponentRegisterFileName(RegistryFileName),_Err,fail()),
fail.
runProfile(TaskWindow,RegistryFileName,InitialComponent):-
RegistryFileStatus=pzl::getComponentRegisterFileName(),
notifyUser(TaskWindow,RegistryFileStatus,RegistryFileName),
runStudioStarter(TaskWindow,InitialComponent).
</vip>

==pzlPort::isInitialized/0==
<vip>isInitialized:() determ.</vip>
Проверка инициализации системы VpPuZzle

'''Описание'''

Позволяет выяснить, была ли выполнена инициализация pzl-системы, то есть доступна ли она для использования. Положительный исход проверки дает положительный ответ на этот вопрос. Соответственно, отрицательный - отрицательный.

'''Исключения'''

Исключения невозможны.

'''Пример'''
<vip>
clauses
run():-
not(isInitialazed()),
pzlPort::init(),
fail.
run():-
TaskWindow = taskWindow::new(),
...
</vip>

=Ссылки=
[[Категория:VpPuZzle]]