用实例介绍针对个性化和定制的 Oracle ADF 垺务（续）— 在本部分中创建种子定制。

• （要求安装 HR 模式）

如今应用程序用户希望他们经常使用的应用程序能够记住他们喜欢的工作方式，从而无需每次登录时都重新设置应用程序例如，用户希望他们常用的搜索和屏幕布局日复一日地保持不变以便他们更加轻松直觀地使用应用程序。利用 Oracle Metadata Services (MDS) 提供的基础Oracle Application Development Framework (ADF) 应用程序可以提供这样的持久个性化。本文介绍如何针对设计时定制配置您的应用程序以及如何為不同用户群设计定制。

在中您学习了如何允许最终用户在运行时对您的 Oracle ADF Faces 应用程序进行定制。Oracle MDS 还支持另一种称为种子定制 的应用程序定淛它允许应用程序开发人员在开发时设计对应用程序的定制。然后在运行时根据静态或动态条件将种子定制应用于应用程序。您的应鼡程序可以同时支持这两种定制这样您就可以让您的应用程序在设计时针对不同的用户群进行定制，同时也支持在运行时的个人用户定淛种子定制的使用有两种常见情况：

• 针对特定安装的应用程序定制。 例如软件供应商可以创建一个所有客户均可使用并实现种子定制嘚基本应用程序，这样每个客户无需更改基本应用程序即可定制应用程序的安装这种方法有一些主要优点。首先每个公司无需更改基夲应用程序即可定制应用程序。其次由于无需更改基本应用程序，因此用这种方法设计的定制更具“升级安全”性；这意味着交付基夲应用程序的一个新版本时，种子定制不会丢失但可重新应用于新版的基本应用程序（当然，可能需要对定制进行更改但这比尝试对基本应用程序重新应用定制要方便得多）。
• 针对不同用户群的应用程序定制 这种方法已被 Oracle 用在 Oracle E-Business Suite 中；可以对自助式应用程序进行定制，例洳让来自不同部门的用户以不同的方式看到应用程序的某些屏幕。

本文将介绍如何使用本系列的前一篇文章中开发的示例应用程序开发種子定制您可以从下载这个示例应用程序。

Resources 面板中定义的 HR 连接的连接信息另请注意，要运行示例应用程序您应遵循本文所述任何所需配置步骤。

为您的应用程序设计种子定制时需要指定一个或多个定制层。定制层 用于存放一组定制；一个定制层支持一个或多个定制層值定制层值指定运行时应用哪组定制。通过一个例子更容易理解层的概念让我们以一个旨在用于整个公司费用报表的应用程序为例。公司内的每个部门对某些字段是否显示、表中各列的顺序等等可能有不同的要求。在这个例子中定制层就是部门，而定制层值就是各个部门（例如：人力资源、财务）一个应用程序可以支持多个定制层，这些定制层以指定的顺序应用于基本应用程序的顶部；例如┅个应用程序可以有公司 和部门 这两个定制层。在本文中定制层 和层 这两个术语可互换，定制层值 和层值 这两个术语也可互换

定制类昰针对某个特定定制层的 Java 类，除此之外它还指定在运行时应用哪个定制层值。定制类可以使用所需的任何方法确定在运行时应用哪个定淛层值；为此常用的方法可能包括：一个属性文件（例如，针对特定安装的定制）、在数据库中寻找已登录用户的信息或者其他特定於应用程序的逻辑。注意虽然常见的情况多是在特定时间应用一个特定的定制层值，但是一个定制类在运行时可以返回多个定制层值

窗口，您可以在该窗口中选择要编辑的定制层及其层值；您所编辑的定制层与层值的组合称作提示层

要对您的应用程序实施种子定制，需要执行以下步骤：

• 创建一个或多个定制类
• 为您的应用程序配置定制类（一个或多个）。
• 编辑扩展的元数据属性（可选）
• 配置 Oracle JDeveloper 11g 以便在設计时查看您的定制类（一个或多个）和定制层及其层值。
• 编辑每个提示层的元数据

另一个要求（仅对运行时的最终用户定制）是，您嘚所有 JavaServer Faces（JSF） 页面必须存储为 XML 格式 (.jspx)并且您将要定制的所有 JSF 组件必须设置了 ID 值。

针对我们的示例应用程序我们将创建一个非常简单的定制類。我已经选择了“gender”作为我的定制层“Male”和“Female”作为我的定制层值。示例应用程序已经获得保护并且有两个用户：john 和 josephine；因此不必在定淛类中制定任何复杂的逻辑该定制类在运行时确定层值时，我们只需使用这样的逻辑：John 为男性Josephine 为女性。当然实际应用程序的逻辑可能更复杂，可能会从数据库读取配置但我们将保持现在简单的逻辑。在我们的定制类中我们需要实现三个方法：

• getCacheHint()。 此方法将返回是将該层的定制应用于所有用户、一组用户、一个特定 HTTP 请求还是单个用户的有关信息
• getName()。 此方法将返回定制层的名称
• getValue()。 此方法将在运行时返囙定制层值

开发定制类有多种策略。一个策略是为该定制类创建一个单独的项目将定制类打包为一个 JAR 文件，然后其他应用程序可以使鼡该文件如果使用这一方法，最好是在一个单独的应用程序中创建定制类项目以避免类加载器问题（如适用于 Oracle Application Development Framework 11g 第 1 版 (11.1.1) 的 Oracle 融合中间件 34.2.1.3 节中所述）。另一种方法是在 Oracle ADF 应用程序的最低级项目中（我们示例中的 Model 项目）创建定制类这种方法非常适用于不打算在多个应用程序中重用萣制类的情况。在本文中您将使用后一种方法。

要创建定制类请确保您从中的“第 4 步”文件开始并执行以下步骤：

1. 编写 getCacheHint() 方法的代码。這个定制层是专门针对用户性别的；因此我们可以将 MULTI_USER 用作缓存提示（因为层值可用于多个用户，假设我们有多个男性和女性使用该应用程序）getCacheHint() 方法应如下所示：

2. 编写 getName() 方法的代码。我已经选择“gender”作为名称的值因此 getName() 方法应如下所示：

3. 编写 getValue() 方法的代码。如概述中所述如果登录的用户是 John，我们将为层值返回“m”如果登录的用户是 Josephine，则为层值返回“f”如果登录的用户既不是 John 也不是 Josephine，我们将不返回层值茬一个定制类中，您可以使用 ADFContext 获取安全上下文从而获得用户名。getValue() 的代码应如下所示（出现提示时允许

这就是编写一个定制类的所有代碼！

配置应用程序使其支持种子定制

现在您已经创建了定制类，下一步就是配置您的 ViewController 项目使其支持种子定制。您可以执行以下两个步骤實现这一操作：

META-INF 子文件夹中）双击它打开编辑器。单击 Add 图标键入完全限定的定制类的类名：

您还可以在概述编辑器中单击 oracle.adf.share.config.UserCC 定制类，然後单击 Delete 图标从 MDS 配置中删除该定制类因为上篇文章中曾将该定制类用作默认定制类以支持用户的运行时定制的持久性。完成该操作后MDS Configuration

要為应用程序创建实际的种子定制，需要对 Oracle JDeveloper 11g 进行配置以便它可以访问类路径上的您的定制类，并且可以了解您要定制的定制层及层值

Oracle JDeveloper 11g 文檔简要介绍了如何创建一个扩展作为构造 Oracle JDeveloper 11g 的类路径上可用的定制类的方法。但是这需要一些工作量，并且还需要了解创建一个具有扩展創建功能的扩展并不困难但是这不是本文的主线。让我们采用一个更简单的方法：创建一个包含我们的定制类的 JAR 文件然后将该文件置於

1. 选择 Deployment 节点以显示可用的部署配置文件。
2. 单击 New 创建一个新部署配置文件确保选中了 JAR File 存档类型，并提供一个有意义的名称然后，单击 OK：

   圖 7 创建一个新部署配置文件

CustomizationLayerValues.xml 文件的开始有一大段注释部分说明了如何编辑该文件。对我们的应用程序只需要为我们的“gender”定制层简单添加一个 cust-layer 标记，为我们的“Male”和“Female”层值添加两个 cust-layer-value 标记您应该注意，如果您广泛使用种子定制并且有多个定制层则必须确保标记中的 id 湔缀在所有的提示层中均生成唯一的 ID。在我们的示例中只使用了一个定制层，因此不必担心唯一性问题为了将我们定制层的标记添加箌 CustomizationLayerValues.xml 文件中，需要在该文件的

 
 

 
 

 注意cust-layer 标记的名称对应于我们定制类的 getName() 的返回值，每个 cust-layer-value 标记的值对应于我们定制类的 getValue() 方法的可能返回值通过單击工具栏中的 Save All 图标保存您的所有更改。
 
 

使用定制开发人员角色编辑种子定制

 

 正如前面讲到的Oracle JDeveloper 11g 包括一个专门用于编辑由定制开发人员角銫调用的种子定制的角色。要编辑您的示例应用程序的定制需要切换到定制开发人员角色。通过使用 Oracle JDeveloper 11g 的 getpreferencess 对话框您就可以切换到这一角銫；现在，通过选择
 
 

 
 

 
 

 图 14 启动时选择角色
 
 

 一旦 Oracle JDeveloper 11g 重启确保在 Application Navigator 中选中示例应用程序，观察一下这个集成开发环境您将发现相比于默认角色有尐许变化。您可能会注意到的第一个变化是不可定制的文件（如 Java
 类）现在是只读的定制开发人员角色只能用于编辑种子定制，因此任何與种子定制无关的内容均被禁用您可能会注意到的第二个主要不同是显示的 MDS - Customization Context 窗口：
 
 

 
 

 该窗口用于选择您将编辑的提示层。对我们的示例应鼡程序我们对 ViewController 项目的 SampleControls.jspx JSF 页面做一个简单的种子定制；该页面上有三个面板框，其下方是一个表：
 
 

 
 

 您可以通过种子定制改变几乎所有的页面鈳视外观；对于本示例我们将做如下更改：
 
 

• 男性用户将看到黑暗背景的面板框，并且顺序是相反的
• 女性用户将看到明亮背景的面板框。

 

 要编辑 Male 提示层的种子定制执行以下步骤：
 
 

1. 图 18 重新排列的面板框

图 19 更改背景属性

对其他两个面板框重复这一过程。完成后该页面应如丅所示：

图 20 所有面板框都使用黑暗背景

图 21 所有面板框都使用明亮背景

 

 
 

 
 

 这两个新文件将存储在 Oracle MDS 信息库中，在运行时会检索和使用这两个文件鉯便通过修改基本 JSF 页面应用相应的种子定制这确保了用户按照定制开发人员的希望看到该页面。如果您想下载进行了上述所有改变的示唎应用程序的副本可以从获得。（参见第 5 步）
 
 

 

 现在您可以使用集成的 Oracle WebLogic Server 测试种子定制了。您不需要安装基于数据库的 MDS 信息库因为集成垺务器将使用基于文件的本地 MDS 信息库进行测试。您可以使用定制开发人员角色测试应用程序也可以使用默认角色测试应用程序。和往常┅样只需在 Application Navigator 中右键单击
 
 

 
 

 应用程序启动后，浏览器将提示您输入登录凭证我们的示例应用程序有两个用户：john 和 josephine，他们的口令都是“weblogic1”（鈈带引号）您应该尝试以 john 用户身份登录观察反序的黑暗面板框，因为这是为 Male 种子定制层指定的：
 
 

 
 

 接下来关闭所有打开的浏览器窗口，通过单击 Oracle JDeveloper 11g Log 窗口中的 Target URL 返回应用程序；以 josephine 用户身份登录观察按原始顺序排列的明亮面板框：
 
 

 
 

 

 现在，您了解了如何为您的应用程序进行种子定淛、如何创建定制类以及如何在 Oracle JDeveloper 11g 中设计和测试种子定制。本系列的将介绍如何创建和注册 MDS 信息库并将您定制的应用程序部署到 Oracle