创建探针

要创建探针,首先应在 Probekit 项目中创建 Probekit 源文件(probe 文件)。然后,在 Probekit 源文件中创建探针并添加用来定义该探针的工作方式的内容。

先决条件: 创建 Probekit 项目
要创建 Probekit 源文件,必须使用“Probekit 源文件”向导。您可以继续使用该向导来创建探针和编写大多数探针定义,也可以直接转至 Probekit 编辑器。无论在哪种情况下,都必须使用 Probekit 编辑器来编写代码的 Java™ 代码段。

有关探针的各个部分的详细信息,请参阅探针定义

  1. 要创建 Probekit 源文件:
    1. 在“导航器”或“包资源管理器”视图中,右键单击您想要包含源文件的 Probekit 项目,然后单击新建 > 其它
    2. 选择向导页面上,展开概要分析和记录并选择 Probekit 源文件
    3. 单击下一步
    4. 在“创建新的探针文件”向导中,在文件名字段中输入新的探针源文件的名称。Probekit 源文件的文件扩展名必须为 .probe
    5. 源文件夹字段中,输入要包含新的 Probekit 源文件的项目源文件夹。
      注: Probekit 源文件必须出现在项目源文件夹的顶层;它们不能在子文件夹中。
  2. 如果您现在想要退出该向导并使用 Probekit 编辑器来创建探针及其定义:
    1. 选择无内容
    2. 单击完成。新的 Probekit 源文件便添加在项目源文件夹中,并且缺省情况下会在 Probekit 编辑器中自动打开。
    3. 继续执行步骤 4
  3. 如果想要继续使用该向导来帮助您创建探针定义:
    1. 选择方法探针调用位置探针
    2. 选择您想要该向导创建的段的段类型值。
    3. 单击下一步
    4. 使用添加编辑来定义探针的内容,可以根据需要进行定义,不加限制。当添加或选择某项时,该向导就会显示该项的描述。
      注: 如果您返回去更改正在创建的探针的类型或者更改要插入的段类型,则编辑器将提示您废弃不再适用的项。
    5. 单击完成。新的 Probekit 源文件便添加在项目源文件夹中,并且缺省情况下会在 Probekit 编辑器中自动打开。
  4. 可选: 在 Probekit 编辑器的“常规”页面上,在标识字段中输入探针的唯一标识字符串,并在版本字段中输入版本号,以及输入标注的值。 此数据仅供您用于标识探针。
  5. 单击探针选项卡。
  6. 如果您未使用该向导来创建探针,则单击添加探针 新探针将列示在页面左边的树窗格中。
  7. 右键单击树窗格中的探针,然后单击新建 > 新段作为探针的子代出现在树窗格中,而段的属性字段显示在页面右边的编辑窗格中。
  8. 在编辑窗格中,选择段类型值,然后输入探针段的 Java 代码。 有关特定信息,请参阅探针段类型
  9. 通过下列操作来继续定义探针:右键单击树中的项并使用弹出菜单添加子项,然后在编辑窗格中输入新项的值。 弹出菜单将只列示对于在树中选择的位置有效的项。如果某项有效,但是在所选位置不再能够添加它,则在菜单中将禁用该项。
    注: 当您在导入伪指令属性字段中输入值时,请只输入您想要导入的包或类的名称。不要输入 import 关键字或尾部的分号(;)。
  10. 完成了定义探针之后,单击文件 > 保存
    注: 当您保存 Probekit 源文件时,Probekit 编辑器将检查文件中所有 Java 元素的语法,并报告任何 javac 问题。如果某个条目具有错误或警告,则树中相应的图标就会更改为错误或警告图标。Javac 问题将显示在“探针”页面下半部分的一个表中。双击此表中的某项,以便选中该项并进行编辑。
相关概念
Probekit 参考
相关任务
修改探针
创建 Probekit 项目
管理 Probekit 注册表
相关参考
Probekit 编辑器
Probekit 示例
反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.