润乾报表之添加自定义方法。。。

Q：如何添加自定义方法

我们在开发过程中由于业务多样，内置的方法有限，或者有些不太理解，干脆就不使用了，而是想使用我们熟悉的一些工具类。

下面我们来准备一下内置方法的定义和部署使用

A：第一步-->准备方法

package com.longtu.leaf.util;

import java.util.HashMap;
import java.util.Map;

import com.runqian.base4.resources.EngineMessage;
import com.runqian.base4.resources.MessageManager;
import com.runqian.base4.util.ReportError;
import com.runqian.report4.model.expression.Expression;
import com.runqian.report4.model.expression.Function;
import com.runqian.report4.model.expression.Variant2;
import com.runqian.report4.usermodel.Context;
/**
 * @植入润乾报表的方法。根据键值获取真实值。如AA=2 获取2的值。
 * @author xiao 2014年3月31日11:49:13
 *
 */
public class RunQian_getKeyValue extends Function{

 /**
  * 
  * @param str 目标str,用来转换为map;如过程返回AA=2 则{AA=2}
  * @param key
  * @param sesign 为各键值之间的分隔符
  * @param kv_sesign 为各键与值之间的分隔符
  * @return
  */
 public static String getMapValueByKey(String str,String key,String sesign,String kv_sesign)
 {
  Map<String,String> map = convertArrToMap(str, sesign, kv_sesign);
  return map.get(key);
 }
 
 public static Map<String,String> convertArrToMap(String str,String sesign,String kv_sesign)
 {
  String _mapKey = "";
  String _mapValue = "";
  String [] convertArr = null;
  Map<String,String> map = new HashMap<String,String>();
  if(sesign == null || "".equals(sesign))
   sesign=";"; //默认
  try{
   convertArr = str.split(sesign);
   if(convertArr.length>0)
   {
    for(int i = 0;i<convertArr.length;i++)
    {
     String _keyValue [] = convertArr[i].split(kv_sesign);//键值数组
     if(_keyValue.length>0){
      _mapKey = _keyValue[0].toString().trim();
      _mapValue = _keyValue[1].toString().trim();
      map.put(_mapKey,_mapValue);
     }else{
      System.err.println("请检查目标字符串中的key-value之间是否是【"+kv_sesign+"】号隔开");
     }
    }
   }
  }catch(Exception e){
   System.err.println("com.longtu.leaf.util.RunQian_getKeyValue中的方法：【convertArrToMap】出错" + e.getMessage());
  }
  return map;
}
 
 @Override
 public Object calculate(Context ctx, boolean isInput) {
  //判断是否传参
  if(this.paramList.size()<1)
  {
   MessageManager mm = EngineMessage.get();
   throw new ReportError("encrypt:"+mm.getMessage("function.missingParam"));
  }
  //获取参数
  Expression param1 =  (Expression)this.paramList.get(0);//第1参
  Expression param2 =  (Expression)this.paramList.get(1);//第2参
  Expression param3 =  (Expression)this.paramList.get(2);//第3参
  Expression param4 =  (Expression)this.paramList.get(3);//第4参
  
  Object result1 = Variant2.getValue(param1.calculate(ctx,isInput), false, isInput);
  Object result2 = Variant2.getValue(param2.calculate(ctx,isInput), false, isInput);
  Object result3 = Variant2.getValue(param3.calculate(ctx,isInput), false, isInput);
  Object result4 = Variant2.getValue(param4.calculate(ctx,isInput), false, isInput);
  
  
  //似乎不走方法？
  String _mapKey = "";
  String _mapValue = "";
  String [] convertArr = null;
  Map<String,String> map = new HashMap<String,String>();
  if(result3 == null || "".equals(result3))
   result3=";";  //默认
  try{
   convertArr = result1.toString().split(result3.toString());
   if(convertArr.length>0)
   {
    for(int i = 0;i<convertArr.length;i++)
    {
     String _keyValue [] = convertArr[i].split(result4.toString());//键值数组
     if(_keyValue.length>0){
      _mapKey = _keyValue[0].toString().trim();
      _mapValue = _keyValue[1].toString().trim();
      map.put(_mapKey,_mapValue);
     }else{
      System.err.println("请检查目标字符串中的key-value之间是否是【"+result4+"】号隔开");
     }
    }
   }
  }catch(Exception e){
   System.out.println("com.longtu.leaf.util.RunQian_getKeyValue中的方法：【convertArrToMap】出错" + e.getMessage());
  }
  return map.get(result2.toString());
 }
 public static void main(String[] args) {
  //System.out.println(getMapValueByKey("aa=2;","aa",null,"="));
 }

}

 

这里提供了一个key-value方法，即通过字符串str='aa=2;bb=3;cc=4' 中的键值aa、bb、cc获取对应value值。

自定义方法：

　　　　　　1、继承com.runqian.report4.model.expression.Function

　　　　　　2、重写里边的calculate

具体查看以上代码。

A：第二步-->准备配置文件

src/config/跟目录下创建customFunctions.properties，内容：

#1使用方法：getMapValueByKey("aa=2;","aa",null,"=");//return 2;
fun_getMapValueByKey=0,com.longtu.leaf.util.RunQian_getKeyValue

配置方式：
 1、复制自定义方法类到 reportHome\designer\web\WEB-INF\classes 下，方法含包则相应创建。
 2、复制customFunctions.properties信息到reportHome\designer\web\WEB-INF\classes\config\

配置完成后重启生效。

问题：

由于配置完成后打开工具，找不到对应的内置方法，没关系，能调用即可。

A：第三步-->方法调用

在某个单元格表达式中：fun_getMapValueByKey(o_sumstr,"pro_requestamt",",","=")

其中fun_getMapValueByKey对应的是前面配置的属性文件中的键值。

A：第四步-->总结

接下来我们可以自定义更多自己想要定义的类，维护方便，调用方便，自己能写内置方法，再也不用含着泪看内置方法的文档了！