- •Урок 5 Архитектура Global
- •Введение Содержание урока
- •Краткая аннотация платформы Global Framework
- •Арихитекура Global Framework for Oracle Основные сведения Основы архитектуры
- •Общие сведения о понятиях
- •Принципы модульности
- •Архитектура ядровых сервисов
- •Начало работы Создание пользователя
- •Создание нового модуля
- •Главная форма приложения Конфигуратор
- •Проектирование классов Общие сведения о классах
- •Окружение класса
- •Дерево классов
- •Процесс создания и настройки классов
- •Пример создания и настройки класса Создание класса
- •Настройка свойств класса
- •Создание атрибутов класса
- •Компиляция
- •Открытие объектов класса на редактирование
- •Изменение структуры хранения класса
- •Серверные методы класса Общие сведения
- •Наследование типов
- •Основные методы, формирующиеся автоматически при компиляции
- •Переопределение методов в api
- •Пересчет заголовка и мнемокода в репозитории при изменении фунций их вычисления
- •Общий обзор подсистем, входящих в Global Framework
- •Сервис управления данными о структуре объектов и способами отображения объектов.
- •Сервис управления безопасностью и пользователями
- •Сервис оповещений
- •Сервис напоминаний
- •Подсистема построения отчетов
- •Подсистема планирования задач и поддержки пользователей
- •Сервис выпуска обновлений
- •Подсистема интеграции
- •Подсистема репликации данных
Серверные методы класса Общие сведения
Для каждого класса при компиляции автоматически создается 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 предыдущий запрос, возвращающий заголовок, убедитесь в том, что теперь он изменился.
