练习 1.2:创建第一个探针

在开始之前,必须已完成练习 1.1:导入必需的资源

您要创建的探针在程序中的方法进入时报告。

创建探针涉及三个主要任务:

  1. 创建空的 Probekit 源文件
  2. 创建源文件内容
  3. 检查探针

创建空的 Probekit 文件

我们将在 Probekit 文件本身的项目中创建该文件,尽管您也可以在和应用程序相同的项目中创建探针。

  1. 创建新的保存该探针的 Java 项目:
    1. 从 Software Development Platform 菜单栏,选择文件 > 新建 > 项目...。打开“新建项目”对话框。
    2. 选择 Java 项目并单击下一步。打开“新建 Java 项目”对话框。
    3. 在“项目名称”字段中,输入 RandomNumbersProbe 并单击完成。 条目 RandomNumbersProbe 添加到“包资源管理器”视图中。
  2. 将项目转换成 Probekit 项目:
    1. 在“包资源管理器”视图中,右键单击刚创建的 RandomNumbersProbe 项目,并选择新建 > 其它...。打开“新建”对话框。
    2. 选中显示所有向导,然后展开“概要分析与记录日志”条目。
    3. 选择将 Java 项目转换成 Probekit 项目,并单击下一步
    4. 如果打开了“确认启用”对话框,单击总是启用功能,不要再次询问,然后单击确定。 打开“将 Java 项目转换成 Probekit 项目”对话框。
    5. 确保只选中了 RandomNumbersProbe 项目,然后单击完成
  3. 在 RandomNumbersProbe 项目中创建新 Probekit 源文件:
    1. 在“包资源管理器”视图中,右键单击 RandomNumbersProbe
    2. 选择新建 > 文件。打开“新建文件”对话框。
    3. 选择 RandomNumbersProbe 使其成为父文件夹。
    4. 在“文件名”字段中,输入 RandomNumbersProbe.probe,然后单击完成。 条目 RandomNumbersProbe.probe 添加到“包资源管理器”视图中。打开 Probekit 编辑器与“问题”视图。 该编辑器显示新创建的文件。

现在在 Probekit 源文件本身的项目中有一个空的 Probekit 源文件。 由于文件在 Probekit 项目中,并且在工作区中启用了自动构建,探针编译器已尝试编译此源文件。 因为空文件不是有效的 Probekit 源文件,“问题”视图报告一条错误。

创建源文件内容

您现在将使用 Probekit 编辑器创建组成探针的探针元素。

探针源文件是树形结构。顶部有一个 Probekit 元素。 您需要在 Probekit 元素下创建 Probe 元素,并新建 Fragment 元素。 然后需要指出 Fragment 元素将访问两类数据:类名和方法名。 最后需要编写 Java 代码片段本身。

我们想创建的探针由单个“入口”Java 代码片段组成。“entry”片段是在您正调查的程序中指定方法的方法进入时间触发的片段。 在我们的探针中,只要有方法进入,“entry”片段将打印出类名和方法名。 正如所编写的,我们的探针将应用到所有的类和方法;然而当部署它时,我们将通过过滤系统类缩小范围,作为启动过程的一部分。

注意:Probekit 除了“entry”片段之外也支持其它类型的片段。例如, 您也可以编写当指定的方法退出时或指定的方法处理异常时执行的片段。有关详细信息,请参阅帮助系统。

要为探针创建元素:

  1. 在 Probekit 编辑器中,右键单击 Probekit 元素并选择新建 > 探针。 将 Probe 元素添加到树中。
  2. 右键单击新创建的 Probe 元素并选择新建 > 片段。 将 Fragment 元素添加在 Probe 元素下。缺省情况下,作为“entry”片段创建片段。 (注意,entry 也是 Probekit 编辑器的右边的“片段类型”字段中的选择。)
  3. 创建保存类名的变量:
    1. 右键单击 Fragment entry 元素并选择新建 > 数据
    2. 在 Probekit 编辑器的右边,确保作为“数据类型”选择了 className
    3. 在“名称”字段中,输入 cname 作为变量名。
  4. 创建保存方法名的变量:
    1. 右键单击 Fragment entry 元素并选择新建 > 数据
    2. 从“数据类型”下拉列表中选择 methodName
    3. 在“名称”字段中,输入 mname 作为变量名。
  5. 输入想要运行的 Java 代码:
    1. 单击 Fragment entry 元素。
    2. 在“Java 代码”区域,输入以下代码行:
      System.out.println("[Enter method " + cname + "." + mname + "]");
  6. 从菜单栏中,选择文件 > 保存。 探针编译器将自动编译来自其源代码的探针。

检查探针

保存探针时,探针编译器在“问题”视图中报告错误。检查“问题”视图以查看有否错误情况。 如果有错误,在“探针”编辑器中纠正错误并再次保存该探针。

两类错误可以在“问题”视图中报告:

这样,您就创建了第一个探针。

现在您就可以开始练习 1.3:应用探针

使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.