Jtest简介

    Jtest是一个自动化编码错误预防产品，它能自动进行Java单元测试和编码标准兼容性检查，从而帮助开发者在更短的时间内开发出更可靠的代码。Jtest通过对类（class）进行分析，然后生成Junit格式的测试用例并自动执行，这能为开发者提供最大化的代码覆盖率，并能查找到隐蔽的运行时异常以及验证需求。通过扩展测试用例以及使用Junit测试用例，还能进行其它的附加测试。Jtest还会检查代码是否符合近700多条的编码标准规则（以及任意附加的用户自定义规则），并能自动修复大多数查找到的规则冲突。只需点击一下鼠标，开发者就能方便地定位并防止类似于隐蔽的运行时异常、功能性错误、内存泄漏、性能问题以及安全性漏洞等问题的发生。

Jtest用户界面

    当第一次启动Jtest，用户会看到如下图所示的窗口：

    图中的主窗口称为工作区（workbench）。其中的3个子窗口分别为：

         Jtest面板（位于底部）。注意面板中的选项卡包括代码覆盖率（Coverage）面板和发现的问题（Problems）面板。

         包资源面板（Package Explorer）（位于左部）。

         编辑窗口（Editor）（位于右部）。

    在工作区中打开的透视图决定了面板和编辑窗口的显示类型。上图中的显示的是Jtest透视图。通过观察包资源浏览器窗口右上方的图标可以确定当前使用的功能。如果Jtest图标的按钮为活动的，则表示当前使用的是Jtest透视图。

    如果Jtest透视图未被打开，用户可以通过选择菜单Jtest>Show View>Jtest的方式来打开Jtest透视图。同时还可以通过点击带有加号的窗口图标（上图所示位于Jtest图标左方的图标）然后选择“other”，然后在“打开透视图”窗口中选择Jtest（默认）来打开Jtest透视图。

    以下对Jtest中提供的面板进行详尽的解释。

包资源浏览器面板

    包资源浏览器面板位于Jtest用户界面的左方。包资源浏览器面板用以显示当前工作区打开项目中的Java元素的层次结构（hierarchy）。用户当前项目、包（package）、以及类文件都显示在包资源浏览器面板中。用户通过包资源浏览器面板来告知Jtest需要测试的资源或资源组合。

    Jtest默认设置为显示该面板。

Jtest面板

Jtest面板位于工作区的底部。

Jtest面板提供Jtest与用户交互的能力。除列出查找到的错误之外，Jtest面板还提供如下功能：

    修复编码标准方面的冲突

    修复单元测试方面的问题

        a. 由用户定义并验证的自动化测试用例检测到的运行时异常

        b. 由用户定义并验证的自动化测试用例检测到的断言失败（assert failures）

        c. 包括代码覆盖率错误以及内存泄漏等的剖析错误

        d. 需求实现错误

    检查未验证的输出

        a. 自动生成的断言未验证的输出

    检查未验证的单元测试错误/失败

        a. 自动化测试检测到的失败未被验证为错误

        b. 自动化测试检测到的运行时异常未被用户验证

    Jtest默认设置为显示该面板。如果用户在工作区中没有看到Jtest面板，可以通过Windows>Show View>Jtest来打开该面板。

Problems(问题)面板

    在工作区的底部，用户会看到一个名为“问题（Problems）”的选项卡。选中该选项卡后，将显示问题面板。问题面板中会列出用户资源或用户当前正在测试的资源相关的问题、警告或错误。例如，在编译时查找到用户的类定义中存在的语法错误将会显示在问题面板中。

    Jtest默认设置打开该面板，但是用户需要选中位于GUI底部的问题选项卡才能看到该面板（Jtest默认设置为底部显示Jtest面板）。

代码覆盖率面板

    在工作区的底部用户还会看到一个名为“代码覆盖率（Coverage）” 的选项卡。选中该选项卡将显示代码覆盖率面板。该面板中将显示最近一次对用户资源执行测试用例后得到的代码覆盖率。

    除上述的面板外，Jtest还包括一些其它的面板。这些面板包括“抑制（Suppressions）”面板、“测试类概要（Test Class Outline）”面板和“对象资源（Object Repository）”面板。用户可以通过Window>Show View>[想要打开的面板]来访问用户希望的面板。在这里，请打开“抑制”面板。

抑制面板

    选中相应的选项卡以显示抑制面板。在这个面板中，用户能看到个人或者团队抑制掉的编码标准。用户也能在抑制面板中来管理以及打开对某些抑制消息和错误的报告。

Jtest装入工程

    在用户使用Jtest来测试一个类之前，用户需要保证该Java工程中的类是在Jtest Eclipse、WebSphere Studio Application Developer workbench或Rational Application Developer（RAD）中可用的类。由JBuilder，Together Control Center中创建的工程以及Ant 构建文件的工程可以按照以下方法导入到Jtest中。如果用户需要测试的类在Eclipse/Application Developer、JBuilder、Together工程中或Ant构建中尚不可用，用户需要新建一个工程。

1.介绍：

    按照Eclipse的Java用户开发手册中的新建Java工程的提供的方法，用户可以根据以下两个方法来组织Java工程。

         将工程用作包（packages）的容器。如果使用这样的组织形式，所有的Java包都可以在工程里直接建立。这也是默认的组织方式。生成的类文件将存储在Java源文件中。

         将源文件夹用于包的容器。如果使用这样的组织形式，包将被直接创建在源文件夹中而不是在工程中。用户需要在工程中创建一个源文件夹作为工程的子目录，然后在这些源文件夹中创建包。

    默认的组织方式可以在选项卡面上进行修改（Window > Preferences > Java > Build Path）。

    用户可以通过Jtest>Create Project>Go to Project Configuration Tutorial来打开创建项目的教程。

2.应用：

1) 导入工程：

    如果用户某个目录中含有源文件，那么可以通过Create Project Detecting Existing Layout向导来创建新工程。

    使用该向导创建工程步骤如下：

         选择Jtest>Create Project>Detecting Existing Layout或者单击Create Project按钮后在下拉菜单中选择Create Project by Detecting Existing Layout选项。这时用户将会看到Create Project Detecting Existing Layout向导。

         在工程名（Project Name）中键入工程名。

         在目录（Directory）框中键入用户工程文件所存储目录的路径，或者通过单击浏览（Browse）按钮，在文件选择器中选择工程源文件的存储目录。

         单击完成（Finish）。

         完成上述步骤后，用户就新建了一个工程，同时，相应的环境变量的类路径（classpath）以及一些常用的第三方资源（Jars）将被加入工程的类路径（classpath）中。

2) 对于较大型的工程而言，其源文件往往不是存储在一个目录下，这时就需要对多个目录下的源文件创建工程。

    Create Project Specifying Source Folders向导将指导用户一步一步地完成Jtest设置来创建含待测试源文件的Java工程。该向导被设计来帮助用户创建源文件被存储在多个文件夹的工程。

    用户可以按照下述步骤来完成该向导的设置：

    选择Jtest>Create Project>Specifying Source Folders或者单击Create Project按钮后在下拉菜单中选择Create Project by Specifying Source Folders来打开Create Project Specifying Source Folder向导。

         在工程名（Project Name）中键入工程名。

         单击下一步（Next）打开源文件选择向导页。

         单击“添加（Add）”按钮选中含有用户源文件的目录，然后加入含有源文件的目录到源文件夹列表中。这些目录是源文件夹的直接上层目录，例如java/com/parasoft目录下的java目录。

         单击下一步（Next）打开类路径（Classpath）向导。

         单击添加（Add）按钮将工程中相应的类路径（classpath）元素加入类路径入口列表（Classpath entries list）中。

         单击完成。

3) 创建Jtest工程：

      单击File>New>Jtest Example Project。

      在打开的Jtest示例工程向导（Jtest Example Project）页面中，使用默认的设置来创建工程。

创建好的工程可以在Jtest透视图中看到。工作区左方的包资源浏览器面板将Jtest Example工程显示为当前可用的工程。

4) 导入Jbuilder工程：

    用户希望导入JBuilder工程，需要先安装Jtest-JBuilder移植（migration）程序。其步骤如下：

        如果JBuilder当前是打开的，首先关闭JBuilder。

        运行jtest_jbuilder_intergration.exe这个程序（位于[jtest安装目录]/extras目录下），然后按照屏幕上的提示进行操作。

        在安装过程中，安装程序将会显示其查找到的JBuilder的安装路径。如果安装程序查找到的路径不是用户希望指定或不正确的路径，用户可以通过直接输入路径或浏览的方式来使其指向正确的路径。

    接下来将会导入JBuilder的工程，其具体步骤如下：

        打开JBuilder。

        右键单击希望导出到Jtest中的工程，然后在快捷菜单中选择Jtest Tasks>Export Project Properties。

        指出用户希望的导出工程存储路径（推荐存放在类似桌面的易于找到的路径中），然后单击保存（Save）。一个对话提示框将显示出以供用户确认文件已经被成功的导出到Jtest中。这时用户可以关闭JBuilder。

        打开Jtest，单击File>Import，在打开的对话框中选择JBuilder Project Properties，并单击下一步（Next）。

        在下一个对话框中，为导入工程指定工程名，并且指定第3步中选定的JBuilder属性文件（properties file）的路径，单击完成。

5) Together工程：

    如果用户在Windows环境下运行Together，那么同样需要安装Jtest-Together移植程序，然后通过移植程序来导入Together工程。

    安装Jtest-Together移植程序的具体步骤是：

        如果Together当前是打开的，首先关闭Together。

        运行jtest_together_integration.exe程序（位于[Jtest安装目录]/extra目录下），然后按照屏幕上的提示进行操作。

        在安装过程中，安装程序将会显示其查找到的Together的安装路径。如果安装程序查找到的路径不是用户希望指定或不正确的路径，用户可以通过直接输入路径或浏览的方式来使其指向正确的路径。

 

    接下来将会导入Together的工程，其具体步骤如下：

        打开Together。

        进入Together后，单击File>Open Project>Browse来选中一个Java工程（扩展名为.tpr的文件），然后在文件选择器中打开该工程。打开的工程将在左方的浏览器面板中显示出来（浏览器面板，模型选项卡model tab）。

        在左方的面板中右键选中任意希望导出到Jtest中的一个结点（除与工程同名的结点外），然后选择Tools>Jtest Tasks>Export Project Properties。

        选择导出工程的存储路径（默认导出工程存放在[工程工作目录]/Jtestproject_projectname.properties目录下），然后单击保存。一个对话提示框将显示出以供用户确认文件已经被成功的导出到Jtest中。这时用户可以关闭Together。

        打开Jtest，单击File>Import，然后在打开的对话框中选择Together Project Properties，并单击下一步。

        在下一个对话框中，为导入工程指定工程名，并且指定第4步中选定的Together属性文件（properties file）的路径，单击完成。

6) 导入Ant构建文件的工程：

     单击File>Import，然后选择Ant Bulid File，并单击下一步。

     单击浏览（Browse）按钮来选择相应的构建文件（build file）。

     在打开文件（Open dialog）对话框中，打开（Jtest安装目录）\Parasoft\Jtest8.3\ex\AntExample，选中名为build.xml的文件。

     单击完成开始创建工程。请注意由这一个示例目标构建文件创建了三个工程。