Определяемые пользоватем классы

Определяемые пользоватем классы

Файл в таком формате определяет пользовательский класс:

@CLASS
имя_класса

# необязательно
@USE
файл_с_родительским классом

# необязательно
@OPTIONS   [3.3.0]
locals
partial
dynamic или static   [3.4.1]

# необязательно
# нельзя наследоваться от системных классов [3.4.0]
@BASE
имя_родительского_класса

# так рекомендуется называть метод-конструктор класса
@create[параметры]

# далее следуют определения методов класса
@method1[параметры]
…

Модуль можно подключить (см. «Подключение модулей») к произвольному файлу - там появится возможность использования определенного здесь класса.

Если происходит обращение к неизвестному классу, вызывается метод autouse класса MAIN, и имя класса передается единственным параметром этому методу.   [3.4.0]

Если не указать @CLASS, файл определит ряд дополнительных операторов.

Если определен метод…
@auto[]
код

…он будет выполнен автоматически при загрузке класса как статический метод (так называемый статический конструктор). Используется для инициализации статических полей (переменных) класса.
Примечание: результат работы метода игнорируется - никуда не попадает.

У метода auto может быть объявлен параметр:
@auto[filespec]
В этом параметре Parser передаст полное имя файла, содержащего метод.

В Parser создаваемые классы наследуют методы классов, от которых были унаследованы. Унаследованные методы можно переопределить.
Примечание: метод auto не наследуется, благодаря чему не происходит его множественного выполнения, сначала при инициализации родительского класса, а затем - текущего.   [3.4.1]

В том случае, когда в качестве родительского класса выступает другой пользовательский класс, необходимо подключить модуль, в котором он находится, а также объявить класс базовым (@BASE).

Для того, чтобы пользоваться методами и полями родительских классов, необходимо использовать следующие конструкции:

^класс:метод[параметры] - вызов метода родительского класса (примечание: хотя такой синтаксис вызова метода и похож на синтаксис вызова статического метода, фактически, в случае динамического метода, происходит динамический вызов метода родительского класса), для обращения к своему ближайшему родительскому классу (базовому классу) можно использовать конструкции ^BASE:конструктор[параметры] и ^BASE:метод[параметры].
Примечание: аналогично можно обращаться к свойствам базового класса - $BASE:свойство и $BASE:свойство[значение].   [3.4.5]

С помощью @OPTIONS можно определить дополнительное поведение класса.   [3.3.0]
Примечание: пробельные символы в конце метокоманд @USE, @CLASS, @BASE, @OPTIONS игнорируются.   [3.4.1]

Так, указанная опция locals автоматически объявит локальными все переменные во всех методах определяемого класса. Если она указана, то для записи в поля объекта или класса необходимо пользоваться системной переменной self.

С помощью опции partial можно разрешить последующую подгрузку методов в класс. Если впоследствии будет сделан use файла, в котором указано такое же имя класса и эта же опция, то вместо создания нового класса с таким же именем, описанные в подключаемом файле методы будут добавлены к ранее загруженному классу. Опция может быть удобна для условного добавления в класс громоздких и редкоиспользуемых методов. После создания класса с использованием данной опции возможно лишь добавление методов классу, но не изменение его родительского класса.

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

Пример:
@CLASS
my

@OPTIONS
dynamic

# вызов $object[^my::create[]] будет допустим, а вызов $var[^my:create[]] будет вызывать исключение
@create[]
Код

# вызов ^object.method1[] будет допустим, а вызов ^my:method1[] будет вызывать исключение
@method1[]
Код

# вызов ^my:method2[] будет допустим, а вызов ^object.method2[] будет вызывать исключение
@static:method2[]
Код

Работа с переменными в статических методах
Поиск значения переменной ($name) происходит в:

·	в списке локальных переменных;

·	в текущем классе или его родителях.

Запись значения переменной ($name[value]) производится в уже имеющуюся переменную (см. область поиска выше), если таковая имеется. В противном случае создается новая переменная (поле) в текущем классе.
Область поиска значения может быть сужена указанием $self. или $класс:.

Работа с переменными в динамических методах
Поиск значения переменной ($name) происходит в:

·	в списке локальных переменных;

·	в текущем объекте;

·	в классе текущего объекта или его родителях.

Запись значения переменной ($name[value]) производится в уже имеющуюся локальную переменную, если таковая имеется. В противном случае запись происходит в переменную (поле) в текущем объекте. [3.4.5]
Область поиска значения может быть сужена указанием $self. или $класс:.

Примечание: старайтесь всячески избегать использования полей класса не из методов класса, кроме простейших случаев! По-возможности, общайтесь с объектом только через его методы.

Системное поле класса: CLASS
$имя_класса:CLASS - хранит ссылку на класс объекта.

Это удобно при задании контекста компиляции кода (см. «process. Компиляция и исполнение строки».

По этой ссылке также доступны статические поля класса, пример:

@main[]
^method[$cookie:CLASS]

@method[storage]
$storage.field

Этот код напечатает значение $cookie:field.

Системное поле класса: CLASS_NAME [3.2.2]
$объект.CLASS_NAME - хранит имя класса объекта.

Пример
$var[123]
$var.CLASS_NAME

Выведет 'string'.

User comments:

G_Z	05.12.2017 03:41
Статический конструктор @auto[] несовместим с @OPTIONS dynamic. Он будет автоматически статически вызван при загрузке файла класса из-за чего будет выброшено исключение «method is not allowed to be called statically». Чтобы этого избежать, следует явно декларировать @auto[] статически: @static:auto[].

andylars	10.07.2016 16:47
Порядок следования опций @OPTIONS partial dynamic (или static) имеет значение: partial должен быть или нет, до dynamic/static,

In order to add comments you must register.

Дата обновления: 14.04.2017