Oracle Seeker, Oracle探索者

Oracle EBS 12.0.0

OAF中多语言转换开发实现步骤 一文介绍了OAF多语言转换开发的步骤。

但也产生了如下的疑问：

1. 程序怎么知道需要不需要进行多语言转换？
2. 页面中也没有TL表相关的视图对象，它的多语言数据又怎么进去？
3. 在OAF开发中，需要往数据库插入数据，都是通过EO的操作来实现，但是按照开发手册，我们是基于VL视图来创建EO，复合式视图又无法插入数据，这是怎么回事？
4. 而多语言转换的基表根本就没有定义EO，它是什么时候插入数据的？

带着上面的疑问，我们来看看实体对象的实现类OAEntityImpl是如何来实现多语言转换功能的

一、首先来看看EO的create方法

1
2
3
4
5
6
7
8

public void create(AttributeList paramAttributeList)
  {
    super.create(paramAttributeList);
    createRowWho();
    createObjectVersionNumber();
    if (isTranslatable())
      createTranslated(paramAttributeList);
  }

其中isTranslatable()来判读是否需要多语言的转化，如果需要就调用createTranslated()方法，否则就按照默认的创建方式调用父类的create方法

isTrnaslattable()方法最终是通过getBaseTableName()方法来判断是否需要实现多语言转换：

1
2
3
4

private String getBaseTableName()
{
  return ((String)getEntityDef().getProperty("OA_BASE_TABLE"));
}

getBaseTableName()方法取得实体对象的自定义实体属性OA_BASE_TABLE，这个属性就是开发时定义在VL视图的实体对象上面的，所以只要设置了这个属性，就会被认为需要进行多语言的转换

上面回答了我的第一个疑问：程序如何知道多语言转换

二、看看专门为多语言转换所设计的createTranslated()方法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

private RowIterator createTranslated(AttributeList paramAttributeList)
{
  RowIterator localRowIterator = getTLEOIterator();
  String str = getOADBTransaction().getCurrentLanguage();
  String[] arrayOfString2 = getInstalledLanguages();
  int j = getTLLanguageAttributeIndex();
  int k = getTLSourceLangAttributeIndex();
  for (int l = 0; l < arrayOfString2.length; ++l)
  {
    RowImpl localRowImpl = (RowImpl)localRowIterator.createRow();
    localRowImpl.setAttribute(j, arrayOfString2[l]);
    localRowImpl.setAttribute(k, str);
    localRowIterator.insertRow(localRowImpl);
  }
  return localRowIterator;
}

getTLEOIterator()方法则是返回TL对应的EO行集实例，看到代码中的一个for循环，循环是基于目前已安装的语言进行的，因此当往VL视图实体对象中插入数据的时候，就会按照已安装的语言往TL表中插入记录

这里回答了：如何插入TL表的数据，而且还了解了为什么一次可以将所有语言环境的信息都插入到TL表中。

另外关于如何找到VL实体对象对应的TL实体对象就留个读者自己去完成吧(OATranslatedEntityStaticInfo类中)

但是这里并没有看到数据往多语言基表插入的程序，让我们继续浏览代码。

三、查看生成DML语句的buildDMLStatement方法

1
2
3
4
5
6
7
8
9
10
11

protected StringBuffer buildDMLStatement(int paramInt, AttributeDefImpl[] paramArrayOfAttributeDefImpl1, AttributeDefImpl[] paramArrayOfAttributeDefImpl2, AttributeDefImpl[] paramArrayOfAttributeDefImpl3, boolean paramBoolean)
{
  if (!(isTranslatable()))
    return super.buildDMLStatement(paramInt, paramArrayOfAttributeDefImpl1, paramArrayOfAttributeDefImpl2, paramArrayOfAttributeDefImpl3, paramBoolean);
  StringBuffer localStringBuffer = super.buildDMLStatement(paramInt, trimXlatAttributes(paramArrayOfAttributeDefImpl1), trimXlatAttributes(paramArrayOfAttributeDefImpl2), trimXlatAttributes(paramArrayOfAttributeDefImpl3), paramBoolean);
  if (localStringBuffer == null)
    return null;
  String str = localStringBuffer.toString();
  str = OACommonUtils.replace(str, getEntityDef().getSource(), getBaseTableName());
  return new StringBuffer(str);
}

其中最关键的一句是OACommonUtils.replace(str, getEntityDef().getSource(), getBaseTableName()); ，这个语句将本来是VL视图的名字getEntityDef().getSource()替换为多语言基表的名字getBaseTableName()，

这样看似是往VL实体对象中插入数据，而实际上已经被偷梁换柱了。它根本就不会往VL视图对象上面进行DML操作。

这样一来我们首先提出的3，4疑问都已经得到回答：为什么可以操作视图和TL的多语言基表的数据是怎么被插入的？

但是细心的人会发现新的问题了。上面的buildDMLStatement方法中，难道仅仅将DML语句中的表对象更换了就可以了吗？

答案是否定的，因为VL的数据库列和多语言基表是不一样的，基于VL实体对象中的列属性比基表多了多语言的那些字段。

四、查看多语言属性剔除方法trimXlatAttributes

从代码中注意到buildDMLStatement方法调用了trimXlatAttributes()方法来处理了传入的参数，让我们看看trimXlatAttributes()方法的实现

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

private AttributeDefImpl[] trimXlatAttributes(AttributeDefImpl[] paramArrayOfAttributeDefImpl)
{
  if (paramArrayOfAttributeDefImpl == null)
    return null;
  int i = 0;
  for (int j = 0; j < paramArrayOfAttributeDefImpl.length; ++j)
    if (!(isTranslatableAttribute(j)))
      ++i;
  AttributeDefImpl[] arrayOfAttributeDefImpl = new AttributeDefImpl[i];
  int k = 0;
  for (int l = 0; l < paramArrayOfAttributeDefImpl.length; ++l)
    if (!(isTranslatableAttribute(l)))
    {
      arrayOfAttributeDefImpl[k] = paramArrayOfAttributeDefImpl[l];
      ++k;
    }
  return arrayOfAttributeDefImpl;
}

代码中有isTranslatableAttribute()方法来判断相应的列是否为多语言转换的列，如果不是则添加到arrayOfAttributeDefImpl[]数组，否则丢弃。

这样处理之后返回的数据就只包括了除去多语言属性的列，这刚好是多语言基表中的属性列，所以上面buildDMLStatement()方法中将数据表替换为多语言基表才不会出现问题。

至此多语言实现处理的主要逻辑都已经解释完成了，另外有很多细节上面的处理就留个感兴趣的人去研究吧。

附上OAEntityImpl.class,OATranslatedEntityStaticInfo.class反编译的Java代码(仅供学习之用) :

–

Oracle EBS 12.0.0

Oracle EBS 12.0.0 开始，OA Framework的 多语言转换的实现基本上已经和一般的实现没有什么区别，大大简化了开发的复杂性。

下面是基本的开发步骤：

1，按照下面的规则为 _TL表创建一个实体对象

命名实体为<Entity>TLEO，如LOOKUP_CODES_TL表被命名为LookupCodeTLEO实体名称

1. 包括表中所有的列，并且保证LANGUAGE列被命名为Language属性，SOURCE_LANG列被命名为SourceLang属性
2. 然后设置LANGUAGE列作为主键的一部分
3. 并且保证实体和其它实体一样继承了OAEntityImpl
4. 其它的实体相关的验证逻辑，多语言转换的无需添加任何验证

默认情况下，只要满足如下条件的所有字段都会被认为是需要进行多语言转换的：

1. 不是主键列，而且
2. 不是一个entity accessor，而且
3. 是数据类型之一：VARCHAR, CHAR, FIXED_CHAR, LONGVARCHAR, CLOB

如果说需要覆盖默认的规则，可以在各属性级别的客户化属性中设置OA_TRANSLATABLE属性，

属性值为true，说明此列需要进行多语言转换

属性值为false，说明此列不需要进行多语言转换

2，按照下面的规则为 _VL视图创建一个多语言实体对象

1. 按照创建一般实体对象的规则来创建实体对象，如LOOKUP_CODES_VL视图，对应的实体名称为LookupCodesEO
2. 不要包括伪列RowId，包括视图中其它所有的列
3. 检查主键正确设置
4. 设置一个实体级别的自定义属性OA_BASE_TABLE，它的值为多语言视图_VL所对应的基表，如LOOKUP_CODES_B或者LOOKUP_CODES

OA Framework自动覆盖了实体对象中的doDML方法来确保当对多语言视图进行插入、更新和删除操作的时候实际上是对基表进行相应的操作。所有的读取操作则依赖于_VL视图

3，根据以下规则在_VL(Source)和_TL(destination)间创建一个实体关联

1. 按照常规的关联规则创建
2. 关系必须是 1:*，取消Cascade Delete选项的选择，_VL实体选择为Source，_TL实体为Destination
3. 更改destination entity的Accessor Name名称为OA_TL_ENTITIES

4，使用多语言视图创建视图对象

当创建一个视图对象来访问多语言转换实体的时候，总是使用基于_VL视图创建的实体对象。基于EBS的设计，访问多语言都是基于VL，TL被自动处理为“不可见”状态

上面的开发步骤除了需要进行几个必要属性的设置之外，和非多语言转换的开发步骤基本上没有什么区别，而在EBS R12之前，如果需要进行多语言转换的开发，

需要使用OAPlsqlEntityImpl来实现，同时需要编写数据库程序包 ON_INSERT、ON_UPDATE、ON_DELETE 和 ON_LOCK 方法。而从EBS R12版本之后，已经进行了简化。

后面我们就来看看Oracle究竟是怎么样来解决这个问题，使开发人员无须更多关注多语言转换开发实现的技术细节。

本站参考链接

关于Oracle EBS下多语言的开发，请查看：

数据多语言转换开发(1)

http://www.oracleseeker.com/index.php/data-translation-in-ebs-forms-breifing

数据多语言转换开发(2)

http://www.oracleseeker.com/index.php/table-relation-of-data-translation-in-ebs-forms

数据多语言转换开发(3)

http://www.oracleseeker.com/index.php/develop-data-translation-form-in-oracle-ebs

–