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