Добавил:
Upload Опубликованный материал нарушает ваши авторские права? Сообщите нам.
Вуз: Предмет: Файл:
Урок 5. Архитектура Global FrameWork.doc
Скачиваний:
2
Добавлен:
01.05.2025
Размер:
1 Мб
Скачать
☆

Серверные методы класса Общие сведения

Для каждого класса при компиляции автоматически создается DPI-тип, содержащий стандартный набор статических процедур и функций, реализующих интерфейс данного класса: добавление, удаление, блокировка объекта, изменение его полей (атрибутов). DPI-тип не редактируется. Спецификация DPI-типа приведена в разделе Error: Reference source not found. Кроме этого, создается API-тип, он наследуется от данного DPI-типа. В нем происходит переопределение необходимых методов DPI-типа разработчиком и определение новых.

При создании класса-наследника, его DPI-тип наследуется от API-типа класса-предка. Тем самым осуществляется наследование методов от класса к классу. Любое обращение на изменение объектов класса происходит через API-тип класса.

Наследование типов

Все вызовы методов для работы с объектами класса должны осуществляться через API-тип объекта. Используя внутренние механизмы наследования Oracle, будет вызван последний неперекрытый метод из цепочки наследования типов.

Основные методы, формирующиеся автоматически при компиляции

Метод

Описание

AddObject

Добавление объекта в класс

AfterEdit

Проверка правильности ввода полей в таблице

ApplyItemSet

Выполнение обновление всей строки записи одновременно

BeforeEdit

Попытка блокирования объекта

CopyObject

Копирование объекта

DeleteItem

Удаление объекта

FindByMnemoCode

Поиск объекта по мнемокоду

GetHeadLine

Получение заголовка объекта из данных

GetHeadLineObject

Получение хранимого заголовка объекта

GetidBO#

Получение id бизнес-объекта по id объекта

GetidBOObj#

Получение id экземпляра бизнес-объекта по id объекта

GetidAttrName_MC

Получение мнемокода ссылочного атрибута

GetidAttrName_HL

Получение заголовка ссылочного атрибута

GetMnemoCode

Получение мнемокода объекта из данных

GetMnemoCodeObject

Получение хранимого мнемокода объекта

InsertItem

Создание объекта класса

Переопределение методов в api

Для переопределения любого из методов, сгенерированных системой в объектном типе DPI, или пришедших по наследованию из типов родительских классов, достаточно просто перенести его объявление в собстенный API-тип.

Внимание! С точки зрения переопределения, в переопределенном методе должна быть полностью сохранена спецификация функции или процедуры (не важны только комментарии). Если Вы отклонитесь в составе параметров, их направлении, названии или типе данных, это будет сочтено Oracle за новую функцию или процедуру.

Попробуем переопределить в API функцию получения заголовка GetHeadLine. Данный пример подразумевает, что Вы ввели в класс TST_Employees несколько объектов, и объявили какие либо атрибуты этого класса как входящие в заголовок. Выполните следующий запрос, чтобы убедиться в том, что метод вычисления заголовка работает:

select TST_EmployeesAPI.GetHeadLine(t.id), t.*

from TST_Employees t

Для переопределения метода откройте в PL/SQL Developer тип TST_EmployeesAPI на редактирование вместе со спецификацией и телом одновременно. В API метода видим, что в нем уже переопределен метод AfterEdit. Это объясняется тем, что хотя бы один метод всегда должен присутствовать в объектном типе Oracle. Метод AfterEdit по умолчанию в API просто передает управление методу, автоматически сгенерированному в DPI типе. В спецификации API типа перед объявлением процедуры AfterEdit вставьте:

static function GetHeadLine (idpSelf in number) return varchar2, Обратите внимание на запятую, она является обязательным разделителем между объявляемыми методами в спецификации объектного типа. Кроме того, другим отличием от пакета является то, что все объявления процедур и функций начинаются с обязательного слова STATIC.

В теле объектного типа напишите код переопределения метода, например:

static function GetHeadLine ( idpSelf in number ) return varchar2 is res varchar2(4000); begin select sFirstName || ' ' || SubStr(sSecondName, 1, 1) || '.' || SubStr(s.sLastName, 1, 1) || '.' into res from TST_Employees s where s.id = idpSelf; return res; exception when others then return null; end;

Данный код вычисляет заголовок как фамилию плюс первые буквы имени и отчества, отделяемые точкой. Выполните в Pl/SQL Developer предыдущий запрос, возвращающий заголовок, убедитесь в том, что теперь он изменился.