如何利用 Eclipse 工具来诊断客户问题

　　本文描述了可用于诊断客户报告的 Eclipse 插件问题的策略。这些策略最强大之处在于能够将一个调试会话从一个 Eclipse 实例附加到正在远程主机上运行的 Eclipse 实例上。本文中所描述的策略对于基于 Eclipse 2.x 的所有产品都有效，如 WebSphere Studio Application Developer 和 WebSphere Studio Site Developer。

　　因此，您写了一个 Eclipse 插件，您将它交给了用户 — 那个用户甚至可能为其支付了费用。该用户迟早会报告问题。有时您只要根据症状报告就能够断定发生了什么事。而在其它时候，错误将十分棘手，以至于您需要从用户那里获取更多信息，包括其系统配置，以及确保他实际正在运行的插件版本是正确的。而在最坏的情况下，您甚至无法在您的环境中重现问题；您需要直接访问用户的机器以真正地了解发生了什么事。

　　所幸的是，只要具备少量的工作台工具知识和访问插件元数据的方法，您就可以诊断客户针对插件可能报告的任何问题。在本文中，您将看到：

　　□ 如何获得客户工作台配置方面的综合信息，包括所安装的插件和功能部件，还包括它们每一个的版本
　　□ 工作台错误作为日志记录在哪里
　　□ 在哪里找到特定于特殊插件的元数据
　　□ 如何从您自己的工作台调试客户的环境

　　工作台配置

　　Eclipse 提供了一种简单的方法来抽取一个正在运行的工作台实例的配置细节（另请参阅图 1）：

　　1. 在工作台的主工具栏中展开 Help 菜单。
　　2. 选择 About ...（菜单项的文本总是以“About”开头，但还可能包含特定于产品的文本，如“About IBM WebSphere Studio Application Developer”或“About IBM WebSphere Studio Site Developer” — 这都取决于您正在使用的工作台的特点）。
　　3. 在出现的对话框中，按 Configuration Details 按钮。

图 1. About... 对话框

　　在当前透视图的编辑器区域将打开一个名为“Configuration Details”的文件。该文件含有以下信息：

　　□ 正在运行工作台 JRE 的所有 Java 系统特性
　　□ 已安装功能部件和插件及各自版本的完整列表
　　□ 安装／更新管理器活动的日志
　　□ 工作台错误日志的完整文本

　　您有时候可能会希望客户给您发送整个日志的副本。幸运的是，将日志保存到文件系统很容易：

　　1. 确保 Configuration Details 文件在其中打开的编辑器位于前面并且具有焦点。
　　2. 在工作台的主工具栏中选择 File 菜单。
　　3. 选择 Save Configuration Details As... 菜单项。

　　在图 1 中还请注意，在 About... 对话框中另外两个按钮 Feature Details 和 Plug-in Details 也可用。按其中的任意一个按钮，会出现一个对话框，该对话框中含有插件／功能部件及其版本的表视图。如果您希望迅速知道是否真的安装了插件，或者是否安装的插件为某个版本，那么您可能希望让客户先检查一下那些对话框中的清单，而不是让他发送其整个配置细节文件。

　　工作台错误日志

　　错误日志按年月日顺序（离现在越近的消息越靠近文件尾部）包含工作台和插件代码选择记录的任何消息和异常。工作台自动将所有未捕获的异常记录到错误日志中。

　　错误日志的文本包含在我们于前一节中生成的 Configuration Details 文件中。Eclipse 还从 Error Log 视图提供了错误日志的图形视图，Error Log 视图可以在 PDE Runtime 视图类别下找到。（要打开视图，请选择 Window > Show View）。错误日志条目在表中以行的形式出现；最近的条目显示为第一行。您可以这样来查看某个条目的详细信息：选择一行，单击鼠标右键，然后选择 Properties。在出现的特性对话框中，特定日志条目的详细信息位于 Status Details 页上。另请参阅图 2。

图 2. Error Log 视图

　　错误日志文件本身作为 .metadata/.log（相对于工作空间 root）驻留在文件系统上。工作空间 root 常常直接位于工作台安装目录中，作为名为 workspace 的文件夹（这是 Eclipse 缺省工作空间位置）。然而，用户可以将其工作空间 root 配置为文件系统中的任何文件夹。

　　插件注册表

　　Configuration Details 文件列出了安装在工作台实例中的功能部件和插件。然而，该文件并不指示各个插件是否是活动的。

　　插件是惰性装入的 — 即其代码只有在需要的时候才装入内存。这样，就会出现这样一种情形，插件已经安装了，但因为某些原因，它却没有被激活。这表明：要么是在工作台试图装入该插件时发生了错误，要么只是还没有访问插件的功能。

　　Plug-In ReGIStry 视图列出了已安装的插件，并指示每个插件是否是活动的。要打开该视图，请转向 Window > Show View。可以在 PDE Runtime 类别下找到该视图。

　　插件是根据名称排序的（显示的是名称而不是插件标识）。如果插件图标的上面放有一个“runner”图标，那么该插件是活动的。

图 3. Plug-in Registry 视图

　　图 3 显示了一个样本工作台安装的 Plug-in Registry 视图。请注意，并非所有显示的插件都是活动的，只有那个名为“Apache Axis”的插件才是活动的，其图标包含“running”修饰。

　　在激活（或者取消激活）插件时，插件注册表视图并不自动更新。要检取插件的当前启用／禁用状态，请按视图标题栏中的 Refresh 按钮。否则，视图所反映的仍将是视图首次显示时所存在的事务状态。

　　插件元数据

　　插件通常会维护特定于自己的元数据。该元数据可以采取任何形式：特性文件、XML 文件甚至特有的二进制格式。当元数据采用人们可以读懂的格式时，这对直接查看元数据文件会很有用。

　　插件元数据驻留在文件系统的 .metadata/.plugins 目录（相对于工作空间 root）下。.plugins 目录内有一些文件夹，它们各自对应一个插件，以便维护它们自己的元数据。每个文件夹的名称都与对应插件的标识相同。该插件的元数据应该能够在文件夹中找到。

标签：

版权申明：本站文章部分自网络，如有侵权，请联系：west999com@outlook.com
特别注意：本站所有转载文章言论不代表本站观点，本站所提供的摄影照片，插画，设计作品，如需使用，请与原作者联系，版权归原作者所有