EMMA 覆盖率工具
1. EMMA 介绍
EMMA 是一个开源、面向 Java 程序测试覆盖率收集和报告工具。它通过对编译后的 Java 字节码文件进行插装，在测试执行过程中收集覆盖率信息，并通过支持多种报表格式对覆盖率结果进行展示。EMMA可以统计几种覆盖率：class，method，block, line。支持版本迭代的覆盖率统计
2. EMMA 使用
EMMA基本是四步曲：插桩（instr），运行，收集（ctl），报告（report）。下面分别详细的介绍下
2.1 安装
下载地址：http://sourceforge.net/projects/emma/files/emma-testing/
目前流行使用的是v2.1.*,因为支持ctl命令
将emm.jar cp /usr/local/jdk/jre/lib/ext 下面，安装完成
2.2 插桩
command：java emma instr -cp /usr/local//anrs/lib/anrs.jar -m overwrite -ix +com.* -Dmetadata.out.file=test.em
参数介绍：
-cp，指定插桩的路径，多个jar包可以用，分割
-m：输出模式
overwrite:重新jar包，anrs.jar
default:copy, 需要加上-d参数，指定输出路径。有插桩，才cp一份class到指定路径
fullcopy:需要加上-d参数，指定输出路径。 不管有没有插桩，都cp一份class到指定路径
-merge:合并。
default：yes。 如果metadata指定输出的文件一样，将两次插桩信息进行合并
no。不合并两次插桩信息
-ix:指定需要插桩的class
+com.*: + 指包含
-com.*：-指排除
支持多个+和-，用逗号分隔
这个功能对我们关注被改动的代码很有作用
-Dmetadata.out.file: 指定元数据（metadata）输出路径。默认是当前路径
我们在测试过程中， 一般都会去更新几次jar包，并且我们希望统计出这个版本测试的覆盖率，我们就需要把几次的元数据进行合并
2.3 运行
一般情况下，直接运行应用程序即可。EMMA会启动一个监听端口，用来后面收集信息（ctl）。这个端口是固定的，47653。
如果我们的应用是多进程的，就会出现启动失败。
其实EMMA也提供了一个命令，进行端口设置：-Demma.rt.control.port=39123
还有host指定，-Demma.rt.control.host=192.168.22.22. default is localhost
这个参数需要加在程序启动命令里
EMMA还有简单的配置文件：java -Demma.properties=my.properties
my.properties format: tag=value
可以配置的参数参考：http://emma.sourceforge.net/reference/ch03s02.html#prop-ref.tables
2.4 收集
一般有两种收集信息方法：
1. 程序退出，自动收集，在当前运行目录下生成coverage.ec
2. 命令行：
java -cp /usr/jdk/jdk1.6.0_23/jre/lib/ext/emma.jar emma ctl -connect localhost:47653 -command coverage.get,coverage.ec
合并.ec文件
由于 EMMA 中测试覆盖率是通过与 “*.em” 文件关联获得代码信息的，因此当代码发生变化时，已经运行过的测试不必完全重复，只需将得到的 “*.ec” 文件合并（新得到的 “*.ec” 文件放在后面），然后关联最新的 “*.em” 文件即可得到代码变化后的覆盖率信息，这方便了 EMMA 支持版本变化的测试。在生成新的测试报告的时候，需要注意 “*.ec” 的时间一定要晚于 “*.em” 文件。
1. 自动合并。如果生成的.ec文件名字相同，自动合并。
2. 命令行合并：java -cp /usr/jdk/jdk1.6.0_23/jre/lib/ext/emma.jar emma merge -input SM1.ec, SM2.ec -outfile SM.ec
.ec 文件需要按照时间从前到后排列，才能保证合并信息正确(参考网上说法。但我测试的结果发现，自动合并与merge合并的结果不一致，自动合并的结果更准确。所以最好使用自动合并)
默认合并为coverage.es。
貌似现在的版本outfile参数不起作用，都会合并为coverage.es
清除执行统计信息
如果我们想要每个测试用例的独立覆盖率报告，需要将内存中的执行信息清除掉。
目前有两种清除方法：
1. 重启应用
2. 命令行：reset
java -cp /usr/jdk/jdk1.6.0_23/jre/lib/ext/emma.jar emma ctl -connect localhost:47653 -command coverage.reset
reset只能清除内存中记录的方法、块、行的执行信息，但是无法清除类覆盖信息。
2.5 report
command：
java -cp /usr/jdk/jdk1.6.0_29/jre/lib/ext/emma.jar emma report -r html -in anrs.em coverage.ec –sp src/-Dreport.html.out.file=coverage.html
参数介绍
-r: report type:html,txt,xml
-sp: sourcecode path
3. 会碰到的问题（来源于网上介绍，refer to
<http://www.51testing.com/?uid-170805-action-viewspace-itemid-87390>
）
3.1 issue1
"emma ctl:
coverage.get: RPC failure while executing [coverage.get]
Exception in thread "main" com.vladium.emma.EMMARuntimeException: coverage.get:
RPC failure while executing [coverage.get]
at com.vladium.emma.ctl.CtlProcessor._run(CtlProcessor.java:242)"
需要在应用执行目录下进行插桩，就可以解决这个issue
3.2 issue2
Exception in thread "main" java.lang.NoClassDefFoundError: com/vladium/emma/rt/R
T
at org.apache.jmeter.NewDriver.$VRi(NewDriver.java)
at org.apache.jmeter.NewDriver.<clinit>(NewDriver.java)
errorlevel=1
由于java加载ApacheJMeter.jar包时ClassLoader顺序非预期，通过-
Xbootclasspath/p:E:\alibaba\tools\emma-stable-2.1-lib\emma.jar 强制优先加载emma.jar。
故修改应用启动脚本为（以jemeter为例）
%JM_START% %JM_LAUNCH% -Xbootclasspath/p:E:\alibaba\tools\emma-stable-2.1-lib\emma.jar %
JVM_ARGS% %ARGS% -jar "%JMETER_BIN%ApacheJMeter.jar" %JMETER_CMD_LINE_ARGS%
4. 项目应用
4.1 项目特点
应用程序会启动多个进程，启动脚本也会执行jar包。---需要解决emma端口冲突
测试过程中，由于bug会修改代码，版本迭代。希望统计这些版本的整个覆盖率信息---emma支持多个版本的覆盖率统计
希望每个case都有自己独立的覆盖率统计信息，同时也要有整个的覆盖统计信息。
4.2 应用
每个case执行的步骤:
1. 判断是否更新了jar包
1.1 更新：插桩，指定同个文件名合并到一起
1.1.1 stop app
1.1.2 设置 EMMAPORT 环境变量
1.1.3 启动一个应用进程，指定EMMAPORT：-Demma.rt.control.port=$EMMAPORT
1.1.4 循环1.1.2 & 1.1.3,启动完所有的进程
1.2 未更新：
1.2.1 清除执行信息：
java -cp /usr/jdk/jdk1.6.0_23/jre/lib/ext/emma.jar emma ctl -connect localhost:47653 -command coverage.reset
2. 执行case
3. 收集执行信息
3.1 把所有进程的执行信息收集到一个文件里
java -cp /usr/jdk/jdk1.6.0_23/jre/lib/ext/emma.jar emma ctl -connect localhost:47653 -command coverage.get,coverage.ec
3.2 每个case需要有独立的执行信息
cp coverage.ec coverage_caseNo.ec
4. 生成报告
测试完这个版本后，生成报告
