OAF_架构MVC系列3 - View的概述（概念）

2014-06-18 Created By 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)

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窗口的标题
• TitleForm
  • 作用：　页面的标题
• Help Target
  • 作用： 页面上显示Help Link链接
  • 例子： 设定为true
• AutoFooter
  • 作用：　页面下的页脚
  • 例子：　设定为True
• PageLayout Components
  • 作用：　页面中所有的空间，　Page中最为复杂的概念，涉及的控件非常多，另文介绍

1.2 Item 的一些关键属性

• Extends： 是否有所引用的继承类
• Attribute Set：　是否有所引用的属性组
• Destination URI：　超级链接属性，定义参数时，使用的语言为SPEL
• Action Type：　是否存在ActionCSS Class： 是否有所引用的样式表
  • Action Type
  • Event
  • Parameter
• 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