OAF: Правила разработки
No | Правило/Причина |
1 | Всегда пытайтесь создать новый элемент декларативно (через персонализацию страницы). Определяйте программно, Только если невозможно создать декларативно. |
Программно созданный элемент невозможно персонализировать, сложнее расширять и использовать. | |
2 | Если вы создаёте новый элемент программно, Никогда не использовать конструктор
new OA*Bean(). Всегда использовать createWebBean. |
Не все свойства элемента инициализируются корректно, когда используется конструктор new | |
3 | Никогда не искать элемент по индексу, для изменения его свойств. |
Индекс элемента может изменяться в процессе работы. | |
4 | Никогда не изменять свойства элемента в processFormRequest(). Всегда изменять свойства в processRequest(). Любая информация, которая влияет на отображение элемента, должна быть добавлена в URL в виде параметра. |
Гарантирует постоянное состояние при формировании страницы. | |
5 | Никогда не изменяйте свойства родительского элемента из дочернего. |
Эта плохая практика препятствует повторному использованию кода. | |
6 | Для доступа к методу, имеющему разные версии [ например setText(String text) или setText(OAPageContext pageContext, String text)], всегда используйте метод в котором присутствует параметр OAPageContext. |
Обеспечивает наиболее безопасный способ изменения объекта. | |
7 | Никогда программно не использовать неявную структуру созданную OA Framework.
Выполнять findChildRecursive() для поиска элементов. |
Определённые элементы — defaultRenderers, PageLayoutBean, TableBean – создают добавочные объекты. Эти объекты могут меняться в разных версиях, вы не можете достоверно распарсить данную структуру. | |
8 | Когда необходим доступ к Application module, использовать getApplicationModule(webBean) вместо getRootApplicationModule() там где это возможно. |
Улучшает модульность и повторное использование. | |
9 | При переходе на первую страницу определенного функционала, всегда использовать функцию меню, вместо прямой сслыки на страницу. |
Позволяет изменять адресс назначения меняя только описание функции. Не требуется изменение и перекомпиляция кода. | |
10 | Никогда не создавать программно OAFormBean. |
Страница должна иметь только один OAFormBean и он определяется декларативно для региона pageLayout | |
11 | Всегда устанавливать точность (размер) для всех колонок view objecs (VO).
Всегда указывать точность вызывая registerOutParameters. |
Например: eсли не установить точность, то для колонки типа String размер по умолчанию 4KB. | |
12 | Всегда использовать Oracle-style binding (:1, :2) и не использовать JDBC style binding (?). |
Это отменяет разбор SQL во время выполнения для замены строковых значений. | |
13 | Всегда используйте спроектированные VO вместо динамических (программно созданных). |
Динамические VO осуществляют дополнительный вызов для разбора запроса и возможный результат может иметь различные комбинации. | |
14 | Никогда не рассчитывать, что Application module будет использовать одно соединение с БД для запросов. |
Для быстродействия, Framework организует пул соединений и переиспользует их. Не держит одно соединение в течении жизни Application module. |
OAF: Конвертация типов
Тип | Конвертирование | |
STRING to NUMBER | ||
byte | Byte.parseByte(«123») | |
byte | Byte.valueOf(«123»).byteValue() | |
short | Short.parseShort(«123») | |
short | Short.valueOf(«123»).shortValue() | |
int | Integer.parseInt(«123») | |
int | Integer.valueOf(“123”).intValue() | |
long | Long.parseLong(«123») | |
long | Long.valueOf(«123»).longValue() | |
float | Float.parseFloat(«123.4») | |
float | Float.valueOf(«123.4»).floatValue() | |
double | Double.parseDouble(«123.4e10») | |
double | Double.valueOf(«123.4e10»).doubleValue() | |
Number | new Number(Integer.parseInt(«123»)) | |
NUMBER to STRING | ||
String | “” + 123 | |
String | Number | pageContext.getOANLSServcies().NumberToString(num,»###,###,##0.00000;-###,###,##0.00000″); |
String | int | Integer.toString(123) |
String | double | Double.toString(123.4e10) |
String | long | Long.toString(123) |
String | float | Float.toString(123.4) |
STRING to DATE | ||
Date | String DATE_FORMAT = «dd-mm-yyyy»;
java.text.SimpleDateFormat sdf = new java.text.SimpleDateFormat(DATE_FORMAT); Date myDate = sdf.parse(“01-10-2010”) |
|
Date | java.sql.Date myDate = pageContext.getOANLSServcies().stringToDate(“01-10-2010”);
oracle.jbo.domain.Date date1 = new Date(myDate); |
OAF: Controller
Oracle Application Framework Controller это простой java класс, являющийся подклассом oracle.apps.fnd.framework.webui.OAControllerImpl.
В контроллере можно определить:
1) реакция на действия пользователя на странице
2) инициализация или изменение свойств элементов страницы (web beans)
Пример java класса контроллера:
Что такое Oracle Application Framework (OAF)
Oracle Application Framework (OA Framework) – служит для разработки и кастомизации HTML страниц Oracle E-Business Suite.
OA Framework основан на стандарте J2EE и использует шаблон проектирования Model–View-Controller (MVC).
Model – отвечает за бизнесс логику, использует Oracle Business Components for Java (BC4J) : AM (Application Module), VO (View Object), EO (Entity Object)
View — отвечает за отображение информации (пользовательский интерфейс).
Controller — интерпретирует данные, введённые пользователем, и информирует модель и представление о необходимости соответствующей реакции. Прочитать больше про контроллер.
Как включить ссылку «Персональная настройка страницы» для web форм
1- Профиль «Personalize Self-Service Defn» значение Y
2- Профиль «FND: Diagnostics» (БОП: диагностика) значение Y
3- Профиль для персонализации регионов (необязательно) «FND: Personalization Region Link Enabled» значение Y
4- Профиль «FND_PERSONALIZATION_SEEDING_MODE» (БОП: режим встраивания индивидуальной настройки) значение Y
5 — Профиль «FND_CUSTOM_OA_DEFINTION»(Настройка веб-определений) значение Y
6- Очистить кеш
Как очистить Application Cache (полномочия Администратор функций)
1- Перейти в полномочия Администратор функций (Functional Administrator)
2- Выбрать закладку «Службы ядра»
3- Кликнуть на ссылке «Система кеширования»
4- Кликнуть на «Глобальная конфигурация»
5- Нажать на кнопку «Очистка всего кэша»
6- В появившемся сообщении нажать «ДА».