HTML5中国

 找回密码
 立即注册

QQ登录

只需一步,快速开始

HTML5中国 首页 教程视频 实例代码 查看内容

JMeter3.0图形化HTML报告中文乱码问题处理

2016-8-29 10:43| 发布者: Hyukoh| 查看: 774| 评论: 0|原作者: Luo|来自: aloo.me

摘要: 本文主要介绍如何解决JMeter脚本中取样器(Sampler)名称定义为中文时,生成的HTML报告中中文展示为乱码的问题。

  本文主要介绍如何解决JMeter脚本中取样器(Sampler)名称定义为中文时,生成的HTML报告中中文展示为乱码的问题。


  一. 问题概述


  由于个人在JMeter 3.0的实际应用中,脚本中的Test Plan/Sampler等元件命名都没有使用中文,所以在之前介绍Dashboard Report特性的博客(原文戳这里))成文时,没有提到关于中文的问题。之后有朋友反馈,Sampler名称为中文时,生成的报告中展示为乱码,自己测试,确实如此。


  如图,脚本包含两个命名为中文的Sampler:

  执行测试后,生成的Dashboard Report图表中文乱码:


  于是通过查看官方文档和源码,找到原因并进行了解决,原打算直接追加到之前那篇文章,但考虑到篇幅过长,于是决定新成一文,然后在之前的文章中补充链接。


  二. 解决方案


  先上解决方案:修改JMeter report模块读取数据源码中的字符集设置为UTF-8,编译后替换到JMETER_HOME\lib\ext\ApacheJMeter_core.jar内


  基础方案


  •   在官网下载页面下载apache-jmeter-3.0_src.zip
  •   相关源码位置:

    apache-jmeter-3.0/src/core/org/apache/jmeter/report/core/CsvSampleReader.java

  •   将CsvSampleReader的CHARST赋值为UTF-8

private static final String CHARSET = StandardCharsets.UTF_8.displayName();

  •   编译该文件,用得到的.class文件替换JMETER_HOME\lib\ext\ApacheJMeter_core.jar内的原文件。当然也可以直接对源码重新编译打包,但会比较费时。

  效果如图:



  推荐方案


  关于设置字符编码,一个更推荐的方案是设置默认字符编码为UTF-8,同时支持.properties配置项。JMeter读写结果文件(xml/csv)的字符编码配置项是./bin/saveservice.properties文件内的_file_encoding,由org.apache.jmeter.save.SaveService.getFileEncoding(String dflt)读取,当没有在配置相中指定时,将使用方法的入参作为默认编码,这里我们传入UFT-8作为默认格式,因此将基础方案中的步骤3做如下变更:

private static final String CHARSET = SaveService.getFileEncoding(StandardCharsets.UTF_8.displayName());

  编译后替换即可。saveservice.properties文件的_file_encoding默认已配置为UTF-8,多数情况下,我们不需要修改。


  文件分享


  分享的文件和jar包是使用推荐方案进行处理。可以取用class文件自己替换进本地的ApacheJMeter_core.jar,也可以直接下载分享的jar包替换本地对应jar包。


  •   单独的CsvSampleReader.class文件:https://pan.baidu.com/s/1bo10QnX,提取码ee68
  •   处理完毕的ApacheJMeter_core.jar: https://pan.baidu.com/s/1mhKLwgw,提取码id7h

  注:github上可以看到jmeter的trunk分支已经将dashboard report的默认字符编码更改为UFT-8,本文的推荐方案即是官方更新中的实现方式。只是目前官方还没有发布更新,所以自己动手。


  三. 成因分析


  Dashboard Report特性生成HTML图表,使用JMeter记录测试结果数据的文件(命令行执行时-l指定的文件,也可在图形界面的**中指定,作为基础知识不在这里展开)作为数据源,Apache FreeMarker作为模板引擎,默认的模板位于JMETER_HOME\bin\report-template。


  •   查看官方说明,确认没有关于HTML报告字符编码的配置项。
  •   查看数据源文件,确定文件格式为UTF-8,文件中的中文正常可读,排除数据源存在问题的可能。
  •   查看生成的结果文件,主要数据在指定路径/content/js/graph.js,任选一个图表数据,查看其标签的值(“label”:”*“),显示为乱码,排除js解析成乱码的可能。
  •   此时首先想到Java文件读取过程问题,从官方发布的源码包查看源码src/core/org/apache/jmeter/report/core/CsvSampleReader,发现代码中字符编码指定为ISO8859-1:

 

package org.apache.jmeter.report.core;
//次要内容略...
public class CsvSampleReader implements Closeable{
  //次要内容略...
  private static final String CHARSET = "ISO8859-1";
  //次要内容略...
  private CsvSampleReader(File inputFile, SampleMetadata metadata, char separator, boolean useSaveSampleCfg) {
    if (!(inputFile.isFile() && inputFile.canRead())) {
      throw new IllegalArgumentException(inputFile.getAbsolutePath()
              + " does not exist or is not readable");
    }
    this.file = inputFile;
    try {
      this.reader = new BufferedReader(new InputStreamReader(
              new FileInputStream(file), CHARSET), BUF_SIZE);
    } catch (FileNotFoundException | UnsupportedEncodingException ex) {
      throw new SampleException("Could not create file reader !", ex);
    }
  }
}

  至此,问题原因得以确定。


  四. 总结


  本文主要介绍使用JMeter 3.0新特性生成HTML图形化报告时,中文标签展示为乱码的现象,成因以及简单解决方案。另外,github上JMeter的trunk分支已经有相应更新,预计在下一次版本发布中,该问题应该可以得到修复。


原文链接:http://www.aloo.me/2016/08/19/JMeter3-0%E5%9B%BE%E5%BD%A2%E5%8C%96HTML%E6%8A%A5%E5%91%8A%E4%B8%AD%E6%96%87%E4%B9%B1%E7%A0%81%E9%97%AE%E9%A2%98%E5%A4%84%E7%90%86/?utm_source=tuicool&utm_medium=referral

原文作者:Luo 

更多

鲜花

握手

雷人

路过

鸡蛋

相关阅读

最新评论

HTML5中国微信

小黑屋|关于我们|HTML5论坛|友情链接|手机版|HTML5中国 ( 京ICP备11006447号 京公网安备:11010802018489号  

GMT+8, 2017-4-26 15:57

Powered by Discuz! X3.2

© 2001-2013 Comsenz Inc.

返回顶部