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. |
Похожие записи:
Categories: OA Framework, Oracle e-Business Suite Guidelines, OAF, OEBS, правила, разработка, советы
Последние комментарии