首页 > 代码库 > OAF_OAF架构MVC系列 - View的概述(概念)

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)
  • 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