JDev ver. 11.1.1.2.0
Maven 2.2.1

（本文所述不是严格意义上的maven在Oracle ADF应用开发中的使用，仅尝试使用maven作为ADF开发的每日编译工具。）

JDeveloper 11.1.1.2.0以插件的形式为JDeveloper 11g带来了maven的支持。这种支持在11.1.1.2.0中仅限于对常规开发的maven支持，而对于如何为ADF应用添加maven的支持以解决 诸如ADF应用对于Library的依赖、ADF应用打包为ADF Library Jar File、ADF应用之间的依赖等问题并未提出解决方案。Oracle官方表示在11.1.1.2.0中maven尚属于技术预览，尚未完成。

在 某特定ADF应用中，将ADF应用分为主应用、模块、功能，主应用为不包含BC的ADF应用，用于解决登录、Session管理等内容；应用分为模块进行 开发，如系统管理模块，每个模块具体分为功能进行开发，如用户管理、组管理等。进行应用构建时，将每个功能打包为ADF Library Jar File，将同一模块的所有功能jar包合并为该模块的ADF Library Jar File，再以jar library的形式将该ADF Library Jar File加入主应用，最后将主应用打包为EAR进行部署。出于每日构建的需要及考虑到未来可能的模块间依赖，希望引入maven以解决该问题。

解决问题的基本思路如下：
首先依照maven的设计思想，设置构建结构如下：

如此则每次构建父项目，将自动按序构建功能项目 -> 模块项目 -> 主项目。具体应用中一个主项目依赖于数个模块项目，一个模块项目依赖于数个功能项目。
该结构下功能项目均将具体ADF项目打包为ADF Library Jar File，模块项目将该模块所依赖的所有功能项目打包为一个Jar，而主项目构建时将所有打包的模块项目引入并最终打包为EAR。

由 于不了解ADF Library Jar File/ADF EAR打包的具体内容，故使用Oracle官方提供的命令行打包工具ojdeploy进行ADF Library Jar File及EAR的打包，使用另外开发的Jar合并程序进行ADF Library Jar File的合并。故需要开发Maven插件如下：

1. 用于调用 ojdeploy 的 maven-adfdeploy-plugin。
2. 用于将 ADF Library Jar File 合并的 maven-jarmerger-plugin。

结 合Maven进行项目管理的构建生命周期，由于本次只使用其作为每日构建工具，则只需实现package阶段即可，考虑到未来解决依赖的需要，亦实现 install及deploy阶段，分别用于将maven项目部署至本地repository及远程repository。

maven-adfdeploy-plugin
maven-jarmerger-plugin
jarmerger（maven-jarmerger-plugin依赖于此）

使用实例：

1. 首先将插件安装至本地repository，按照jarmerger -> maven-jarmerger-plugin -> maven-adfdeploy-plugin的顺序进行安装，进入每个目录运行mvn install即可。
2. 构建父maven项目pom.xml文件，按照前述图示结构将模块项目、功能项目均作为父maven项目的模块，并指定使用1.6版本JDK进行编译。
3. 构建功能项目pom.xml文 件，设定父项目为第2步所创间的项目，设定打包类型为adfdpl.jar，并应用maven-adfdeploy-plugin插件，由于调用 ojdeploy进行编译打包，故需要使用JDeveloper在ADF应用中设定好对应的Deploy Profile，并以据文件中注释所示进行配置。
4. 构建模块项目pom.xml文件，设定父项目为第2步所创间的项目，设定打包类型为hadfmerge.jar，并应用maven-jarmerger-plugin插件，设置针对第3步创建的功能项目的依赖，并依据文件中注释进行配置。
5. 构建主项目对应的pom.xml文件，同样调用ojdeploy进行实现，设置方式类似于步骤3。

设置成功后，只需在父maven项目的pom.xml所在文件夹运行mvn package即可完成项目打包。结合Hudson等持续集成工具及SVN，即可完成每日构建的任务。

已知的问题：

• 由于调用ojdeploy进行编译及打包，则这种思路下不可能解决项目编译时自动寻找/解决依赖的问题，仍需要手工调整每日构建所用的构建源码所引入的包/库。
• 插件没有实现构建生命周期中的unit test及report阶段，仍需完善。

今天项目的服务器崩了，服务器的风扇不转了，前一阵子只是用服务器的数据库，读写量也小，没发现这个问题。今天更新服务器的Weblogic，估计是 CPU占用量高导致发热后计算错误，磁盘读写错误，先是整个RedHat Read-only file system，后来直接罢半夜凉初透工了，重启出现mount: error 2 ......

---------------------------------------------------------------------
以上是题外话，无奈把数据库备份导入本机XE数据库进行开发，imp时出现错误
[code=sql]

IMP-00017: following statement failed with ORACLE error 604:
"DECLARE  SREC DBMS_STATS.STATREC; BEGIN SREC.MINVAL := 'C3020416'; SREC.MAX"
"VAL := 'C3020416'; SREC.EAVS := 0; SREC.CHVALS := NULL; SREC.NOVALS := DBMS"
"_STATS.NUMARRAY(10321,10321); SREC.BKVALS := DBMS_STATS.NUMARRAY(0,1); SREC"
".EPC := 2; DBMS_STATS.SET_COLUMN_STATS(NULL,'"AFWK_FUNCTIONS"','"FUNCTION_I"
"D"', NULL ,NULL,NULL,1,1,0,srec,5,6); END;"
IMP-00003: ORACLE error 604 encountered
ORA-00604: error occurred at recursive SQL level 1
ORA-01653: unable to extend table SYS.HIST_HEAD$ by 8 in tablespace SYSTEM
ORA-06512: at "SYS.DBMS_STATS", line 4858
ORA-06512: at "SYS.DBMS_STATS", line 5081
ORA-06512: at line 1
[/code]
看来问题集中在ORA-01653上，貌似SYSTEM的表空间不足导致。

通过如下语句查询表空间
[code=sql]

SELECT T.TABLESPACE_NAME,
D.FILE_NAME,
D.AUTOEXTENSIBLE,
D.BYTES,
D.MAXBYTES,
D.STATUS
FROM DBA_TABLESPACES T, DBA_DATA_FILES D
WHERE T.TABLESPACE_NAME = D.TABLESPACE_NAME
ORDER BY TABLESPACE_NAME, FILE_NAME;
[/code]
发现各表空间的自增均正常，但SYSTEM这一表空间的BYTES = MAXBYTES，已经不能自增了。

修改SYSTEM的表空间最大值
[code=sql]

alter database datafile '/usr/lib/oracle/xe/oradata/XE/sysaux.dbf' AUTOEXTEND ON NEXT 100M MAXSIZE UNLIMITED;
[/code]
修改后结果如下

问题解决。

ADF应用的客制化包含两个方面，一方面是允许在运行时，由最终用户对应用进行客制化，如针对用户调整表格的显示状态、查询面板的默认查询、 PanelBox的展开状态等，即Personialization；另一方面是允许针对已开发完成的应用进行定制，如修改页面模板、修改页面字段显示 值、修改页面跳转逻辑等，即Customization。这些客制化内容均不会对已开发完成的应用作出修改，而是存储在MDS中。本文主要介绍如何为 ADF应用启用Personialization。

JDeveloper Ver. 11.1.1.2.0
DB Ver. 10g(XE), Schema HR

启用Personialization步骤：

1. 使用默认角色进入JDeveloper
2. 设 置应用中ViewController项目的属性，在"ADF View"下勾选"Enable User Customizations"，"Enable Seeded Customizations"，并选择"Across Session using MDS"以使客户化可以保存下来。
   
3. 在 Appliaction Navigator 的 Application Resources 中，修改adf-config.xml
   

   在 MDS Configuration 中增加 Customization Classes UserCC，包路径为oracle.adf.share.config.UserCC，以允许针对用户的客制化。

   

   在 View 中，确认 Tag Library URI 为 http://xmlns.oracle.com/adf/faces/rich，这里是用于配置哪一组标签及其属性将被存储至MDS，这里声明为ADF Rich Components。
   而 Tags 中则可新增允许进行客制化的标签类型及属性。这里增加几种常用标签

   
4. 设定页面元素是否允许客制化修改
   为 应用完成上述3步骤的配置后，将为整个应用中adf-config.xml中指定的类型控件及属性启用客户化支持。但在实际使用中往往会遇到应用中不同页 面同种控件部分需要客制化，部分不允许客制化的情况。则需对页面控件设置 persist 及 dontpersist 属性。
   需要注意的两点：
   • persist 及 dontpersist 属性只对于将客制化信息存入MDS的情况有效。
   • 在任何情况下如果客制化信息保存至MDS失败，则仅将客制化信息保存在当前Session中。
   • 控件默认将所有客制化信息保存至MDS，可以点击persist/dontpersist的edit进行可用属性的编辑。
   • dontpersist的优先级高于persist，即当同一属性被设置入persist及dontpersist，则该属性的客制化信息不会保存入MDS。

至此完成应用的客制化定义部分。

由于本示例为针对用户的客制化定义，因此接下来需要定义应用的安全验证及用户，至少定义两个用户用于验证客制化的定义。

1. 进 入 "Configure ADF Security" (Application -> Secure -> Configure ADF Security)，在Step1中选择 "ADF Authentication and Authorization"。
   
2. Step2，确认需要应用验证的Web项目，选择HTTP Basic Authentication。这里HTTP Basic Authentication即为最常用的Web验证方式，使用浏览器的弹出窗口进行验证。
   
3. Step3，确认选择为 "No Automatic Grants"，点击下一步
   
4. Step4，确认没有勾选 "Redirect Upon Successful Authentication" ，并点击Finish完成定义。
   
5. 进行jazn-data.xml的配置，Application -> Secure -> Application Roles，增加Role，此示例使用DjTestRole
   
6. 点击Users，增加两个用户名为user1，user2，密码分别为password1，password2。
   
7. 点击Application Roles，为第五步创建的组增加成员user1及user2
   
8. 点击左下角ADF Policies，将需要访问的页面/taskflow授权给之前创建的Role，并确认勾选Customize, Grant, Personalize
   

至 此完成应用的配置，运行应用，分别以user1/user2登录，对于表格列的操作，则对于已经定义允许客户化的控件的状态修改将依用户区分保存至 MDS。如使用user1登录后修改表格显示的列及列宽，则user1下一次登录将看到本次的修改结果；而user2看到的表格显示状态不随user1的 修改而改变。

附注：
对于启用基于MDS的客制化支持后QueryPanel不能保存自定义查询，报出异常
[code=java]
oracle.mds.exception.ReadOnlyStoreException: MDS-01273: 未能对资源 /persdef/dj/demo/model/queries/EmployeesVO.xml 执行操作, 因为映射到名称空间 / BASE DEFAULT 的源元数据存储为只读。
[/code]
的问题，Oracle官方在JDeveloper 11.1.1.1.0 的 Release Note 中有提到，需要在应用的adf-config.xml中配置如下内容

[code=java]
<persistence-config>
<metadata-namespaces>
<namespace path="/persdef" metadata-store-usage="MAR_TargetRepos"/>
</metadata-namespaces>
<metadata-store-usages>
<metadata-store-usage id="MAR_TargetRepos" deploy-target="true"
default-cust-store="true"></metadata-store-usage>
</metadata-store-usages>
</persistence-config>
[/code]
则关于查询面板的客制化信息将存储在MDS目录下的/persdef目录中。详见ADF Customization part 1: The MDS。

Demo下载

星期天在家通过VPN去公司加班，发现VPN后连接公司内服务器正常，但连接其他网站不能。

初步判断为路由问题，首先尝试VPN连接配置中的“忽略自动获取的路由”，后添加公司服务器访问的路由信息。尝试无效。
执行ifconfig -a，看到VPN建立了一dev为ppp0的连接

后执行route查看路由表如下

对 比VPN未连接时的路由表信息可知，该VPN插入一条目标为10.213.0.10的路由记录，并将default路由改为网关*，接口ppp0。按照路 由表规则，、自上向下的方式进行路由匹配，则所有发往外网的请求均会路由至ppp0，而ppp0的VPN只支持公司内网访问，故造成不能访问外网的问题。
修改路由表如下
[code=bash]
sudo route del default #删除默认路由
sudo route del 10.213.0.10 #删除VPN创建的路由，该路由没有效果
sudo route add default gw 192.168.1.1 #重设默认路由，使用网关192.168.1.1，这是我家里的路由器网关
sudo route add -net 10.213.252.0 netmask 255.255.255.0 dev ppp0 #添加一条路由用于访问公司服务器所在网段
[/code]
最终修改结果如下

为了方便使用，将路由修改命令写为脚本以供使用。

在开发中经常遇到的一种情况是需要将Table中某列的两种状态，如Y/N在界面上表现为checkbox的形式。ADF中checkbox默认返回true/false，不符合数据表中存储数据的要求。故需要对true/false进行转换。这里有两种方式完成转换。

1. 在ViewController端页面的PageDef.xml文件中添加对应字段的绑定
   

   类型为Button，选择对应的AM，VO，字段名称，如果该字段具有LOV，不需要选择对应LOV而保留None即可。在Selected State Value中填写勾选时需要的值，Unselected State Value中选择飞勾选状态时的值

   

   后将界面控件通过el表达式关联至该绑定即可。通常将属性由Application Navigator中拖动入界面时会自动完成该绑定添加的过程。

2. 遵 循MVC的原则，修改VO对应字段的get/set方法，将ViewController返回的true/false转换为需要的字符。具体做法为在对应 VO属性中的Java页生成Java文件，只需勾选Generate View Row Class并勾选Include accessors，后再修改生成的Java文件中对应字段的get/set方法即可。
   

情 况在RichTable等Collection Component中有所不同。不同于界面上其他控件的属性绑定方式，ADF RichTable等Collection Component通常绑定文件中为tree类型，而控件则使用el表达式访问该tree的collectionModel或treeModel

而Richtable中的列则通过row.bindings.XXX.inputValue的方式来访问该tree中的每一行值

而在页面的PageDef.xml文件中添加tree类型的绑定时，只可以选择绑定到的VO列名称，而没有属性可以设置将该列的值映射为checkbox的true/false。

JDeveloper Ver. 11.1.1.2.0
DB Ver. Oracle 10g EE

BUG发生条件
1. 页面为jsff
2. 页面使用RichTable，绑定某VO，且该VO中某列具有LOV，该LOV以Choice List（下拉列表）的形式展现
3. 页面有Command Button/Link绑定VO的CreateInsert方法，且其Disabled属性绑定为#{!bindings.CreateInsert.enabled}
4. 页面有Command Button/Link绑定VO所在AM的Rollback方法

BUG现象
在页面点击Rollback，发现RichTable中下拉列表内的值消失，且无可选择项。刷新后可选项重新出现。

BUG原因
CreateInsert button的Disabled属性绑定。将其置为Default即可解决。

程序示例，使用Oracle示例HR数据库中Employees表。

ADF查询面板提供了快速创建查询的功能，本文主题为在ADF查询面板中使用关联LOV，即B LOV的结果依赖于A LOV的选择值，A LOV选择值变动时自动清空B LOV中的值。

示例使用Oracle HR数据库中的Employees, Locations, Departments三张数据表，Departments外键关联至Locations数据表，Employees数据表外键关联于Locations数据表。

使用2009年11月11日发布的Oracle JDeveloper 11.1.1.2.0作为开发环境，经实践其前一版本11.1.1.1.0在查询面板选择时清空LOV存在BUG。

首先从数据库反向创建相关EO、VO

修改DepartmentsView，在Query标签页为其创建Bind Variable，名称为locationId，类型为String。注意将其属性中的Display Hints设为Hide

并修改相应SQL语句，添加where条件如下
WHERE Departments.LOCATION_ID=nvl(:locationId, Departments.LOCATION_ID)

修改EmployeesView，在Query标签页修改SQL语句如下
SELECT Employees.EMPLOYEE_ID,
Employees.FIRST_NAME,
Employees.LAST_NAME,
Employees.EMAIL,
Employees.PHONE_NUMBER,
Employees.HIRE_DATE,
Employees.JOB_ID,
Employees.SALARY,
Employees.COMMISSION_PCT,
Employees.MANAGER_ID,
Employees.DEPARTMENT_ID,
Locations.LOCATION_ID
FROM EMPLOYEES Employees,
DEPARTMENTS Departments,
LOCATIONS Locations
WHERE Employees.DEPARTMENT_ID = Departments.DEPARTMENT_ID
AND Departments.LOCATION_ID = Locations.LOCATION_ID

在ViewAccessors页面添加ViewAccessor，分别指向DepartmentsView及LocationsView。

修改DepartmentsView1，将其绑定变量的Value设定为LocationId（这里的LocationId即为上一步修改SQL后EmployeesView中新添加的Attribute名称）。

在Attributes标签页为DepartmentId及LocationId分别添加LOV。
为 DepartmentId添加LOV，设定DataSource为上一步创建的ViewAccessor DepartmentsView1，Attribute为DepartmentId，并添加返回值为DepartmentId，修改UI Hints标签页中的Default List Type为Input Text With List of Values

同样为LocationId添加LOV，设定DataSource为上一步创建的ViewAccessor LocationsView1，Attribute为LocationId，并添加返回值为LocationId，修改UI Hints标签页中的Default List Type为Input Text With List of Values。

在Attribute标签页为DepartmentId设置属性，在其Dependencise中选择LocationId

最后，创建页面，将Data Controls中EmployeesView的All Queriable Attributes拖入界面，选择Query -> ADF Query Panel with Table。执行测试。

JDeveloper 11.1.1.2.0
Oracle 10g (hr schema)

某应用开发中碰到需要根据行状态决定页面元素的显示状态的要求。具体要求如下：

存在页面page1与page2，数据表table1与table2，table1与table2为Master-Detail关系，使用taskflow控制页面跳转。
page1选择新建按钮跳转到page2，此时page2页面指定按钮refresh按钮不允许点击。当用户在page2完成对table1的创建/修改 操作并保存后，页面refresh按钮允许点击；当用户从page1通过修改按钮跳转至page2后，若不对table1的记录进行修改，则 refresh按钮允许点击，否则refresh按钮不允许点击。

按照通常做法，需配置taskflow级别变量用于记录table1中某行状态，在页面跳转及记录值变动时修改该行状态，并根据该行状态变量决定refresh按钮的可用性。这种做法的缺点在于需要定义变量，并在多处操作时对该变量值进行维护。

故直接取EntityObject行状态作为标志位进行判断。下例以hr schema中regions及countries作为示例。
分别创建View页面和Update页面，View页面放置regions表，并允许进行新增和修改的操作。
若通过新增按钮跳转至Update页面，或通过修改跳转至Update页面并对region信息作出修改，则refresh按钮不允许点击，否则refresh按钮允许点击，通过判断当前regions EntityObject的状态完成。

EntityObject在生命周期中具有五种状态

• STATUS_UNMODIFIED - Entity Object源于数据库，且没有被修改过，或者修改已经被提交至数据库。
• STATUS_MODIFIED - Entity Object源于数据库，当前已经被修改且在当前事务中修改没有提交至数据库。
• STATUS_NEW - Entity Object为当前事务中新建的。
• STATUS_DELETED - Entity Object在当前事务中被删除。
• STATUS_DEAD - Entity Object为当前事务中新建的，且没有提交至数据库即被删除。

而各状态对应static值现下表

故只需修改Update页面的refresh按钮Disabled属性，通过EL表达式进行行状态判断，进而返回true/false即可。

ADF 中ViewController通过EL表达式绑定取得Model中属性的值，当前IDE只提供了很少数的语法提示，那么根据Java命名规则，在 Model层通过getAbc()取得的值，在ViewController中该Abc作为对象abc存在，则可通过EL表达式# {bindings.XXX.abc}取得Model层XXX.getAbc()取得的值。

故通过查阅Fusion Middleware API，可知EL表达式应写作
#{bindings.RegionsView1Iterator.currentRow.entities['0'].entityState == '1' ? false : true}

示例下载