ARES辅助开发工具-用户手册.doc

ARES辅助开发工具用户手册第1章产品概述5第2章安装、更新62.1安装62.2更新6第3章ARES框架介绍63.1请求63.2动作63.3对象资源7第4章新建&删除74.1工作台说明74.1.1找到打开透视图的菜单。74.1.2打开“ARES”透视图。84.1.3复原透视图。84.1.4透视图的默认效果。84.1.5问题列表94.1.6代码评审记录104.1.7修改记录104.1.8调色板（UI组件库）104.1.9接口参数（流程调试）104.1.10首选项配置104.1.11Jar包更新URL设置114.2资源树114.2.1层次结构114.2.2资源树视图选项134.3资源后缀信息汇总194.4项目194.4.1新建项目194.4.2删除项目204.4.3关闭项目214.4.4打开项目214.5模块/子模块214.5.1新建模块/子模块214.5.2删除模块/子模块224.5.3模块属性编辑224.6请求234.6.1新建请求234.6.2删除请求244.7组合动作244.7.1新建组合动作244.7.2删除组合动作264.8动作264.8.1新建动作264.8.2删除动作284.9页面294.9.1新建页面294.9.2删除页面314.10子模板314.10.1新建子模板314.10.2删除子模板334.11预览页344.11.1新建预览页344.11.2删除预览页364.12对象374.12.1新建对象374.12.2删除对象394.13测试用例404.13.1新建测试用例404.13.2删除测试用例41第5章资源编辑425.1资源操作425.1.1复制粘贴425.1.2拖动435.1.3重命名435.1.4撤消与重做455.1.5错误检查455.2编辑器485.2.1动作485.2.2组合动作595.2.3请求685.2.4测试用例715.2.5页面（页面涉及引擎配置，请见第6章）735.2.6子模板835.2.7预览页85第6章流程调试856.1添加删除断点856.2接口参数查看856.3单步调试866.4跳入866.5跳过86第7章引用资源86第8章UI组件库配置与引擎878.1引擎处理规则878.2组件库配置（xx-engine.xml）878.2.1组件类型描述878.2.2属性显示方式设置878.2.3组件配置89第9章其它功能929.1其它类型项目转换为ARES项目929.2服务器配置同步功能939.3XML格式转换工具939.4CODELET编辑器949.4.1域变量选项949.4.2引入类959.4.3智能提示959.4.4语法高亮959.4.5错误提示959.4.6异常处理969.5友包访问规则979.6保存即刷新功能979.7手动刷新功能989.8生成文档999.9JAR包更新1009.10导入包清理1009.11预览自动启动服务器1019.12中文包支持101第10章域表达式的规则和例子10110.1域表达式编辑方式10110.1.1域表达式10110.2表达式的书写规则10110.2.1域的取值设值规则：10110.2.2域的取值设值举例：10210.2.3注意事项：10210.3域表达式在动作中的使用举例10310.3.1构建代码10310.3.2属性列表10310.3.3结果列表10410.4域表达式在请求和组合动作的使用举例10410.4.1流程域10410.5域表达式在测试用例中的使用举例10510.5.1测试环境初始化：10510.5.2表达式列表：105第11章代码评审工具10611.1打开视图方式10611.2插入代码评审10611.2.1第一步：打开评审记录添加窗口。10611.2.2输入：10611.2.3生成的评审记录格式如下：10711.2.4选中类、包、或项目，视图中出现对应的评审记录10711.2.5编辑打开方式：10711.2.6编辑窗口：10811.2.7删除评审记录10811.2.8评审记录视图工具栏：10811.3插入修改记录11111.3.1第一步：打开修改记录添加窗口。11111.3.2输入：11111.3.3生成的修改记录格式如下：11211.3.4选中类、包、或项目，视图中出现对应的修改记录。11211.3.5另外，可选中评审记录，修改记录视图中显示对应的修改记录：11311.3.6编辑打开方式：11311.3.7编辑窗口：11311.3.8评审记录视图工具栏：113第1章 产品概述ARES辅助开发工具是ARES-J2EE平台的辅助工具，通过定制请求、动作、组合动作等资源，再组装成服务。而后，页面调用配置好的服务，将最终结果以页面形式展示到IE客户端中。更进一步地，工具还提供发布功能，将应用打包封装。在用户进行开发的过程中，工具通过向导、智能提示、错误提示、自动编译刷新、执行流程调试、支持测试用例开发与运行、支持发布等方式，让用户方便地进行服务组装和页面的设计和开发相关工作。工具还包含文档自动生成功能，从而使设计、开发、调试、测试、发布、文档生成集成到统一的开发平台下，从而大大提高ARES平台的易用性与开发效率。第2章 安装、更新2.1 安装公司内网下载地址：ftp:/arestoolscm:arestoolscm1（临时），下载Windows版的压缩包：ARES辅助开发工具技术预览版.zip。压缩包解压即可运行，运行程序为ares.exe。2.2 更新访问ftp:/arestoolscm:arestoolscm1（临时），“更新包”目录下有很多以日期命名的文件夹，这个名字就表示更新包的日期，用最新更新包下的plugins目录覆盖本机安装目录下的plugins目录即可。更新包后，最好在快捷方式中增加-clean参数，以便加载最新包。第3章 ARES框架介绍Ares框架有各种不同类型的服务构成。目前已有的服务类型有：请求，动作（分为普通动作和组合动作），对象资源等。另外还有模块的概念。模块类似java的包，可以把功能相近的服务放在同一个模块下，方便管理和配置。模块以文件夹的形式存在，在同一个文件夹下的服务文件都属于同一个模块。3.1 请求请求服务是框架的接口服务。框架根据请求的id定位到具体的请求。一个请求服务定义了业务流程的规则，在流程的不同节点调用不同的动作服务。一个请求的生命周期包含了一个完整业务处理的开始和结束。3.2 动作动作服务，代表一个比较独立的功能，定义了输入，输出参数，被请求服务调用。普通动作是一个java类（不允许存放于SRC下的默认模块，否则找不到该类）的描述，动作的属性代表java类的成员变量，动作的方法表示java类中的被调用方法，动作的参数表示所调用方法的参数。动作的结果可以有多个值可以是方法的返回值也可以是java类的属性。组合动作，和请求服务类似，它也定义了一个业务流程，在这个业务流程中调用其他动作。和请求服务不同的是组合动作可以被其他组合动作或请求服务调用，而请求服务不能被其他服务调用。3.3 对象资源对象资源类似与Spring中的Bean，它定义了对象的属性的设值方式。一般有2种用法。1. 描述普通的pojo，用于动作服务的属性设置。2. 描述一些系统工具类，比如数据源或连接，被其他服务使用。第4章 新建&删除4.1 工作台说明ARES辅助开发工具的界面主体就是Eclipse工作台，为了更方便用户的使用，我们添加了专门的透视图“ARES”透视图。此后所有的介绍都以这个透视图为基础。4.1.1 找到打开透视图的菜单。 4.1.2 打开“ARES”透视图。 4.1.3 复原透视图。 4.1.4 透视图的默认效果。 1. 菜单和工具栏。 2. 编辑器。 3. 视图：项目资源管理器。 4. 视图：大纲。 5. 视图：属性、控制台、代码评审、修改记录。 6. 快速视图按钮。 4.1.5 问题列表Window Show View Problems 打开问题列表视图。双击问题列表中的错误项，可即时打开对应的资源。4.1.6 代码评审记录Window Show View Other 评审 代码评审4.1.7 修改记录Window Show View Other 评审 修改记录4.1.8 调色板（UI组件库）Window Show View Other General Pelette4.1.9 接口参数（流程调试）Window Show View Other Debug 接口参数4.1.10 首选项配置Window preferences ARES辅助开发工具保存即刷新：如果选中选项是，则当保存请求、动作、测试、对象等资源时，自动发送刷新命令到后台，后台将重新编译保存的资源。预览时启动TOMCAT：如果选中选项是，则当预览页面时服务器未启动，那么自动启动TOMCAT服务器。4.1.11 Jar包更新URL设置Window preferences ARES辅助开发工具 ARES更新默认更新URL：:5551/ares-tools/jarupdate/update.xml4.2 资源树4.2.1 层次结构1. 项目2. 源代码3. 模块根4. 默认模块5. 普通模块6. 子模块（模块可任意嵌套N层）7. 分类文件夹（分类包括：action-动作、request-请求、page-页面、template-子模板、preview-预览页、test-测试用例、combineaction-组合动作、object-对象。8. 模块属性文件（存放模块的属性信息，设置模块对应的引擎，新建页面时自动选中模块对应的引擎）9. 应用根目录4.2.2 资源树视图选项打开方式：点击资源树视图右上角的三角图标。模块布局方式1、平铺方式采用平铺方式资源树上模块的显示效果2、分层方式采用分层方式资源树上模块的显示效果视图显示元素过滤1、jar包过滤Jar包过滤前Jar包过滤后2、空的分类文件夹过滤过滤前过滤后显示分类选项1、显示分类效果2、隐藏分类效果4.3 资源后缀信息汇总对象：xx.object请求：xx.request组合动作：bineaction动作：xx.action测试用例：xx.test页面：xx.page子模板：xx.template预览页：xx.preview4.4 项目4.4.1 新建项目 空白处右键 New “ARES项目”，在弹出的对话框中填入项目的名字，单击 finish 完成。 另外可创建样例工程，Create Demo Project选项选中即可。4.4.2 删除项目 项目上右键 删除，在弹出的对话框中选择是否删除项目对应的文件。 4.4.3 关闭项目 项目上右键 关闭项目。4.4.4 打开项目 项目上右键 打开项目。4.5 模块/子模块4.5.1 新建模块/子模块模块根目录或模块，右键 New “ARES模块”，在打开的窗口中选择新建位置，输入名称后，单击Finish完成。4.5.2 删除模块/子模块模块上右键 删除，在弹出的对话框中选择是否删除模块。4.5.3 模块属性编辑双击模块属性文件，打开模块属性编辑器。如果模块下没有属性文件，可采用New Other File 方式新建module.xml。如果模块下的页面相关资源没有指定引擎，页面组件库将为空。页面可通过配置方式指定处理引擎。引擎相关配置请详见：引擎处理规则。4.6 请求4.6.1 新建请求模块或子模块，右键 New “请求”，在打开的窗口中选择新建位置，输入名称后，单击Finish完成。请求分类文件夹下可直接新建请求。第一步，选择存放位置，输入名称。4.6.2 删除请求请求资源上右键 删除，在弹出的对话框中选择是否删除请求。或选中请求，直接按“DELETE”键删除。4.7 组合动作4.7.1 新建组合动作模块或子模块，右键 New “组合动作”，在打开的窗口中选择新建位置，输入名称后，单击Finish完成。组合动作分类文件夹下可直接新建组合动作。4.7.2 删除组合动作组合动作资源上右键 删除，在弹出的对话框中选择是否删除组合动作。或选中组合动作，直按按“DELETE”键删除。4.8 动作4.8.1 新建动作模块或子模块，右键 New “动作”，在打开的窗口中选择新建位置，输入名称后，进入第二步，输入实现类，单击Finish完成。动作分类文件夹下可直接新建动作。第一步，选择存放位置，输入名称。第二步，输入实现类。选择类智能提示，提示项目下所有的类，包括jar包中的类。其中类提示的热键为：CTRL+”/”。如果输入的类不存在，可点击超链接新建，并自动分析包名和类名。4.8.2 删除动作动作资源上右键 删除，在弹出的对话框中选择是否删除动作。或选中动作，直接按“DELETE”键删除。4.9 页面4.9.1 新建页面模块或子模块，右键 New “页面”，在打开的窗口中选择新建位置，输入名称后，进入第二步，选择引擎，选择根组件，输入页面说明信息（可选），单击Finish完成。页面分类文件夹下可直接新建页面。第一步，选择存放位置，输入名称。第二步，选择引擎，选择根组件，输入说明（可选）。其中引擎相关配置，请详见：引擎处理规则。选择引擎后，根组件提供下拉列表方式让用户选择，工具对组件进行了筛选，组件的page属性必须为真才能在这里显示。（详见页面根组件设置）引擎和说明信息以处理命令方式序列化到XML文件中，例：4.9.2 删除页面页面资源上右键 删除，在弹出的对话框中选择是否删除页面。或选中页面，直接按“DELETE”键删除。4.10 子模板4.10.1 新建子模板模块或子模块，右键 New “子模板”，在打开的窗口中选择新建位置，输入名称后，进入第二步，选择引擎，选择根组件，输入页面说明信息（可选），单击Finish完成。子模板分类文件夹下可直接新建子模板。第一步，选择存放位置，输入名称。第二步，选择引擎，选择根组件，输入说明（可选）。其中引擎相关配置，请详见：引擎处理规则。选择引擎后，根组件提供下拉列表方式让用户选择，工具对组件进行了筛选，组件的module属性必须为真才能在这里提示。（详见子模板根组件设置）引擎和说明信息以处理命令方式序列化到XML文件中，例：4.10.2 删除子模板子模板资源上右键 删除，在弹出的对话框中选择是否删除子模板。或选中子模板，直接按“DELETE”键删除。4.11 预览页4.11.1 新建预览页模块或子模块，右键 New “模板预览”，在打开的窗口中选择新建位置，输入名称后，进入第二步，选择引擎，选择根组件，输入页面说明信息（可选），单击Finish完成。预览页分类文件夹下可直接新建模板预览页。第一步，选择存放位置，输入名称。第二步，选择引擎，输入根组件，输入说明（可选）。其中引擎相关配置，请详见：引擎处理规则。选择引擎后，根组件提供下拉列表方式让用户选择，工具对组件进行了筛选，组件的page属性必须为真才能在这里提示。（详见页面根组件设置）引擎和说明信息以处理命令方式序列化到XML文件中，例：4.11.2 删除预览页预览页资源上右键 删除，在弹出的对话框中选择是否删除预览页。或选中预览页，直接按“DELETE”键删除。4.12 对象4.12.1 新建对象模块或子模块，右键 New “对象”，在打开的窗口中选择新建位置，输入名称后，进入第二步，输入实现类，单击Finish完成。对象分类文件夹下可直接新建对象。第一步，选择存放位置，输入名称。第二步，输入实现类。选择类智能提示，提示项目下所有的类，包括jar包中的类。其中类提示的热键为：CTRL+”/”。如果输入的类不存在，可点击超链接新建，并自动分析包名和类名。4.12.2 删除对象对象资源上右键 删除，在弹出的对话框中选择是否删除。或选中对象，直接按“DELETE”键删除。4.13 测试用例4.13.1 新建测试用例模块或子模块，右键 New “测试用例”，在打开的窗口中选择新建位置，输入名称后，单击Finish完成。测试用例分类文件夹下可直接新建测试用例。选择存放位置，输入名称。4.13.2 删除测试用例测试用例资源上右键 删除，在弹出的对话框中选择是否删除。或选中测试用例，直接按“DELETE”键删除。第5章 资源编辑5.1 资源操作5.1.1 复制粘贴快捷键(复制：Ctrl+C,粘贴：Ctrl+V)。所有配置资源支持复制粘贴操作，但是模块/子模块不支持复制粘贴操作。复制操作：粘贴操作：粘贴前：粘贴后：如果已经有重名资源，则提示是否覆盖。5.1.2 拖动按住CTRL后的拖动，相当于复制操作。不支持移动操作。目标物只能是模块，分类文件夹下不可拖入。如果已经有重名资源，则提示是否覆盖。5.1.3 重命名选中需重命名的资源，右键 重构 重命名，在弹出窗口中输入资源的新名称，单击OK完成。默认选中更新引用项，也就是引用这个资源的相关资源对该资源名称的引用也会跟着改变。重命名窗口：更新引用选项选中后，更新与此资源相关联的资源。如与hellotest关联的资源为helloaction，关联信息如下：把测试用例重命名为hellotest1，更新后，关联信息如下：同时，资源名也将重命名为hellotest1。重命名前：重命名后：5.1.4 撤消与重做快捷键（撤消：CTRL+Z，重做：CTRL+Y）。复制粘贴，移动，重命名，不支持撤消、重做操作。以下编辑器内部实现撤消、重做操作：页面预览页子模板编辑器（包括源代码视图与UI设计视图）、动作模型编辑器（源码视图只读）、请求模型编辑器（源码视图只读）、动作编辑器（源码视图只读）、请求编辑器（源码视图只读）、组合动作编辑器（包括基本信息与设计视图，源码视图只读）。上述只读视图不支持撤消重做操作。5.1.5 错误检查任何编辑器的内部错误，都会反映到资源树和问题列表中，通过错误标签来快速识别和定位错误源。错误标签示意：（其中红X表示有错误的资源）问题列表相关信息详见：问题列表。错误检查逻辑请求编辑器：友包中是否存在错误的配置，比如：友包不存在。该错误检查，只在安全性设置为模块时才起作用。导入包列表中是否存在错误的配置，比如：导入包不存在，检查导入包是否存在于classpath中。异常处理列表中，是否存在错误的异常处理类，是否存在错误的异常类型。这里指的错误，首先是检查是否存在，其次检查是否是指定类或接口的实现类或继承类。其中异常处理类必须是com.hundsun.ares.kernel.core.ExceptionListener的实现类，异常类型必须是java.lang.Exception的子类。事件处理列表中，是否存在错误的事件处理类，是否存在错误的事件类型。这里指的错误，首先是检查是否存在，其次检查是否是指定类或接口的实现类或继承类。其中异常处理类必须是com.hundsun.ares.kernel.core.ExecuteListener的实现类，事件类型必须是before和after之一。流程配置中，开始节点有且只有一个，结束节点可以有一个，必须有一个主线流程，也就是开始到结束必须有一个通路。流程中，所有的节点id必须唯一。执行节点中，动作id必须且非空。属性和参数的id和类型必须与动作配置一致，也就是说动作配置中的属性和参数只会比执行节点配置中的多，而不会比它少。属性和参数的类型和值必须一致，如String，必须是”引起来，或都对象类型为String。值必须是值的表达式（这时不需要分号结束）或者是结束必须为return语句，这时必须要有分号结束，如：#this.return和rerturn #this.return;都是合理的值。所有的值配置必须包含一般的java语法检查，如语句必须以分号结尾，类型必须在classpath下等等。执行节点的异常处理列表，异常类型必须是java.lang.Exception的子类。检查节点中，表达式列表中的值，类型必须为boolean型。检查节点的异常处理列表，异常类型必须是java.lang.Exception的子类。值处理节点中，值不需要有return语句。值处理节点的异常处理列表，异常类型必须是java.lang.Exception的子类。动作编辑器：类非空，并且类必须存在，也就是说必须在classpath下可以找到。构建代码，如果不为空，则必须返回一个类或类的子类的对象，也可以是一个接口对象。属性列表中的属性，id和类型必须与类中的属性对应。属性必须在java类中，而且必须实现set方法，注意属性有可能在父类中。方法是必须的，并且必须在类或父类中存在，参数必须与java类中的对应。参数默认值需要检查，规则如值的检查。结果列表值检查。结果列表中如果返回的是属性值，那么该属性必须有get方法,如：#this.a，那么必须有getA方法。方法返回值为void，则结果列表中不能出现返回值。导入包检查。异常处理列表检查。事件处理列表检查。友包检查。组合动作编辑器：结果列表：一般为流程域的一些值，那么要检查流程域是否存在，如#fr0.a，那么流程中必须有r0节点，该节点对应的动作中必须有id=a的结果配置。导入包检查。友包检查。流程配置检查与请求相同，稍微不同的是：执行节点的属性列表，如果执行节点对应的动作中的不存在该属性，那么该属性必须在组合动作的属性列表中配置，都不存在，则配置错误。对象编辑器：类非空，并且类必须存在，也就是说必须在classpath下可以找到。构建代码，如果不为空，则必须返回一个类或类的子类的对象，也可以是一个接口对象。属性列表中的属性，id和类型必须与类中的属性对应。属性必须在java类中，而且必须实现set方法，注意属性有可能在父类中。导入包检查。测试用例编辑器：目标ID对应的资源必须存在（在模块中或在classpath下可访问到）。测试类型为动作时，目标ID对应资源的类型必须是动作或组合动作。测试类型为请求时，目标ID对应资源的类型必须是请求。导入包检查。属性列表中的属性必须在目标的属性列表中。（注意请求中是没有属性列表的）参数列表中的参数必须在目标的方法参数列表配置中存在。（只有动作才有方法与参数的配置）表达式必须返回boolean型的值。页面：（包括预览页）根组件对应的组件配置中必须是page=”true”。必须要有引擎的配置信息。组件中必须的属性（required=”true”），必须配置。组件下只可以出现允许的组件或子组件。（Allowchild配置）设置为cdata的属性应该单独CDATA节点进行配置，否则应警告。检查无效组件。检查无效属性与事件。子模板调用时，该子模板检查是否存在。子模板属性及事件检查。子模板编辑器：根组件对应的组件必须是module=”true”。其它与页面相同。5.2 编辑器5.2.1 动作基本信息1、基本属性其中，名称为动作的中文名。生命周期范围包括：空值、singleton、request、prototype、session。点击实现类的超链接，可直接打开实现类的JAVA编辑器，如果该类不存在，则弹出JAVA类新建窗口。构建代码文本域可直接输入构建代码，双击可打开CODELET编辑器。CODELEFT编辑器说明详见CODELET编辑器。实现类标准示例（包含属性与方法的JAVADOC注释）：2、属性列表其中，属性列表中ID、类型两列数据只读不可编辑以防止用户篡改数据，其它列可编辑。默认值的编辑方式为弹出式的CODELET编辑器，描述的编辑方式为弹出式的长文本框。（通过双击单元格进入编辑模式，点击按钮弹出编辑窗口）如果与动作关联的实现类中存在属性的set方法，则可通过批量增加方式添加。点击批量增加按钮，弹出的添加窗口如下：选择需要添加的属性，点击OK按钮后，将属性添加到属性列表中。属性批量添加时，自动带入ID和类型属性，是否必须默认值为false。如需带入其它属性，则必须设置JAVADOC形式的属性注释，格式如下：/* * -m name = 属性中文名 * -m required = truefalse（是否必须） * -m desc = 属性的描述信息 * -m value = 属性的默认值 */此时批量添加的属性，会带入其它的一些属性，效果如下：当动作的JAVA实现类有变动时，可点击更新按钮进行属性的同步更新操作。更新时，也会触发方法的检查，如果执行方法有变动，则会出现如下情况：1、方法的选项卡已打开情况下，会弹出窗口说明方法已改变。用户选择最新方法或保持不变，点击OK完成。2、方法的选项卡未打开情况下，不立即弹出方法改变的说明窗口，当用户打开方法选项卡时，才会触发弹出窗口的显示。如果属性列表中属性配置与实际不符，则用红色前景提示用户，用户通过鼠标悬浮方式查看错误信息。3、方法与参数其中方法通过下拉方式提供用户选择，在选择项中，工具解析实现类及其父类中的所有public方法，以供选择参考（不包括get、set及object继承的方法）。参数列表中序号为参数的顺序号，只读。ID、类型只读不可编辑，以防止用户篡改数据，其它列可编辑。默认值编辑方式为弹出式的CODELET编辑器，描述以弹出式的长文本编辑器进行编辑。更新按钮用于在JAVA实现类的方法发生变更时，进行方法的同步更新操作，如果此时原先配置的方法已不存在或参数已发生改变，则弹出窗口通知用户，提示信息如下：选择方法后，会自动带入方法参数的ID和类型属性，是否必须默认值为false。如需带入其它属性，则必须设置JAVADOC形式的属性注释，格式如下：/* * 方法注释. * param arg0 参数注释. * -p name = 名字0 * -p value = 默认值0 * -p desc = 描述0 * param arg1 * -p name = 名字1 * -p value = 默认值1 * -p desc = 描述1 */当参数或方法与实际不符时，用前景色表示，鼠标悬浮后，有具体的错误信息提示。4、结果列表点击批量增加按钮，弹出如下所示的窗口：其中，实现get方法的属性、返回值（默认ID为result）会出现在窗口中。选中后，点击OK完成。返回值的值表达式默认为#this.return，属性的表达式默认为#this.属性名。添加数据后的结果列表：5、导入包列表第一个输入框中输入要添加的包或类，该输入框支持包和类的智能提示。输入完毕后，点击“添加到列表”，此时列表显示如下：如果导入的包或类不存在，则弹出框提示：如果选择作为package添加，则在输入的信息后+.*，截图如下：选择作为class添加，则原封不动加入到列表中。导入包添加后，在该资源的所有CODELET编辑器中，都可采用简写类的形式调用类。清理包：点击“清理包”按钮，可对当前资源的所有CODELET代码中的未导入包导入到列表中，另外如果当前导入包列表中的包没有在任何CODELET代码中用到，那么该导入包将被自动清理（也就是删除掉）。高级信息异常处理列表其中，异常处理类和异常类型支持类的智能提示输入。异常处理类必须是com.hundsun.ares.kernel.core.ExceptionListener的实现类，否则将错误提示。异常类型必须是Exception的继承类。事件处理列表其中事件处理类支持类的智能提示输入，而且必须是com.hundsun.ares.kernel.core.ExecuteListener的实现类。事件类型只有before和after选项。友包列表当资源在默认模块下，因为该资源无论怎样都可被其它资源访问，故不用设置安全性与友包。这时，工具自动将安全性和友包设置功能屏蔽，如上图所示。在其它模块中，当设置安全性为public时，那么所有的资源都可以访问该资源。这时，友包设置功能屏蔽，如下图：当设置安全性为module时，可进行友包设置：点击选择按钮，弹出窗口如下：在该窗口中，选择父模块后，子模块自动选中，点击OK完成。该弹出窗口，可自由调整大小，并自动记住。友包访问规则详见友包访问规则。测试用例信息测试用例列表选中测试用例后，可点击执行。（选中后，直接按CTRL+F5也可运行）执行结果如下：采用弹出框形式显示，该窗口为非模态窗口，可最小化。最小化时，其它编辑器照常可编辑。窗口中，用红色表示错误，绿色表示成功。单击选中用例可查看详细结果信息，双击用例可打开或激活对应的资源编辑器。可直接点击新建按钮进行新建与此动作相关联的测试用例，并自动带入所在的动作资源的ID，资源类型也会自动选择好。测试用例信息修改后，可通过同步更新按钮同步与此动作相关测试用例信息。源码视图可查看与该动作相关的配置文件XML源代码。5.2.2 组合动作基本信息基本属性名称为组件动作的中文名。友包设置参见动作友包设置。属性列表相当于动作的属性列表。该列表可自由添加，为用户添加方便，实现了另外一种添加组合动作属性方式，操作如下：拖入一个执行节点，设置动作ID，在属性TAB页中通过批量添加的方式增加一个动作的属性。右键点击该属性，选择生成属性，则可把该动作属性自动添加到组合动作的属性列表中。其中，如果该属性的值中已设置值，那么弹出用户确认框让用户选择是否覆盖原来的值，如覆盖，则将用#this.属性ID来覆盖原值。如果属性的值为空，直接用#this.属性ID来填充该属性的值。结果列表与动作的结果列表相同，与此区别的是，不提供批量添加的方式，采用手动输入方式配置。值列可通过双击进入编辑模式，再点击编辑按钮，弹出CODELET编辑器方式进行输入。描述列为长文本编辑方式。导入包列表操作方式参考动作导入包列表。高级信息异常处理列表参见动作异常处理列表。事件处理列表参见动作事件处理列表。流程配置右键 自动布局可对流程进行重排：分两种方式：垂直和水平，用户可根据需要进行排序。按住CTRL+鼠标滑轮，可放大缩小流程视图。1、执行节点：对应一个动作或组合动作，可通过两种方式添加：第一种，流程中拖入执行节点，此时，该节点没有任何配置。第二种，资源管理树中直接拖入，此时，该节点的基本信息中的动作ID已设置为刚刚拖入的那个动作（或组合动作）。其中，ID为该节点的英文名，当执行节点被拖入时，会自动给一个默认值，用户可进行修改。名称为该节点对应的中文名。一般情况下，流程配置中只显示英文名，可通过右键点击流程配置视图，选择中英文显示，修改该显示项：该设置为全局选项（选择后自动记住），也就是说在当前流程中设置显示中英文，那么其它流程配置中也将显示中英文。通过动作ID指定该执行节点对应的动作或组合动作。动作ID采用智能辅助方式方便用户输入，智能提示内容包括jar包中的动作和组合动作资源对应的ID。点击超链接，可直接打开对应动作。如果该动作不存在，则打开新建动作向导或者是新建组合动作向导。选中执行节点，右键 打开对应的动作编辑器，也是同样可以打开对应的动作。该节点对应的属性和参数列表可通过批量添加方式添加。异常处理列表：当该节点通过异常连接连接到下一节点，那么异常处理列表中，将出现该异常处理对应的条目。2、检查节点：配置表达式，运行时，判断表达式，从而决定流程运行到哪个节点。相当于SWITCH语句的图形化表示。同样，基本信息中可配置ID，中文名，描述信息。表达式列表可配置对应的表达式：类型有两个选项：script、default。默认为script，运行时当所有的表达式都为false时，执行default。值可通过CODELET编辑器进行编辑，此处为配置一个布尔表达式。异常处理与执行节点相同。3、值处理节点：通过设置命令列表，进行一些值处理的工作。基本信息、异常处理列表与检查节点相同。4、备注节点：在图形上表示为一个备注框。5、循环节点：双击节点标题栏进入编辑模式。循环节点内部为一个从开始到结束的一个子流程。默认存在一个开始和一个结束节点。循环节点内的节点不能与循环外的节点进行连接。循环节点内还可以拖入循环节点，从而可以表现嵌套层次的循环结构。如在节点外部，可通过鼠标悬浮方式，查看内部结构。6、事务节点：事务节点表示一个数据库事务，该节点内可拖入回滚节点，处理当错误发生时对事务回滚的操作。其它操作与循环节点一致。7、回滚节点：只可以拖入到事务节点中，以便错误发生时进行回滚操作。8、异常节点：表示在某一条件下，抛出的异常。连接线快捷方式切换：ATL+1：第一次一般连接线，第二次异常连接线。ATL+2：鼠标改为箭头，这时可选择节点。图元与文字分离：节点图标与文字标签分离，从而更好地布局。改变文字标签位置后，拖动节点，图元和文字标签的相对位置保持不变。测试用例信息测试用例列表参见动作测试列表。源代码视图可查看组合动作配置的XML源码信息。5.2.3 请求基本信息基本属性友包参见动作友包设置。导入包参见动作导入包列表。高级信息异常处理列表参见动作异常处理列表。事件处理列表参见动作事件处理列表。流程配置参见组合动作流程配置。测试用例信息测试用例列表参见动作测试用例列表。源代码视图可查看组合动作配置的XML源码信息。5.2.4 测试用例基本信息名称为用例的中文名。目标ID输入需要测试的目标服务。该输入提供智能提示并与测试类型绑定，如果测试类型为动作，则提示所有的动作和组合动作。如果测试类型为请求，则提示所有的请求资源。测试环境初始化详见测试环境初始化。导入包列表参见动作导入包列表。属性列表与动作属性列表相同。参数列表与动作参数列表相同。表达式列表设置测试表达式，从而验证测试是否通过。执行测试工具栏按钮：快捷方式：CTRL+F5如果执行测试时，服务器未启动，则自动启动服务器。源代码视图可查看测试用例配置的XML源码信息。5.2.5 页面（页面涉及引擎配置，请见第6章）设计与源代码视图总体布局其中1为设计视图，2为组件库，3为源代视图。设计与源码视图大小调整工具栏中对视图调整的按钮：其中第一个按钮按上下分割设计视图与源码视图。第二个按钮点击后，按左右分割视图。第三个按钮点击后，设计视图占整个页面设计部分的空间。第四个按钮点击后，源码视图点整个页面设计部分的空间。用户可根据需要进行视图和源代码的布局的调整，另外工具提供自由拖拉方式调整布局，操作方式如下：鼠标滑动至设计与源码交界处，会出现一个 图标，表示可拖动，这时点击鼠标，可任意调整设计与源码视图的大小。调色板调色板可单独做为视图打开，打开方式详见$3.1.8。可通过右键 Use classic view设置是否启用经典显示方式。组件库经典导航条显示方式：QQ导航条显示方式：组件查找功能右键点击组件工具栏，在右键菜单中选中“Find”。弹出组件查找对话框。在过滤条件中输入组件ID，支持模糊查找。点击确定后，组件工具栏自动跳到对应的分组，并选中该组件。组件工具栏显示的效果如下：组件可视化编辑组件拖放选择需要添加的组件，拖入到需要放置的容器中。这时目标容器的组件库配置中，必须把当前组件设置到allowchild属性中，这样才方可拖入。同时，allowchild属性设置时，支持继承，也就是说如果一旦配置了父组件，则继承自该父组件的所有子组件都可放入该容器组件中。布局设置如果容器组件为页面下的二级容器组件，则可通过下列方式，配置容器的布局：另外也可以在属性视图中设置layout属性的方式配置布局：选中容器组件，双击该组件，这时属性视图自动激活。点击属性TAB页，在筛选框中输入layout，在对应的条目中选择合适的布局。由于内置引擎中设置了显示方式，故用户可通下拉列表方式配置布局。显示方式通过render属性进行配置，具体显示方式设置请参见$5.1.2。事件编辑默认采用JS编辑器方式编辑，效果如下：其中按ATL+/，可智能提示JS内置方法及组件对象及组件对应的方法与公共属性。公共属性为组件配置中属性设置为public=”true”的属性。组件大小调整任何设置resize=”true”的组件都可通过拖拉方式调整组件大小，并对XML产生影响。当需要调整组件位置时，可采用拖动方式，拖动时，在视图中会显示相应的插入点位置。大纲中也支持对组件的排序，选中组件，拖放到指定层次与位置即可。引用方式一般情况下，都采用声明方式定义组件。当组件需要被复用时，采用引用方式。首先，定义好一个指定类型的组件，并设置好属性及事件。在复用处，插入一相同类型的组件，进入属性视图的基本TAB页中，选择引用方式：在ref属性的value框中输入引用组件的oid，该输入框支持智能提示，会将该页面中所有该类型组件的oid都提示出来。自动切换Tab页