元素
|
类型
|
说明
|
StandardUIComponentValidation 服务
|
Java 类
|
通常称为验证服务。此服务类用于控制 UI 验证。它接收来自客户端基础结构的验证请求,并委派到相应验证器和筛选器以获得验证结果。然后,它会将验证结果传递回客户端基础结构。
自定义者和应用程序开发人员不必直接与此类进行交互。
|
UIValidationKey
|
Java 类
|
通常称为验证键。UIValidationKey 用于标识正在验证的 UI 组件。可以视为 UIValidationKey 与操作或属性具有一一对应关系。
|
UIValidationCriteria
|
Java 类
|
通常指的是验证条件。
UIValidationCriteria 是一个 bean 类,其中包含通过验证服务从客户端基础结构传递至验证器和筛选器的上下文 (请求、会话) 数据。
UIValidationCriteria 中大部分内容将直接从 NmCommandBean 中获取,尽管这些对象通常以 WTReferences 返回,而不是 NmOids。
|
UIValidationResult
|
Java 类
|
通常称为验证结果。
UIValidationResult 表示一个验证单位。换句话说,它将验证状况与 UI 组件 (操作或属性) 相关联。对多个对象的相同操作执行验证时,可将 UIValidationResult 与每个对象相关联。
|
UIValidationResultSet
|
Java 类
|
通常称为结果集。
UIValidationResultSet 只是 UIValidationResult 对象的集合。同时执行多个验证时,将使用结果集。例如,如果验证器对多个对象的相同操作执行预先验证检查,则可以将每个对象的验证结果聚合到 UIValidationResultSet 中。
|
UIValidationStatus
|
Java 类
|
通常称为验证状况。
此枚举用于确定 UI 组件是否应在 UI 中显示以及如何显示。例如,有一些值将指示应隐藏某一操作、应禁用某一操作或应启用某一操作。
|
UIValidationFeedbackMsg
|
Java 类
|
通常称为反馈消息。
此消息可与验证结果关联。它仅用于选择后验证和提交后验证。与预先验证的验证结果关联的任何反馈消息都将被忽略。
反馈消息可以关联不同的反馈类型 (FeedbackType.java),例如,用于指明其是错误消息、警告消息还是信息性消息。
|
UIComponentValidator
|
Java 接口
|
这是所有验证器实现都需要实现的接口。但是,验证器不应直接实现此接口。相反,它们应扩展 DefaultUIComponentValidator。
每个 UI 组件可以有零个或一个与其关联的验证器。通常,验证器将包含特定于单个 UI 组件的逻辑。对于适用于多个 UI 组件的更通用验证逻辑,通常使用筛选器。
验证服务将调用这些验证器来确定特定 UI 组件的验证状况。
自定义者和应用程序开发人员不必直接与此类进行交互。
|
DefaultUIComponentValidator
|
Java 类
|
这是 UIComponentValidator 接口的默认实现。所有验证器实现都应扩展此类。
|
ValidationFilter
|
Java 接口
|
这是所有筛选器实现都需要实现的接口。但是,筛选器不应直接实现此接口。相反,它们应扩展 DefaultSimpleValidationFilter 或 DefaultUniversalValidationFilter。
每个 UI 组件都可以有零到多个与其关联的筛选器。通常,筛选器将包含可应用于多个 UI 组件的通用验证逻辑。对于特定于单个 UI 组件或小型 UI 组件集的验证逻辑,通常会使用验证器。
筛选器分为两种类别:简单筛选器和通用筛选器。简单筛选器需要逐个应用到组件。换句话说,您必须选取要将简单筛选器中的逻辑应用到的 UI 组件。相反,通用筛选器将应用于所有 UI 组件,这意味着您必须选择通用筛选器中的逻辑不会应用到哪些 UI 组件。
验证服务将调用 Filtersare 来确定特定 UI 组件的验证状况。
自定义者和应用程序开发人员不必直接与此类进行交互。
|
SimpleValidationFilter
|
Java 接口
|
这是所有简单筛选器实现都需要实现的接口。但是,简单筛选器不应直接实现此接口。相反,它们应扩展 DefaultSimpleValidationFilter。
自定义者和应用程序开发人员不必直接与此类进行交互。
|
UniversalValidationFilter
|
Java 接口
|
这是所有通用筛选器实现都需要实现的接口。但是,通用筛选器不应直接实现此接口。相反,它们应扩展 DefaultUniversalValidationFilter。
自定义者和应用程序开发人员不必直接与此类进行交互。
|
DefaultSimpleValidationFilter
|
Java 类
|
这是 SimpleValidationFilter 接口的默认实现。所有简单筛选器实现都应扩展此类。
|
DefaultUniversalValidationFilter
|
Java 类
|
这是 UniversalValidationFilter 接口的默认实现。所有通用筛选器实现都应扩展此类。
|
UIComponentSolutionGroup
|
Java 接口
|
这是所有解决方案组实现都需要实现的接口。
解决方案组是一种特殊类型的验证器,用于基于已安装的解决方案进行预先验证。例如,如果给定操作应该在未安装 Windchill ProjectLink 的情况下不可用,则应在解决方案组中定义该逻辑。
|
*actions.xml
|
XML 文件
|
actions.xml 文件有多个包含操作定义的 "satellite" 版本 (通常每个模块一个)。
在这些文件中,我们还可将操作配置为包括简单筛选器,而排除通用筛选器。
|
*service.properties.xconf
|
XConf 文件
|
service.properites.xconf 文件有多个包含类委派注册表项的 "satellite" 版本 (通常每个模块一个或多个)。
可在这些文件中注册验证器、筛选器和解决方案组,以便指示验证服务应该在何处查找它们。
|
键 |
1. 客户端基础结构调用验证服务,将操作 (由验证键表示) 相应传递至要呈现的页面和上下文数据 (由验证条件实例表示)。 |
键 |
1. 客户端基础结构调用验证服务,将操作 (由验证键表示) 相应传递至要呈现的页面和上下文数据 (由验证条件实例表示)。 2. 对于每个验证键,验证服务都会执行一系列任务以确定该键的验证状况。任务按以下顺序执行: a. 检查验证键是否位于已安装的解决方案集的无效键列表中。 |
键 |
1. 客户端基础结构调用验证服务,将操作 (由验证键表示) 相应传递至要呈现的页面和上下文数据 (由验证条件实例表示)。 2. 对于每个验证键,验证服务都会执行一系列任务以确定该键的验证状况。任务按以下顺序执行: a. 检查验证键是否位于已安装的解决方案集的无效键列表中。 b. 检查基于角色的 UI 服务是否已配置为禁用或隐藏组件。 |
键 |
1. 客户端基础结构调用验证服务,将操作 (由验证键表示) 相应传递至要呈现的页面和上下文数据 (由验证条件实例表示)。 2. 对于每个验证键,验证服务都会执行一系列任务以确定该键的验证状况。任务按以下顺序执行: a. 检查验证键是否位于已安装的解决方案集的无效键列表中。 b. 检查基于角色的 UI 服务是否已配置为禁用或隐藏组件。 c. 检查与 UI 组件关联的任何筛选器是否指示应禁用或隐藏该组件。 |
键 |
1. 客户端基础结构调用验证服务,将操作 (由验证键表示) 相应传递至要呈现的页面和上下文数据 (由验证条件实例表示)。 2. 对于每个验证键,验证服务都会执行一系列任务以确定该键的验证状况。任务按以下顺序执行: a. 检查验证键是否位于已安装的解决方案集的无效键列表中。 b. 检查基于角色的 UI 服务是否已配置为禁用或隐藏组件。 c. 检查与 UI 组件关联的任何筛选器是否指示应禁用或隐藏该组件。 d. 如果存在与 UI 组件相关联的验证器,则会从验证器获取验证状况。 |
键 |
1. 客户端基础结构调用验证服务,将操作 (由验证键表示) 相应传递至要呈现的页面和上下文数据 (由验证条件实例表示)。 2. 对于每个验证键,验证服务都会执行一系列任务以确定该键的验证状况。任务按以下顺序执行: a. 检查验证键是否位于已安装的解决方案集的无效键列表中。 b. 检查基于角色的 UI 服务是否已配置为禁用或隐藏组件。 c. 检查与 UI 组件关联的任何筛选器是否指示应禁用或隐藏该组件。 d. 如果存在与 UI 组件相关联的验证器,则会从验证器获取验证状况。 3. 将验证结果或验证结果集返回到客户端基础结构。 |
键 |
1. 客户端基础结构调用验证服务,将操作 (由验证键表示) 相应传递至要呈现的页面和上下文数据 (由验证条件实例表示)。 |
键 |
1. 客户端基础结构调用验证服务,将操作 (由验证键表示) 相应传递至要呈现的页面和上下文数据 (由验证条件实例表示)。 2. 验证服务将检查是否存在与操作关联的验证器。如果存在,它将调用验证器以获取操作的验证状况 (允许或拒绝)。 |
键 |
1. 客户端基础结构调用验证服务,将操作 (由验证键表示) 相应传递至要呈现的页面和上下文数据 (由验证条件实例表示)。 2. 验证服务将检查是否存在与操作关联的验证器。如果存在,它将调用验证器以获取操作的验证状况 (允许或拒绝)。 3. 验证服务会将验证状况 (封装在验证结果中) 从验证器传递至客户端基础结构,这可显示目标页面/向导,或使用户返回到调用该操作的页面。 |
键 |
1. 客户端基础结构调用验证服务,传递与向导的“下一步”或“确定”操作 (由验证键表示) 关联的 ID 以及上下文数据 (由验证条件实例表示)。 |
键 |
1. 客户端基础结构调用验证服务,传递与向导的“下一步”或“确定”操作 (由验证键表示) 关联的 ID 以及上下文数据 (由验证条件实例表示)。 2. 验证服务检查是否存在与“下一步”或“确定”操作关联的验证器。如果存在,它将调用验证器以获取操作的验证状况 (允许或拒绝)。 |
键 |
1. 客户端基础结构调用验证服务,将操作 (由验证键表示) 相应传递至要呈现的页面和上下文数据 (由验证条件实例表示)。 2. 验证服务检查是否存在与“下一步”或“确定”操作关联的验证器。如果存在,它将调用验证器以获取操作的验证状况 (允许或拒绝)。 3. 验证服务会将验证状况 (封装在验证结果中) 从验证器传递至客户端基础结构,这可以允许用户继续执行向导中的下一步或提交整个向导,或将用户返回到调用该操作的向导步骤。 |