Oracle EBS OA Framework

Oracle EBS OA Framework (一) 开发环境搭建关键字: Oracle EBS ERP OA Framework OAF最近公司开始了一个Oracle ERP二次开发项目，使用的是EBS R12版本，这个版本由于比较新，从这个版本中可以看到Oracle ERP二次开发的主要技术有向Web方面发展的趋势，其中主要使用的就是Oracle OA Framework应用框架。

网上这些资料不好找，我通过查看OA Framework Guide整理了一些文档，后面陆续会发布到blog 中与大家共享。

内容基本上是按我的学习顺序组织的，学到哪里写到哪里，由于是初学OA Framework，而它又与我们通常接触的开源框架差异较大，因此理解上难免出现偏差，有不正确的地方请大家指正。

由于系统的限制，不能发过多的插图，文章中的插图没有全部贴上来，这些插图都来自于OA Framework Guide。

环境塔建按以下几个步骤：1.从MetaLink上下载p5856648_R12_GENERIC.zip2.从你的EBS服务器上下载dbc文件，比如我的dbc位置/u02/prod/inst/apps/PROD_ebs/appl/fnd/12.0.0/secure/PROD.dbc3.启动JDeveloper，从JDeveloper解压目录中找到ToolBox工程，初次打开时会提示代码更新。

4.在工程的属性中找到Oracle Applications配置好Database Connection。

5.在工程的属性中找到Oracle Applications -> Runtime Connection页，将DBC File Name设置为从服务器上下载的dbc文件。

User Name和Password为登录ebs环境时使用的用户名和密码。

Responsibility中设置好开发所使用的应用简称和职责。

这个职责只需要是User Name所具有的职责就可以了。

Page基础在浏览器看来，OA Framework页面与其它web页面一样，被渲染为HTML。

在中间层中，页面是由内存中层级分布的Javabeans组成——非常像传统的Java客户端UI。

每个UI构件，比如按钮、表格、tab、商标图像等，被渲染为页面中对应的构件。

浏览器向一个页面发出请求时，OA Framework读取页面定义的元数据创建web bean结构。

每个bean 与一个UI控制器关联，OA Framework调用你编写的代码初始化页面。

页面处理完成后，OA Framework 将web bean结构交给UIX框架处理以生成发送给浏览器的HTML。

当浏览器发出一个表单提请求时，OA Framework重新创建bean及其层次结构（只在必要的时候才重新创建，通常这些bean是被缓存的，只在特定的情况下才重新创建），然后调用为 page bean编写的事件处理代码。

当页面处理完成后，页面HTML重新生成并发送给浏览器。

OA Framework MVC架构：模型Model模型包括下层的数据和应用业务逻辑。

它也提花了现实世界对象和应用服务间的抽像层。

应用模块Application ModulesBC4j应用模块本质上是一个容器，它管理和提供对“相关“BC4J模型对象的访问。

这里的“相关”指的是同一个任务中的参与者。

比如所有的BC4J对象在同一个任务中参与同一个事务——即使对应的用户界面需要用户访问多个页面。

应用模块：应用模块是oracle.apps.fnd.framework.server.OAApplicationModuleImpl类的子类。

每个OAFramework 页都有一个根（root）应用模块，它与最顶层的页面区域（page region）关联。

根应用模块提供事务环境和连接数据库。

∙如果多个页面参与同一个物理或虚拟事务，它们应该共享相同的根应用模块。

∙如果一个页面功能不依赖于其它东西，它需要拥有自己的应用模块。

注意：一个根应用模块可能包含一个或多个嵌套的应用模块，可以嵌套任意多的层次。

这种情况下，根应用模块可以访问它包含的子对象的数据和对象，所有子对象共享根应用模块的事务。

你可以在创建需要重用的与数据库操作相关的UI区域时使用这个功能。

实体对象（Entity Objects）和关联对象（Association Objects）BC4J实体对象包含了业务规则（校验、动作等）与数据库表中的一行关联。

注意：实体也可以基于视图、同义词、快照而定义。

OA Framework支持Java和PL/SQL实体。

实体对象：多数实体是oracle.aps.fnd.framework.server.OAEntityImpl的子类（PL/SQL继承于特殊版本的OAEntityImpl）。

表和实体对象一一对象，所有实体应该包含与之关联的表的所有列。

实体对象使用映射了它的属性和数据库列，并自动实现了查询、插入、更新、删除等操作。

多数情况下，我们只需要添加校验逻辑。

实体对象可以用于任何程序（不限于OA Framework）。

关联对象Association Objects用于定义实体间的关系。

视图对象（View Objects）和视图链接（View Links）BC4J视图对象处理数据库查询。

查询执行后，视图对象提供了访问它的结果集的功能。

结果集包含了一个或多个视图行，视图行与数据库查询的行相对应。

视图对象：所有的视图对象都是oracle.apps.fnd.framework.server.OAViewObjectImpl类的子类。

视图对象可以配置为使用下面的策略查询数据：∙它的属性映射到简单的SQL语句的列（通常用于小的只读的视图对象）∙它的属性映射到实体对象的属性（用于插入、更新和删除实体）∙一些属性映射到实体对象，一些直接映射到SQL（用于增加实体临时数据，这些数据不能通过实体获得，比如计算值或用于UI显示需要）在OA Framework应用中，将在下面情况下使用视图对象：∙呈现用于优化用户界面细节的数据。

如果用户界面支持实体的插入、更新、删除，你将通过视图对象执行这些操作。

∙为poplists、lists of values和其它UI组件创建简单的查询。

∙为业务逻辑创建有效的“校验查询（validation queries）”。

比如，在定单处理时使用一个校验视图对象获得最大可以购买的商品数量。

可以为视图对象编写代码用于实现复合查询或查询时的数据绑定（以便视图对象知道怎样“查询”自己）。

视图链接View Links与实体对象类似，也可以为视图对象建立关联，称为视图链接（view links）。

比如可以在定单头视图对象和定单内容间建立视图链接对象。

这可以用于在运行时访问定单头时自动查询定单内容。

OADBTransactionOADBTransaction：注意：准备的来说这个图应该要包含实现类oracle.apps.fnd.framework.server.OADBTransactionImpl替代oracle.apps.fnd.framework.OADBTransaction接口。

如图所示，OADBTransaction扮演的是模型中的中心角色，因为它与一个根应用模块关联，管理JDBC 连接/数据库会话，直接拥有你创建的任何实体（根应用模块拥有的视图对象中的行指向实体对象）。

可以使用OADBTransaction在模型代码中完成下面的操作：∙创建一个语句执行PL/SQL函数和存储过程∙访问应用会话级环境信息（session-level Application context information），比如：用户名、id、当前责任（resposibility）等。

∙访问一个oracle.apps.fnd.framework.OANLSServices对象，如果你需要执行NLS操作，比如转换服务器时间到用户日期/时间等。

可以通过根应用模块访问OADBTransaction。

视图视图格式化当前模型数据给用户。

定义页面在Oracle Applications开发时，将使用XML页面定义文件。

当产品发布后，OA Framework从数据库获取页面定义。

使用JDeveloper定义的页面（pages）由区域（regions）和条目（items）组成。

∙条目是简单的构件，比如按钮、输入域、图像等，它不包含子构件。

∙区域是容器对象它可以包含条目和其它区域。

比如区域包含文件头（headers）、表格和特别的布局组件（layout components）。

∙定义的每个区域和条目都有style属性，它告诉OA Framework使用哪个web bean对象来描述它。

比如，如果你定义区域的style属性为“table”，OA Framework将使用oracle.apps.fnd.framework.webui.beans.table.OATableBean。

∙所有页面必须有一个单一的top-level region（通常称为“root region”）它的style为pageLayout。

它将使用yout.OAPageLayoutBean。

∙regions和items显示在JDeveloper page tree中的顺序告诉了Framework将这些对象添加在什么位置。

属性集Attribute Sets每个region或item通过使用attribute sets可以继承一组属性集合。

attribute sets是一个被命名的属性的集合，可重用于任何UI对象，包括：regions，items和其它属性集。

当使用attributes set创建UI时，你可以覆盖所继承的属性。

组件重用如果需要在页面使用共同对象，可以简单的从它继承。

比如，可以创建一个通用的region。

新建region时，将新region的Extends属性设置为通用region 的命名。

注意：共享的通用region在引用它的page中是不可编辑的，属于它的选项目在JDeveloper中将显示为灰色。

数据源绑定对于需要与数据库交互的bean，你需要指定数据源，将它绑定到View Instance Name，并关联好View Attribute Name。

这个绑定是至关重要的，因为OA Framework使用它获取数据，并将用户输入的数据写入下面的视图对象。

∙View Instance Name指向当前上下文环境中包含应用模块中的视图对象（所有视图对象“生活“于一个应用模块中，在包含它的容器对象中有一个实例变量名）。

比如，如果SuppliersVO视图对象，在页面的根应用模块中有一个实例变量“MySupVO”。