Jmeter MD5插件

实际业务中，会要求 HTTP 协议中附加 MD5 校验字段， 防止请求参数被恶意篡改， 对于开发同学来说， 这是个很简单的需求。 但是给自动化测试增加了难度， Jmeter 原生不支持这个功能，应测试同学要求，开发了一个简单的小插件。

一、功能分析

　　1. MD5 值生成规则：

　　　　Step1, HTTP 请求增加新参数 ct, 值为当前时间毫秒数；

　　　　Step2, 获取HTTP 请求所有参数，放入 list;

　　　　Step3, List 增加新参数 key, 值根据通信协议的双方约定(不在 http请求中传递 );

　　　　Step4, 把 List 按参数名进行排序，把排序后的参数值进行拼接， 对拼接结果执行 MD5 运算；

　　　　Step5, Http请求增加新参数 code, 值是 Step4 计算得出的值。

　　注：不同业务此规则可能略有差异，请根据实际情况实现。

　　2. MD5 值需要在 HTTP 请求之前添加 (属于 Jmeter 前置处理器范围)。

二、需要解决的问题

　　1. 在 Jmeter 的 HTTP 请求中获取参数、 增加参数

　　2. 实现 MD5 的具体逻辑

　　3. 在合适的时机把生成的 MD5 校验值附加到 HTTP 请求参数中

　　4. 集成到 Jmeter 菜单中，方便使用。

三、解决步骤

　　1. 因之前没有 Jmeter 插件开发经验， 需要先学习一下如何开发。 网上搜集了一下资料没有太明确的方案；不过Jmeter本身有很多插件，就从这里入手，分析一下现有插件的实现方式，然后用相同的方式来完成插件。

　　2. 到 Apache 官网 下载 Jmeter 的源代码（我使用的2.11版）， 根据 Jmeter 界面中看到的关键字来定位插件代码位置。

　　3. 开发的是 Http Sampler 插件，那么，我们先搜索一下Http Sampler关键字， 可以找到 HttpSampler.java；阅读代码可以得到问题1的答案。

　　4. 问题2不在赘述。

　　5. 分析问题3， 我们需要在 HTTP 请求发送前， 进行插件调用， 可以得知这个插件应该是属于前置处理器范围的。 通过分析前置处理器的代码应该可以解决这个问题。Jmeter 插件中第一个前置处理器是 BeanShell PreProcessor， 用 BeanShell 和 PreProcessor 关键字查找源代码, 查到了类 BeanShellPreProcessor.java；阅读这个类及父类代码可以得到问题3、问题4的答案。

四、具体代码

1. MD5PreProcessor.java

 public class MD5PreProcessor  extends AbstractTestElement implements TestStateListener, PreProcessor, Serializable {

     private static final long serialVersionUID = -1L;
     private static final Logger LOGGER = LoggingManager.getLoggerForClass();

     /**
      * Default constructor.
      */
     public MD5PreProcessor() {
     }

     @Override
     public void testStarted() {
     }

     @Override
     public void testStarted(String host) {
     }

     @Override
     public void testEnded() {
     }

     @Override
     public void testEnded(String host) {
     }

     /*
      * ------------------------------------------------------------------------
      * Methods implemented from interface org.apache.jmeter.config.Modifier
      * ------------------------------------------------------------------------
      */

     @Override
     public void process() {
         Sampler sam = getThreadContext().getCurrentSampler();
         HTTPSamplerBase sampler = null;
         if (!(sam instanceof HTTPSamplerBase)) {
             return;
         } else {
             sampler = (HTTPSamplerBase) sam;
         }

         // 排序参数和header(appversion, os)
         java.util.List<KeyValue> list = new ArrayList<KeyValue>();

         sampler.addArgument("ct", System.currentTimeMillis() + "");

         // 添加参数列表
         Arguments arguments = sampler.getArguments();
         PropertyIterator iter = arguments.iterator();
         while(iter.hasNext()) {
             Argument arg = getFromJMeterProperty(iter.next());
             KeyValue kv = new KeyValue(arg.getName(), arg.getValue());
             list.add(kv);
         }

         // 添加header: os appVersion
         HeaderManager headerManager = sampler.getHeaderManager();
         for(int i = 0; i < headerManager.getHeaders().size(); i++) {
             Header a = headerManager.getHeader(i);
             if("os".equals(a.getName()) || "appVersion".equals(a.getName())) {
                 list.add(new KeyValue(a.getName(), a.getValue()));
             }
         }

         // 加盐
         list.add(new KeyValue("key", "+MrK}6seb#$E"));

         StringBuffer sbu = new StringBuffer();

         // 按顺序拼接所有参数值
         Collections.sort(list);
         for(KeyValue kv : list) {
             //LOGGER.info("key: "+kv.getKey()+", value:"+kv.getValue());
             sbu.append(kv.getValue());
         }

         try {
             MessageDigest md = MessageDigest.getInstance("MD5");
             byte[] md5sum = md.digest(URLEncoder.encode(sbu.toString(), "UTF-8").getBytes());
             String md5Code = new BigInteger(1, md5sum).toString(16);

             while(md5Code.length() < 32 ){
                 md5Code = "0"+md5Code;
             }

             LOGGER.info("before: "+sbu.toString()+",encode:"+URLEncoder.encode(sbu.toString(), "UTF-8")+",end:"+md5Code);
             sampler.addArgument("code", md5Code);
         } catch(Exception e) {
             e.printStackTrace();
         }

     }

     private Argument getFromJMeterProperty(JMeterProperty o) {
         return (Argument)o.getObjectValue();
     }

     /*
      * ------------------------------------------------------------------------
      * Methods
      * ------------------------------------------------------------------------
      */
     private class KeyValue implements Comparable<KeyValue> {
         private String key;
         private String value;

         public KeyValue(String key, String value) {
             this.key = key;
             this.value = value;
         }

         @Override
         public int compareTo(KeyValue o) {
             int  result = this.key.compareTo(o.key);
             if(result == 0) {
                 result = this.value.compareTo(o.value);
             }

             return result;
         }

         public String getKey() {
             return key;
         }

         public String getValue() {
             return value;
         }
     }

 }

2. Md5PreProcessorGui.java

public class Md5PreProcessorGui extends AbstractPreProcessorGui {
    private static final long serialVersionUID = 100L;
    private static final Logger LOGGER = LoggingManager.getLoggerForClass();

    public Md5PreProcessorGui() {
        createGui();
    }

    public String getStaticLabel() {
        return "MD5 Encode";
    }

    public String getLabelResource() {
        return getClass().getCanonicalName();
    }

    public void configure(TestElement element) {
        super.configure(element);
    }

    public TestElement createTestElement() {
        MD5PreProcessor sampler = new MD5PreProcessor();
        modifyTestElement(sampler);
        return sampler;
    }

    public void modifyTestElement(TestElement element) {
        element.clear();
        configureTestElement(element);
    }

    public void clearGui() {
        super.clearGui();

    }

    private void createGui() {
        setLayout(new BorderLayout(0, 5));
        setBorder(makeBorder());

        this.setLayout(new BorderLayout(0, 5));
        this.setBorder(this.makeBorder());
        this.add(this.makeTitlePanel(), "North");

        VerticalPanel mainPanel = new VerticalPanel();
        add(mainPanel, "Center");

    }
}