OAF FlexField中数据库与页面的前后台数据类型转换(一)

OAF FlexField中 数据库与页面的前后台数据类型转换

Oracle Application中有FlexField（弹性域）这个东西。在FlexField tables，数据存放于VARCHAR2类型的一列或多列中。不论是数字、日期、文本等，最终都会以VARCHAR2存放在table中。在OA Page中，这些VARCHAR2一般需要使用相对应的格式，比如日期、数字，以使用相应的验证机制，或者根据不同的地区转换成不同的格式。问题是，怎样在前后台中做数据类型转换呢？一个最简单的办法是使用OAF的FlexField Bean。但在一些情况下，使用FlexField Bean反而会不方便控制。甚或乎，明明跟随了OAF Developer Guide的方法，但总是用不了这个FlexField Bean。这时，只能手工地做这件事情了。

数据类型转换的基本原理很简单：把读写分离，或者说把前后台不同方向的数据流分开处理。

1. 传统情况

所谓传统情况，或者一般情况，就是数据库的列名是有实际意义的、明确的。比如，列名是EFFECTIVE_DATE，EO、VO中的属性名也会使用EffectiveDate。

我们会在VO中定义一个SQL语句。当进行操作时，OAF会把这个SQL语句封装，然后进行读写。比如：

[sql] 
SELECT   ExampleEO.example_id AS EXAMPLE_ID  
       , ExampleEO.effective_date AS EFFECTIVE_DATE  
       , ExampleEO.employee_name AS EMPLOYEE_NAME  
FROM   ExampleEO  
WHERE  ExampleEO.example_id > 10    
当查询example_id = 100的记录，OAF会封装成这样子：
[sql] 
SELECT *  
FROM   (SELECT   ExampleEO.example_id AS EXAMPLE_ID  
               , ExampleEO.effective_date AS EFFECTIVE_DATE  
               , ExampleEO.employee_name AS EMPLOYEE_NAME  
        FROM   ExampleEO  
        WHERE  ExampleEO.example_id > 10) QRSLT  
WHERE  QRSLT.EXAMPLE_ID = 100  

插入的时候也是类似的：
[sql] 
UPDATE (SELECT   ExampleEO.example_id AS EXAMPLE_ID  
               , ExampleEO.effective_date AS EFFECTIVE_DATE  
               , ExampleEO.employee_name AS EMPLOYEE_NAME  
        FROM   ExampleEO  
        WHERE  ExampleEO.example_id > 10) QRSLT  
SET      QRSLT.EFFECTIVE_DATE =           -- OK  
       , QRSLT.EMPLOYEE_NAME =             -- OK  
WHERE  QRSLT.EXAMPLE_ID = 100  

总的来说，是将VO中的SQL语句封装成表格，然后外面包裹相应的操作。

2. FlexField的问题

而在FlexField的情况，列名是没有实际意义，或者说不明确的。FlexField存放数据的列名一般是ORG_INFORMATION1、PER_INFORMATION5之类。在VO中，这些名字可能会被替换为实际的用途，比如说ORG_INFORMATION1可能是一个Effective Date，那么在VO中的属性就会被命名为EffectiveDate。这个的mapping是在VO properties中设置的。

为了简化列名，本文把ORG_INFORMATION1、PER_ATTRIBUTE1等统称为information1。于是，在一个FlexField表格，VO的语句会是这个样子：

[sql] 
SELECT   ExampleEO.example_id AS EXAMPLE_ID  
       , ExampleEO.information1 AS EFFECTIVE_DATE  
       , ExampleEO.information2 AS EMPLOYEE_NAME  
FROM   ExampleEO  
WHERE  ExampleEO.example_id > 10    
查询example_id = 100的记录，会生成以下的语句：
[sql] 
SELECT *  
FROM   (SELECT   ExampleEO.example_id AS EXAMPLE_ID  
               , ExampleEO.information1 AS EFFECTIVE_DATE       -- information1 is a VARCHAR2  
               , ExampleEO.information2 AS EMPLOYEE_NAME  
        FROM   ExampleEO  
        WHERE  ExampleEO.example_id > 10) QRSLT  
WHERE  QRSLT.EXAMPLE_ID = 100  

查询语句本身没有问题。但是在OA Page中，显示日期的item所属的类型一般会设成DATE，而上面的SQL语句查询结果的类型是VARCHAR2。于是，VO与PG上的的属性类型不管如何设置，都会在页面上方报错。此乃问题一。

当进行插入操作，OAF会生成以下的SQL语句：

[sql] 
UPDATE (SELECT   ExampleEO.example_id AS EXAMPLE_ID  
               , ExampleEO.information1 AS EFFECTIVE_DATE     -- VARCHAR2  
               , ExampleEO.information2 AS EMPLOYEE_NAME  
        FROM   ExampleEO  
        WHERE  ExampleEO.example_id > 10) QRSLT  
SET      QRSLT.EFFECTIVE_DATE =               -- Error  
       , QRSLT.EMPLOYEE_NAME  =                -- OK  
WHERE  QRSLT.EMPLOYEE_ID = 100  

在FlexField table中，information的类型是VARCHAR2，而effective_date的类型是DATE。类型的不匹配，就会引起错误，转到异常页。此乃问题二。

3. 从数据库到页面 (Table -> Page，从后台到前台）

为了解决这个问题，我们可以为每个在OA Page上非字符类型的属性，在VO中定义一个相应类型的transient属性。以transient属性作为中间媒介，在不同的地方调用转换函数，从而在前后台进行数据类型转换。

对于上面的例子，我们可以在VO中定义一个名为DispEffectiveDate的属性。这个属性数据类型设为DATE，Updatable设为always。由于这个属性没有映射到表格中的列，所以这也是一个Transient的属性。数据类型转换，则是在属性calculation的那一项，调用数据库的PL/SQL过程，进行从VARCHAR2到DATE的转换。最终，在VO的SQL中生成了以下的SQL语句（也可以使用Expert Mode进行