对适配器添加定制组件

可以通过添加定制组件来扩展通用日志适配器,这些定制组件可以被包括在适配器配置文件的上下文中。可以将定制组件作为适配器的新组件来添加,也可以使用定制组件来替换适配器中的现有组件。

先决条件
创建基于规则的适配器
创建定制组件

对适配器添加新组件

要对适配器添加新组件:

  1. 在“通用日志适配器”透视图中,在“导航器”窗格中选择适配器配置文件。单击鼠标右键,然后选择打开方式 > 适配器配置编辑器。该文件就会在编辑器中打开。
  2. 在“适配器配置编辑器”窗口中,展开适配器 > 配置 > 上下文实例节点。
  3. 右键单击“上下文实例”,然后选择添加 > 处理单元。这将在“上下文实例”中创建新的处理单元。
  4. 描述字段中指定组件描述。
  5. 如果组件需要输入,则针对每个必需输入,对处理单元添加属性。要对处理单元添加属性,请右键单击该处理单元,然后选择添加属性
  6. 对于添加的每个属性,指定属性的名称和值。
  7. 要配置适配器以使用新的处理单元,需要在上下文中创建相关联的组件。打开要将处理单元添加到的上下文。要打开缺省上下文,请选择适配器 > 上下文 > 上下文基本实现上下文
  8. 右键单击要将处理单元添加到的上下文。对于缺省上下文,右键单击上下文基本实现上下文并选择添加 > 组件。这就将一个新组件添加至上下文。
    注意:组件在上下文中的出现顺序定义了组件的执行顺序。请确保按正确的顺序放置新组件。可以通过拖放组件来更改它们在上下文中的顺序。
  9. 使用下列值配置新组件:
    名称: 上下文中新处理单元的名称
    描述: 对此组件执行的任务的描述
    可执行的类: 为此组件创建的 Java 类
    记录级别:输出程序组件应使用的内部记录级别。
    值 99 表示输出程序将不记录任何消息。
    值 0 表示输出程序将记录所有严重性的消息。
    建议值是 50,这表示只记录“紧急”或“致命”内部输出程序错误消息。
    角色: 应该从下拉列表中选择组件的角色。要了解有关不同的角色的信息,请参阅适配器配置文件结构。对于未列示的角色,选择未声明的
    唯一标识: 必须指向步骤 3 中在“上下文实例”中定义的组件。使用浏览按钮来选择正确的标识。
  10. 保存适配器配置文件更改。

替换适配器中的现有组件

要使用定制组件来替换适配器中的现有组件:

  1. 在“适配器配置编辑器”窗口中,展开要替换的组件所在的上下文。要展开缺省上下文,请选择展开适配器 > 上下文 > 上下文基本上下文实现节点。
  2. 单击要替换的组件。组件详细信息将显示在右窗格中。
  3. 更新名称描述字段以描述组件。
  4. 使用定制组件类名更新可执行的类。以下是已被定制输出程序替换的输出程序组件示例。
    定制组件的更改更新了“上下文实现”组件输出程序
  5. 如果正在替换的组件需要特定的属性,则打开节点配置 > 上下文实例,然后选择所替换的组件。
  6. 通过选择添加属性来添加组件所需的属性。通过右键单击属性并选择删除,除去组件配置不需要的任何属性。
  7. 保存适配器配置文件更改。

相关任务
创建日志解析器

相关参考
适配器配置文件结构