===========================================

Спецификация класса определяет, что является классом и как он себя ведет. Эта глава описывает, как использовать классы и их элементы в Cache.

Имеются также другие элементы спецификации класса, включая параметры класса и модификаторы класса. Свойства, методы, параметры и модификаторы описаны ниже.

Определить класс (создать специфицию класса) можно с помощью Cache Object Architect или Class Definition Language.

Элементами спецификации класса являются:

Разрешается использовать следующие модификаторы класса:

Подклассы класса могут перекрывать значение параметра класса и могут добавлять дополнительные параметры класса. Например, если атрибут класса назначает параметр типа данных класса, то объекты подклассов наследуют назначенное значение.

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

ATTRIBUTE NumKids { Type = %Integer(MAXVAL=10); }

Эта спецификация генерирует метод по имени NumKidsIsValidDT() который проверяет, превышает ли значение NumKids 10.

Без параметров класса создание таких функциональных возможностей потребовало бы определения класса IntegerLessThanTen.

Методы – это действия, которые можно выполнить над объектом.

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

В этом разделе описываются методы, их назначение и как их создать. Раздел содержит следующие темы:

Назначение метода – получение возвращаемого им значения (например, данных). В приложении методы могут возвращать любой заданный тип данных. Чтобы включить в метод обработку ошибок, можно использовать тип возвращаемого значения %Status и макрокоманды.

Методы работают с переменными, которые они получают через их аргументы. Метод может иметь любое число аргументов. При определении метода задаются требуемые аргументы и тип данных каждого аргумента.

Например, метод Calculate имеет три аргумента:

METHOD Calculate(&count:%Integer,name,state:%String="CA") {

Если аргументу предшествует амперсанд ("&"), это называется ссылкой. Это позволяет устанавливать новое значение для переменной аргумента во время выполнения метода. Если аргументу не предшествует амперсанд, аргумент не может меняться во время выполнения метода.

Чтобы устанавить значение параметра по умолчанию, нужно задать его равным желаемому значению.

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

Разрешено использовать следующие модификаторы методов:

В большинстве случаев термин "метод" относится к методам экземпляра. Метод экземпляра – метод, который вызван из объекта класса и выполняет некоторое действие, связанное с этим объектом. Все методы в предыдущих примерах в этой главе – методы экземпляра.

В дополнение к методам экземпляра, Cache поддерживает методы класса. В отличие от методов экземпляра, которые вызываются из специфического объекта и выполняют действия, связанные с этим объектом, метод класса не обязательно связан со специфическим объектом.

Вызывать метод класса можно двумя способоми:

Метод класса может обратиться к другим методам класса, но не может обратиться к свойствам или методам экземпляра класса. Например,

Set x=##class(Invoice).%Open(oid)

Set x=##class(Patient).%New()

Cache поддерживает четыре типа методов:

Тип метода определяет способ написания кода (программы) для метода.

Метод-код (или простой метод) – метод, который использует программный синтаксис Cache ObjectScript.

Например, следующий код (программа) Cache ObjectScript определяет метод-код Speak() для класса Dog:

CLASS Dog {

SUPER = %Persistent;

PERSISTENT;

METHOD Speak() {

CODE = {

QUIT "Woof, Woof"

}

}

}

Метод-код может содержать любой разрешенный Cache ObjectScript код, включая встроенный SQL и встроенный HTML.

Предложим, что dog - это объект класса Dog. Тогда выше описанный метод можно вызвать следующим образом:

WRITE dog.Speak() -> Woof, Woof

Метод-выражение – метод, который, будучи вызван, выполняет вычисление указанного выражения.

Например, можно преобразовывать метод Speak) класса Dog из предыдущего примера в метод выражения:

METHOD Speak() {

EXPRESSION = "Woof, Woof";

}

Предложим, что dog - это объект класса Dog. Тогда выше описанный метод можно вызвать следующим образом:

WRITE dog.Speak()

который приводит к следующему коду:

WRITE "Woof, Woof"

Intersystems Corporation настоятельно рекомендует, чтобы все формальные переменные метода-выражения имели значения по умолчанию. Это предотвратит возможные проблемы замены формальных переменных на фактические и пропуска фактических переменных во время выполнения.

Например:

METHOD xyz(a=0,b=0,c=1) {

RETURNTYPE = %Integer;

EXPRESSION = a+b*c;

}

WRITE x.xyz(1,2,3)-> WRITE 1+2*3

WRITE x.xyz(a,^b)-> WRITE a+^b*1

WRITE x.xyz()-> WRITE 0+0*1

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

call = tag^routine

где tag^routine определяет ссылку на метку tag программы routine.

Методы-вызовы полезны для включения существующего кода Cache ObjectScript в методы.

Методы-генераторы – методы, скорее не являются выполнимым кодом, а определяют во время компиляции класса выполняемый код (программу) метода. Это делается с помощью мощных средств наследования методов, которые позволяют производить высокоэффективный, специализированный код (программу), построенный в соответствии с требованиями наследования класса или свойства.

Главным образом методы-генераторы используются с классами-типами_данных и классами хранения.

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

Имеются два вида свойств:

Cache в настоящее время поддерживает только свойства-атрибуты.

Многие объектные языки, например, Java и C++, не имеют истинных свойств, но имеют переменные, управляющие общими методами доступа. В Cache свойства отличны от переменных. Имеется большой выбор свойств, при этом:

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

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

Разрешено использовать следующие модификаторы свойств:

Свойства могут быть определены как общие или частные. Если свойства частные, к ним можно обращаться только методами объекта, которому принадлежат эти свойства. Если свойства общие, к ним можно обращаться методами других объектов.

В объектах Cache частные свойства всегда наследуются и видимы подклассами класса, который определяет свойство. В других языках это часто называют защищенными свойствами.

Свойства имеют некоторые автоматически ассоциируемые с ними методы. Эти методы не наследуются через стандартные механизмы наследования. Они используют специальный механизм поведения свойства для генерации ряда методов для каждого свойства.

Каждое свойство наследует набор методов от:

Классы методов свойства – системные классы. Нельзя определить или изменить метод свойства.

Например, пусть определен класс Person с тремя атрибутами:

CLASS Person

{

SUPER = %Persistent;

PERSISTENT;

ATTRIBUTE Name { TYPE = %String; }

ATTRIBUTE Age { TYPE = %Integer; }

ATTRIBUTE DOB { TYPE = %Date; }

}

person.DobIsValid()

person.DobLogicalToDisplay()

где IsValid () – метод класса Property , а LogicalToDisplay () – метод класса типа данных %Date.

Объектный синтаксис для свойств – правила обозначений для использования набора методов поиска и присвоения значений. Для каждого свойства, всякий раз, когда программа содержит синтаксис oref.Prop (где oref – объект, а Prop – свойство), система неявно устанавливает метод oref. PropGet() или метод oref. PropSet(new). Например:

Set person.DOB=x

вызывает:

Do person.DOBSet(x)

в то время как:

WRITE person.Name

вызывает:

WRITE person.NameGet()

Вычисляемое свойство не имеет значения, хранящегося в памяти, поэтому такое свойство следует обеспечить одним или обоими из PropGet() и PropSet() методами, выполняющими вычисление свойства.

Например, если класс Car имеет атрибут Weight:

ATTRIBUTE Weight {TYPE = %Integer; }

и вычисляемый атрибут WeightInKilos, не хранящийся в памяти:

ATTRIBUTE WeightInKilos {TYPE = %Integer; CALCULATED;}

а метод WeightInKilosGet() – метод, возвращающий значение, зависящее от текущего значения Weight:

METHOD WeightInKilosGet()

RETURNTYPE = %Integer;

CODE = {

QUIT ..Weight/2.2

}

}

тогда для объекта Car разрешен следующий код:

SET car.Weight=2200

WRITE car.WeightInKilos

1000

Если нужно обратиться к хранимому в оперативной памяти значению свойства из метода экземпляра класса, можно использовать следующий синтаксис для значений, хранящихся в памяти:

Set %Name="Carl"

Эта команда непосредственно устанавливает свойство Name, равным хранимому значению "Carl", обходя логику NameSet.

Использовать синтаксис значения, хранящегося в памяти, можно только в особых случаях.

Атрибут свойства – значение, связанное с объектом. Атрибуты, обычно, определяют состояние определенного объекта.

Тип атрибута определяется связанным с ним классом (или, в случае коллекции и многомерных атрибутов, модификатором). По умолчанию, атрибуты используют тип данных %String.

Имеются несколько типов атрибутов:

Самый простой атрибут – атрибут-тип данных. Это - литеральное значение, чье поведение управляется классом-типом_данных, связанным с атрибутом.

Например, класс может определять атрибут Count, используя тип данных %Integer:

ATTRIBUTE Count { TYPE = %Integer; }

где %Integer – класс-тип_данных, Count – атрибут-тип_данных.

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

ATTRIBUTE Count { TYPE = %Integer(MAXVAL=100); }

Атрибут-ссылка – ссылка к другому объекту. Этот объект может быть встраиваемым или хранимым. В обоих случаях значение атрибута – OREF, как в памяти. На диске ссылка к хранимому объекту становится OID, в то время как встраиваемый объект становится единственной строкой, содержащей свойства всего встраиваемого объекта.

Например, если атрибут-ссылка Doc имеет тип Doctor (где Doctor является встраиваемым объектом), определение Doc было бы:

ATTRIBUTE Doc { TYPE = Doctor; }

Атрибут может быть определен как атрибут-коллекция с размещением признака коллекции в начале определения атрибута. Коллекции бывают: список (List) и массив (Array). Тип атрибута определяет содержание коллекции. Например, можно определить атрибут Colors, который является списком значений %String:

LIST ATTRIBUTE Colors { TYPE = %String; }

Можно также определить атрибут Doctor, который является массивом ссылок к объектам Doctor:

ARRAY ATTRIBUTE Doctors { TYPE = Doctor; }

Объекты-коллекции используются для манипулирования коллекциями. Тип используемого объекта-коллекции зависит от класса и типа коллекции, связанного с атрибутом. Это показано в следующей таблице:

Управлять атрибутом коллекции можно, используя методы коллекции объекта, связанные с объектом. Например, учитывая атрибут Colors, который был определен ранее, можно использовать методы, поддерживаемые классом %ListOfDataTypes:

Do obj.Colors.Insert("Red")

Do obj.Colors.Insert("Green")

Do obj.Colors.Insert("Blue")

Для сохранения большого количества данных можно определить поток. Имеются два типа потоков: двоичные (бинарные) и символьные потоки. Бинарные потоки могут использоваться для сохранения больших бинарных объектов, например, изображений. Символьные потоки могут использоваться, чтобы сохранить информацию большого объема, например, текстовый файл.

Чтобы создать атрибуты-потоки, можно использовать модификаторы класса CHARACTERSTREAM и BINARYSTREAM следующим образом:

CLASS JournalEntry {

ATTRIBUTE Date {TYPE=%Date;}

BINARYSTREAM PictureOfTheDay;

CHARACTERSTREAM EventsOfTheDay;

}

Атрибутами-потоками можно управлять с помощью объекта %Stream. Потоки имеют внутренний указатель позиции в пределах данных. Метод Write() добавляет данные к потоку с текущей позиции указателя:

SET entry=##class(JournalEntry).%New()

DO entry.EventsOfTheDay.Write("Я пошел к доктору.")

; Добавляется определенный текст в конец EventsOfTheDay.

Метод Read() возвращает заданное число байтов или символов в строке:

SET events=entry.EventsOfTheDay.Read(100)

; Возвращает до 100 символов, хранимых в EventsOfTheDay.

; В данном случае events= "Я пошел к доктору."

Метод Rewind() возвращает указатель потока на его начало. Этот метод не требует первоначального вызова, но при использовании потока должен вызываться. Например:

SET events=entry.EventsOfTheDay.Read(100)

; Возвращает до 100 символов, хранимых в EventsOfTheDay.

; В данном случае events= "Я пошел к доктору."

SET events=entry.EventsOfTheDay.Read(100)

: events=”” , так как указатель находится в конце потока

DO entry.EventsOfTheDay.Rewind()

SET events=entry.EventsOfTheDay.Read(100)

: И снова events= "Я пошел к доктору."

%Stream содержит другие методы, используемые для непосредственного доступа к объектам потока, но они не применимы к атрибутам-потокам.

Атрибуты могут быть отмечены как многомерные. Этот атрибут имеет переменную экземпляра, связывающую атрибут со всеми характеристиками узла массива и с которой операции над массивом могли бы работать подобно $ORDER.

Если abc – многомерный атрибут:

ATTRIBUTE abc { MULTIDIMENSIONAL; }

то можно использовать abc:

$DATA(abc)

$DATA((abc(3))

$GET((abc(3))

$ORDER((abc("hello",3))

KILL abc

Методы свойства и классы-типы_данных не используются для генерации методов с многомерными атрибутами. Таким образом, многомерный атрибут по имени Kids не имеет методов KidsGet(), KidsSet() или KidsLogicalToDisplay(). Не делается никакой проверки правильности при установке атрибута со значением.

Объектный синтаксис не может использоваться для многомерных атрибутов. Многомерные атрибуты не могут быть сохранены в таблицах SQL или представлены через таблицы SQL.

Фильтр не выполняет операции, если не выполняются указанные критерии. Запросы определяют комплексный набор правил для выбора объектов, основанных на одном или большем количестве атрибутов. Результат запроса – набор объектов, удовлетворяющих атрибутам (критериям) запроса. Cache имеет интерфейсы для обработки результатов запросов в Cache ObjectScript, ActiveX и Java.

Запросы могут быть написаны в SQL или Cache ObjectScript. Запросы пишут, используя Cache SQL Query Wizard в Cache Object Architect (закладка SQL).

Запросы обеспечивают логическое сравнение значений данных. Можно выполнять проверку на "больше чем", "равно" или "меньше чем" некоторое значение и включать в набор результатов только те объекты, которые удовлетворяют условиям запроса. Можно также выполнять проверку на начало строки с некоторой последовательности символов и включать в набор результатов объекты, прошедшие такую проверку.

В одном запросе можно выполнять множественные сравнения, основанные на одном или большем количестве атрибутов. Можно выполнять логическую группировку критериев. Например, критерий один И критерий два И критерий три – к набору результатов будут добавлены объекты, прошедшие все испытания; критерий один ИЛИ критерий два ИЛИ критерий три – к набору результатов будут добавлены объекты, прошедшие хотя бы одно испытание; критерий один ИЛИ критерий два И критерий три – к набору результатов будут добавлены объекты прошедшие первое испытание или второе и третье.

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

Разрешено использовать следующие модификаторы запросов:

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

CONTAINID опционально определяет, является ли первое поле строки ID.

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

Будет сгенерирована ошибка "Cardinality Mismatch", если каждое поле не имеет метаданных для каждого поля, возвращаемого запросом.

Например, запрос ByName класса IscPerson имеет следующее объявление типа:

TYPE=%SQLQuery(CONTAINID=1,ROWSPEC="ID:%Integer,Name,DOB,SSN");

Код SQL для этого запроса:

SQLQUERY =

{

SELECT ID, Name, DOB, SSN

FROM IscPerson

WHERE (Name %STARTSWITH %ALPHAUP(:name))

}

Параметр CONTAINID определяет, что первое поле – ID, и первое поле, указанное в инструкции SELECT, фактически, ID. ROWSPEC определяет, что поля должны быть ID, как целое число, за которым следует Name, DOB, и SSN. Инструкция SELECT содержит поля ID, Name, DOB, и SSN.

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

Индексы автоматически охватывают весь класс, в котором они определены: если класс Person имеет подкласс Student, то все индексы, определенные в Person содержат и объекты Person, и объекты Student. Индексы, определенные в классе Student, содержат только объекты Student.

Индексы могут сортироваться по одному или большему количеству атрибутов, принадлежащих классу. Кроме того, индексы могут хранить дополнительные данные, которые часто требуются запросом, основанным на сортируемых атрибутах.

Это очень расширяет область действия запроса, например, если оптимизатор запроса находит индекс, сортируемый атрибутами, то запрос, основанный на этом, также содержит другие атрибуты возврата запроса. Если индекс найден, набор результатов может быть создан и возвращен без обращения к диску.

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

Разрешено использовать следующие модификаторы:

Каждый атрибут, указанный в модификаторе индекса ATTRIBUTE, может также иметь необязательный тип упорядочения. Если тип упорядочения определен для атрибута, значение этого атрибута для каждого экземпляра преобразуется указанным способом прежде, чем данные будут отсортированы и сохранены в индексе. Если упорядочение не задано, тогда в качестве значения упорядочения используется свойство. Это значение унаследовано от атрибута класса типа данных. Если модификатор UNIQUE, PRIMARYKEY или IDKEY определен, упорядочение не выполняется.

Для определения типа упорядочения для атрибута используют следующий синтаксис:

INDEX IndexName {

ATTRIBUTE = AttributeName:CollationType;

}

Различные атрибуты могут иметь различные типы упорядочения. Например, атрибут Name использует упорядочение ALPHAUP, в то время как SSN использует упорядочение EXACT:

INDEX NameSSNIndex {

ATTRIBUTE = Name:ALPHAUP,SSN:EXACT;

}

Cache поддерживает следующие типы упорядочения:

Триггеры – сегменты программы, выполняемые, когда в Cache SQL происходят определенные события. Cache поддерживает триггеры, основанные на выполнении команд INSERT, UPDATE и DELETE. В зависимости от триггерного определения указанная программа будет немедленно выполнена или до, или после выполнения соответствующей команды. Каждое событие может иметь множественные триггеры, столько, сколько их будет при выполнении.

Управляемые Cache SQL триггеры будут выполнены всякий раз, когда происходят эти события, даже если они вызваны с использованием объектного синтаксиса. Например, если используется %CacheSQLStorage, то методы %Save() и %Delete() могут вызывать триггеры.

Определение класса может включать список триггерных модификаторов. Триггерным модификатором может быть:

Методы обратной связи называются системными методами и позволяют выполнять дополнительную, написанную пользователем обработку специфического события. Чтобы отличать эти типы методов, им дают имена %OnEvent, где "Event" описывает событие, которое запускает обратную связь.

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

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

В Cache поддерживаются следующие методы обратной связи:

За исключением %OnDetermineClass(), эти методы могут использоваться, чтобы выполнить любую обработку в требуемом событии.

%OnDetermineClass() – особый случай. Когда %Open() или %Delete() дается частично-сформированный OID, то вызывается метод %OnDetermineClass(), если пользователь имеет хотя бы одно фактическое имя класса. Если %OnDetermineClass() указывает, что объект принадлежит различным классам, то будет выполнен Open() нового класса или метод %Delete(). Если метод не %OnDetermineClass(), просто предполагается, что текущий класс – правильный класс.

===========================================

===========================================

По вопросам поддержки любых продуктов InterSystems Corporation обращайтесь:

Россия 121019, Москва, Волхонка, 6, #14