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