OAF_OAF架构MVC系列 - View的概述（概念）
2014-06-18 BaoXinjian
一、摘要
上文介绍在OAF按MVC的架构，分为三层，即Model-View-Contorl, 对OAF 的View层的一下基本概念和一些小案例
- Page - 页面概述
- Page的关键属性
- Item的关键属性
- Reusable Components - 可重用组件
- 控件的继承Extend
- 控件的共享Shared
- Attribute Sets - 控件属性组
- 通过Item的Attribute Set 属性手工设定
- 通过attrSet.setAttributeValue() / getAttributeValue()进行代码自动控制
- URL Parameters - 链接参数
- 一种Simplest Possible Expression Language (SPEL) 语法
- 五种语法结构
{!Attr}
{@Attr}
{$Attr}
{@@RETURN_TO_MENU}
{@@RETURN_TO_PORTAL}
- Style Sheets - 样式表
- Item Type 需设定默认CSS的一些关系，以确认CSS的结构
- Item Type (staticStyledText) -> CSS Class (OraInstructionText)
- Item Type (text entry fields, checkboxes, poplists and radio buttons) -> CSS Class (OraFieldText)
- Item Type (messageStyledText) -> CSS Class (OraInstructionText)
- Item Type 需设定默认CSS的一些关系，以确认CSS的结构
- Model Interaction - View和Model的整合
- View 读Model中的数据
- View 写Model中的数据
二、具体分析
1. Page - 页面概述
一般在创建OAF时，都会创建Page -> Region -Items
1.1 Page 的一些关键属性
- AM Definition:
- 作用： 定义所使用的Root Application Model,
- 例子： oracle.apps.fnd.framework.toolbox.tutorial.server.SearchAM - 页面所使用的是SearchAM，AM中包含了VO， VO关联了SQL和EO，从而限定了该页面所能引用的内容
- Window Title
- 作用： Window窗口的标题
- Title
- 作用： 页面的标题
- Form
- Help Target
- 作用： 页面上显示Help Link链接
- 例子： 设定为true
- AutoFooter
- 作用： 页面下的页脚
- 例子： 设定为True
- PageLayout Components
- 作用： 页面中所有的空间， Page中最为复杂的概念，涉及的控件非常多，另文介绍
1.2 Item 的一些关键属性
- Extends： 是否有所引用的继承类
- Attribute Set： 是否有所引用的属性组
- Destination URI： 超级链接属性，定义参数时，使用的语言为SPEL
- Action Type： 是否存在Action
- Action Type
- Event
- Parameter
- CSS Class： 是否有所引用的样式表
- View instance / View Attribute： 该栏位是否取自数据VO，如果是，定义VO和VO的栏位
- Admin / User Personalization： 是否启用个性化
- Inital Value： 初始值
1.3 SPEL语言
OAF 在定义页面URL中的参数或者在Action中参数时，使用的的是SPEL(Simplest Possible Expression Language)语言
比如Action中Parameter引用页面上一个参数：${oa.ViewInstanceName.ViewAttributeName}
2. Reusable Components - 可重用组件
每个种开发语言都会涉及到某些组件的公用性和继承性，
2.1 公用性：
- Shared Regions
- Shared Pages
- Shared Items
- Shared Logistic
2.2 继承性：
另文介绍
2.3 特殊的例子 - LOV
LOV体现了既有公用性又存在继承性
- 在定义LOV Region时，需将其定义为public
- 在Item引用该LOV，必须Extend该LOV
3. Attribute Sets - 控件属性组
3.1 通过Item的Attribute Set 属性手工设定
Oracle 默认的AttributeSet存放位置： /oracle/apps/fnd/attributesets/
3.2 通过attrSet.setAttributeValue() / getAttributeValue()进行代码自动控制
public void processRequest(OAPageContext pageContext, OAWebBean webBean){
super.processRequest(pageContext, webBean);
AttributeSet attrSet =
new AttributeSet(pageContext, "/oracle/apps/fnd/attributesets/Buttons/Create");
String createPrompt = (String)attrSet.getAttributeValue(pageContext, PROMPT_ATTR);
}
4. URL Parameters - 链接参数
页面在进行超链接传参数时，通URL Parameters进行实现
比如OA.jsp?OAFunc=FWK_TBX_T_PO_PAGE&order={@OrderNum}，在下个页面就可以使用OrderNum参数了
这是一种一种Simplest Possible Expression Language (SPEL) 语法
五种语法结构
- {!Attr}
- {@Attr}
- {$Attr}
- {@@RETURN_TO_MENU}
- {@@RETURN_TO_PORTAL}
5. Style Sheets - 样式表
Item Type 需设定默认CSS的一些关系，以确认CSS的结构， 从而控制控件的显示方式一致性，输入的Item有输入CSS style，显示的item有显示CSS style，其实就是页面和控件的风格
- Item Type (staticStyledText) -> CSS Class (OraInstructionText)
- Item Type (text entry fields, checkboxes, poplists and radio buttons) -> CSS Class (OraFieldText)
- Item Type (messageStyledText) -> CSS Class (OraInstructionText)
6. Model Interaction - View和Model的整合
6.1 View 读Model中的数据
系统在读数据时，其实就是通过读目前的View Object 中RowImp对应的EO的getAttributeName去实现
下图就比较清楚地的进行了展示
6.2 View 写Model中的数据
系统在写数据时，其实就是通过读目前的View Object 中RowImp对应的EO的setAttributeName去实现
下图就比较清楚地的进行了展示
Thanks and Regards
