BlogJava-Jiangshachina-随笔分类-Eclipse

详解Eclipse断点(原)

Sha Jiang — Sun, 20 Nov 2011 12:57:00 GMT

详解Eclipse断点

大家肯定都用过Eclipse的调试的功能，在调试的过程中自然也无法避免要使用断点(breakpoint)，但不知是否对Eclipse中各类断点都有所了解。本篇图文并茂地介绍了Eclipse中全部类型的断点，及其设置，希望对大家有所帮助。(2011.11.20)

1. 示例程序
BreakpointDemo是一个臆造的应用程序，只是为了便于讲解Eclipse中各类断点的使用罢了。其代码如下图所示，

BreakpointDemo主要包含两个方法：
[1]setValue，该方法根据指定的次数(count)，对成员变量value进行赋值，值的范围为0-9的随机整数。
[2]printValue，该方法会调用setValue()对value进行赋值，并打印出value的值；但，如果value能被3整除，那么就会抛出IllegalArgumentException异常。

2. Line Breakpoint
Line Breakpoin是最简单的Eclipse断点，只要双击某行代码对应的左侧栏，就对该行设置上断点。此处，对第20行代码设置上Line Breakpoint，如下图所示，

可以为Line Breakpoint设置一个条件，那么当程序运行到该断点时，只有满足设定的条件，才会被中断。右键点击第20行的断点，选择"Breakpoint Properties..."

在弹出的属性对话框中，勾选上"Conditional"，然后在文本框中输入"count % 2 == 0"。

该条件表示，当程序运行到第20行时，只有当count为偶数时，程序才会被中断。细心地话，你会发现该断点的图标发生了改变，多了一个问号。

3. Watchpoint
Line Breakpoint关注于程序运行的"过程"，大家也常把使用这种断点的调试称为单步调试。但有时候，我们对程序的运行过程不太了解，可能也不太关心，不能确定在什么地方设置断点比较合适，而可能比较关注某个关键变量的变化或使用。此时，就可以为该变量设置一种特殊的断点--Watchpoint。在此示例，我们最关心的就是成员变量value的值，那么就可以为它设置一个Watchpoint，双击第9行代码对应的左侧栏就可以了。

使用在2中所提及的方法，查看该断点的属性，

默认地，当该变量被访问或它的值被修改时，程序都会被中断。但在本示例中，只希望当对value的值进行修改时程序才需要被中断，所以取消对"Access"的勾选。

这时，我们会发现原来的Watchpoin图标也有变化了。

4. Method Breakpoint
与关注对某个变量的访问与修改一样，我们也可以关注程序对某个方法的调用情况，即，可以设置Method Breakpoint。在此处，设置针对方法setValue的Method Breakpoint。同理，双击第11行代码对应的左侧栏即可。

仍然要查看该断点的属性。默认地，只勾选了"Entry"，而没有勾选"Exit"。

这表示，当刚进入该方法(调用开始)时，程序会被中断；而，离开该方法(调用结束)时，程序并不会被中断。在本示例中，需要同时勾选上"Exit"。

点击OK之后，可以看到该断点的图标也有所改变。

根据这里的设置，当程序运行到第20行后会在第12行被中断，尽管这里没有显式的断点，但这就是setValue()方法的入口(Entry)。必须注意地是，程序在运行到第16行时不会被中断，尽管它看起来像是setValue()方法的出口(Exit)。实际上，程序会在第17行被中断，这里才是setValue()调用结束的地方。

5. Exception Breakpoint
如果，我们期望某个特定异常发生时程序能够被中断，以方便查看当时程序所处的状态。通过设置Exception Breakpoint就能达到这一目标。本示例故意在第23行抛出了IllegalArgumentException异常，我们期望程序运行到此处时会被中断。但我们不直接为此行代码设置Line Breakpoint，而是为IllegalArgumentException设置Exception Breakpoint。设置Exception Breakpoint的方法与其它类型断点都不同，它不能通过双击左侧栏的方式在代码编辑器上直接进行设置。点击Breakpoints视图右上角形如Ji的图标，

会弹出如下所示的对话框，

在其中选中IllegalArgumentException，并点击OK，这时一个Exception Breakpoint就设置好了。

当value为3的倍数时，程序会在第23行被中断，这时我们就能使用调试器来看看value具体是等于0，3或6。

6. Class Load Breakpoint
还有一种大家平时可能不太用的断点--Class Load Breakpoint，即当某个类被加载时，通过该断点可以中断程序。

小结
上述的Eclipse断点，我们在现实工作中肯定都有意或无意地使用过其中的几种，只是不一定十分了解内情罢了。使用好Eclipse的各种断点，可以把很好地帮助我们分析程序，定位问题。

Sha Jiang 2011-11-20 20:57 发表评论

高效调试：条件化断点(译)

Sha Jiang — Thu, 31 Dec 2009 02:49:00 GMT

高效调试：条件化断点

本文是JavaLobby上的一篇博文，介绍了一个使用Eclipse和NetBeans进行调试的小窍门，我受益良多，也希望对大家有所助益。(2009.12.31最后更新)

最重要的开发者工作之一就是调试。在我的大学时代，我们被迫使用简单的文本编辑器开发软件，所以开始时，我使用打印语句来观察程序在什么地方出错了。现在，IDE使我们能很便捷地完成这一工作。...
我在Eclipse和NetBeans中见过的最佳特性就是条件化断点思想。这个想法很简单，打上断点，然后输入使调试线程能够停在该断点处的条件。例如，若有如下代码：

for(Employee emp: employees)
{
    if(emp.getType() == Employee.MANAGER)
    {
        addToManagers(emp);
    }
}

假设，当雇员的getType方法的值为Employee.DEVELOPER时，我想察看所有变量的值，并在单步调试时能确保不会进入IF语句块。
在Eclipse中，你可一如往常那样在IF语句中设置断点，右键点击断点，你将看到如下菜单：

通过勾选Enable Condition复选框，你可以在结果对话框中为该断点设置一个条件：

当你键入条件时，你能获得完全的内容提示。你也能改变条件的意义--当该条件为真时，或者当在最近一次遍历之后值被改变时，是否需要停止。
对于NetBeans，也十分的相似。你仍要右键点击断点以获得属性菜单：

该对话框也有熟悉的条件，命中次数和内容提示：

像这样的特性才能真正地帮助你提升调试的效率--当你知道某个特定的值导致了程序失败时，你就能直捣问题的核心了。

祝大家新年愉快 :-D

Sha Jiang 2009-12-31 10:49 发表评论

NetBeans vs. Eclipse RCP: 插件机制比较(译)

Sha Jiang — Wed, 15 Oct 2008 06:40:00 GMT

NetBeans vs. Eclipse RCP: 插件机制比较

本文是JavaLobby上的一篇小文，作者对NetBeans和Eclipse的插件机制进行了一些比较，如有兴趣，可以看看。(2008.10.15最后更新)

NetBeans与Eclipse处理扩展点及扩展的方式是不同的。让我们看看这些不同之处。请注意，本文仅针对那些对这两个平台的插件机制都具备相当知识的人。

NetBeans Platform:

定义扩展点	创建一个接口，并将它置入一个公共模块包中。
创建扩展	创建上述接口的实现，并通过layer.xml文件将它注册到虚拟文件系统中。
读取可用的扩展	使用org.openide.util.Lookup类去获取上述接口实现的实例。

Eclipse RCP:

定义扩展点	创建一个扩展点的描述符方案，该方案定义了扩展点的元素与属性，以及这些元素之间的关系。可用的属性类型为：boolean，string，java，resource和identifer。可向该方案的任何部分添加文档。最后，向plugin.xml文件注册你的扩展点。
创建扩展	根据上述方案，在plugin.xml文件中创建一个子部分，在此处向属性赋予值。如果属性类型为java，则也要创建被引用的Java类。
读取可用的扩展	使用org.eclipse.core.runtime.IExtensionPoint获取扩展的列表。从每个扩展中获取IConfigurationElement的列表：每个IConfigurationElement对应于plugin.xml文件中的一个XML标签。

NetBeans平台		Eclipse RCP
优点	缺点	优点	缺点
非常简单，易于学习	扩展点没有定义它自己：没有关于是哪个公共模块接口作为扩展点使用的信息。	扩展点清晰地定义了它自己：快速查看jar文件，你就能立即知道该插件提供了哪些扩展点，以及它们是由哪些元素组成的。	比较复杂，需要更多时间去学习
	使用的查找名也未作定义	有许多属性类型：可以在XML文件中描述特定的结果。
	扩展和其它的内容都混写在layer.xml文件中：难以确定该模块用于哪些扩展。	可生成扩展的多数组成部分，见PDE。
		定义好了文档的位置。

Sha Jiang 2008-10-15 14:40 发表评论

Eclipse Weed(原)

Sha Jiang — Thu, 12 Oct 2006 03:29:00 GMT

Eclipse Weed

在使用Eclipse的过程中一些小知识的收集，文中的所有描述均在Eclipse3.2环境下。(2006.11.13 最后更新 )

Eclipse曾经使用过的Workspace的列表
文件eclipse\configuration\.settings\org.eclipse.ui.ide.prefs的RECENT_WORKSPACES参数记录了该eclipse曾经使用过的工作区(它们的全路径)。MAX_RECENT_WORKSPACES参数设置了需要被记录的工作区的最多个数(默认值为5)。这些路径的列表会显示在主菜单File-->Switch Workspace...-->Workspace Lanucher中的Workspace下拉列表框内。

在启动时使用指定的工作区
eclipse.exe -data Workspace_Full_Path
注意：使用这种方法使用的工作区不会记录到 org.eclipse.ui.ide.prefs (见上一主题)中。
这可能是因为在启动时已经明确了工作区，也就不需要在 Workspace Lanucher 选择了，故Eclipse不将该信息记录到配置文件中。

Format多个文件
这一点其实很简单，右键点击需要被格式化的文件(或它所在的目录)-->Source-->Format，即可。
注意：
[1]由于该操作没有“后悔药”(即不能做undo)，所以在做之前要谨慎。
[2]如果是右键点击某个目录，那么该操作只能影响该目录当前路径下的文件，它子目录中的文件不会被格式化。

配置外部工具(External Tools)
根据Eclipse的帮助可以知道配置外部工具的一般方法（请见Eclipse3.2帮助）。但对于配置某个特定的外部工具还需要区别对待。JDK/bin中自带的javap.exe可以分解class文件，帮助我们理解程序的执行过程，是一个十分有用的工具。下面就以把javap.exe工具配置为外部工具作为例子进行讲述。
假设有目录结构：

Test是Eclipse的Java工程；src是源代码目录，其中有源代码test/Test.java文件；bin是输出目录，其中有test/Test.java被编译后生成的test/Test.calss文件。
如果我们仅仅在cmd窗口（而非Eclsipe环境中）使用javap.exe，可以在任何目录下执行如下形式的命令行（前提是已经设置了JAVA_HOME环境变量）： javap -classpath Workspace_Path\Test\bin -c test.Test
配置外部工具的步骤：
[1]通过主菜单Run-->External Tools-->External Tools...进入外部工具配置向导。
[2]选择Program项，并按左上角的新建(New Launch Configuration)按钮显示配置对话框。
[3]在Name文本框中输入这个External Tool的名称，本处写javap。
[4]在Location中填入javap.exe的路径。因为java.exe是工作区之外的程序，所以可以通过Browse File System...按钮进行选择。
[5]Working Directory文本框保持为空。
[6]Arguments中要填入执行javap命令时所需要的参数，这个参数就是前述命令行中的-classpath Workspace_Path\Test\bin -c test.Test。但我们要使该工具有通用的使用，就不可能将这个参数“写死”了。所以需要使用一些变量(Variable)来代替具体的路径。点击按钮Variables...可以看到所有的变量，我们需要使用workspace_loc，project_name和java_type_name。最终的完全参数如下所示：
-classpath ${workspace_loc}/${project_name}/bin -c ${java_type_name}
[7]点击Apply之后，就可以在工具栏的外部工具按钮(带一把红色小锁的Run图标)中发现一个名为javap的外部工具被添加进去了。
[8]选择某一个Java文件，然后点击工具栏上的外部工具按钮，即可对这个Java文件对应的class文件进行分解了。分解信息会显示在控制台中。
注意：细心的朋友肯定可以发现，上述方法有十分严重的局限性：class文件必须在bin目录下。其实对于设置外部工具的确切方法我没有完全弄清楚，主要是不懂各个Variable的确切含义，以及它们的组合规律。
又：
前面已经提到，前述的将javap.exe配置为外部工具的方法并不很好。关键在于Arguments设置的不好，以至于这种方法缺乏足够的弹性。现在我们做一些改进：
将 -classpath ${workspace_loc}/${project_name}/bin -c ${java_type_name} 修改为-classpath ${folder_prompt} -c ${java_type_name}。
在这种情况下使用外部工具javap，我们需要先选中一个Java文件(不能是它的class文件)，然后再运行外部工具javap。运行javap时，会出现一个路径选择对话框，请选择到class文件(包括它的包路径)所在的根目录。则在此处，这个路径就是 Workspace_Path\Test\bin (而不是 Workspace_Path\Test\bin\Test ) 。
注意：这种方法的自由度已经大大提高，但似乎仍然不太理想。因为我们不仅要选择一个Java文件，还需要选择一个相当于classpath的路径。所以该问题仍然需要继续关注...

使用Templat
主菜单Preferences...-->Java-->Editor-->Templates，在Templates中可以看到一些已创建的模板，均都包含4部分：
Name：模板的名称
Context：模板使用的环境
Description：对该模板功能的简单描述
Auto Insert：(目前还不懂^_^)
在Preview文本域中可以看到该模板的通用内容。下面以foreach模板为例进行讲述。
Name：foreach，即Enhanced for-Loop，是JDK5.0的新特性之一。
Context：java，即在进行Java编码时使用
Description：iterate over an array or Iterable，即遍历一个数组或一个实现了Iterable接口的对象。
Auto Insert：(无内容)
Preview的内容如下：

for (${iterable_type} ${iterable_element} : ${iterable}) {
${cursor}
}

Preview中的内容，其实也就是该模板功能的实现方式。它指示了当使用这个模板时，应该如何生成代码。 我目前还不知道${}通用元素的使用方法，主要是不知道所有的可被使用的${}通用元素及其意义。不过根据这些通用元素的名字，我们仍然能够猜测到它的意义： ${iterable_type} ，迭代器中包含的元素的类型； ${iterable_element}，声明的一个迭代器中元素的引用变量； ${iterable}，迭代器对象本身的引用变量； ${cursor}，光标的位置。
使用foreach模板：编辑Java源文件，先写入foreach，然后再接着使用组合快捷键Alt+/(使用Content Assist，即内容提示或所谓的智能感知)，此时就会出现foreach模板的提示，单击该提示即可。
创建模板，关键也是要弄清楚通用元素的使用方法。但对于不太复杂的模板，也可以不使用/少使用通用元素。不使用通用元素，会使模板的通用性差些。

设置多个Source与Output目录
通过工程Properties-->Java Build Path-->Source，可以看到该工程的默认Output目录和所有Source目录。
可以通过“Add Folder...”或“Link Folder...”为工程增加Source目录。
打开已存在的Source目录的树，可以发现Output folder，一般它的值为Default output folder。选中并编辑它，就可以为这个Source目录选择Output目录了。
最直接的方法：编辑工程根目录下的.classpath文件，在该文件中加入如下形式的语句：

即，增加一个Source目录，并为它设置一个Output目录。
工程的默认Output目录的配置语句的形式如下：
Output目录 "/>
即，它不需要对应特定的源文件目录，工程的所有源文件目录都与它关联。

指定Eclipse启动画面(Splash)
eclipse.exe -vmargs -Dosgi.splashLocation=Your_Splash_Path
Your_Splash_Path 就是所指定的启动画面的路径，必须是一张bmp格式的图片。

为什么Eclipse能够编译出不同版本的class文件？
右键点击Project-->Java Compiler-->JDK Compilance-->Compilance Level，在这个下拉列表框中可以选择不同的编译级别，目前包括1.3，1.4，5.0和6.0。
Eclipse并不使用当前系统中安装的JDK(JRE)中的编译器(javac)编译工程源代码，而是使用JDT中的编译工具来进行。这也就能够解释，为什么在系统中只安装了JDK1.4.2，但Eclipse仍然能够编译出5.0或6.0的class文件。
虽然Eclipse可以为每个工程选择不同的编译级别，且该编译行为与JDK中的javac无关，但在Eclipse中运行class所需要的JRE却必须是系统中已经安装了的。可以在主菜单Window-->Preferences-->Java-->Installed JREs中添加或选择不同的JRE。

updating...

Sha Jiang 2006-10-12 11:29 发表评论

Eclipse快捷键(摘)

Sha Jiang — Fri, 11 Aug 2006 08:30:00 GMT

摘要: Eclipse提供了丰富的快捷键，使用这些快捷键可以极大地提高操作效率。掌握部分常用的快捷键，是掌握Eclipse的一个必然要求。
本文并不是Eclipe全部快捷键的列表，而只列举一些本人用过或认为应该学会使用的快捷键。不断更新中... 阅读全文

Sha Jiang 2006-08-11 16:30 发表评论