add version.md

VERSIONS.md

+# QLExpress基本语法
+
+# 一、背景介绍
+
+由阿里的电商业务规则、表达式（布尔组合）、特殊数学公式计算（高精度）、语法分析、脚本二次定制等强需求而设计的一门动态脚本引擎解析工具。
+在阿里集团有很强的影响力，同时为了自身不断优化、发扬开源贡献精神，于2012年开源。
+先后出现了1.0版本和2.0版本，到3.0版本之后，引入了比较系统的语法树推导，使语法的功能大大增强和稳定。
+之前svn的开源地址： http://code.taobao.org/p/QLExpress/src/branches/
+
+# 二、有记录的版本迭代
+
+## 1、3.0.7-SNAPSHOT 版本[2014-06-06 fixed]
+BigDecimal.divide()函数增加默认的策略BigDecimal.ROUND_HALF_UP，防止在高精度要求的除法计算时，某些情况下出现以下异常。
+ava.lang.ArithmeticException: Non-terminating decimal expansion
+
+## 2、3.0.7版本[2015-01-08 fixed]
+增加ExpressRunner.getInstructionSetFromLocalCache()方法。支持阿里的某个业务系统，支持直接获取本地指令集缓存，作为业务的判断场景需求。
+
+## 3、3.0.8版本[2015-04-23 fixed]
+（1）增加指令集错误日志打印输出的控制。支付宝解析外部脚本文件，文件信息有可能出现错误，处理的时候打印log日志导致应用压力太大。
+（2）修复线上bug，该业务方不恰当的使用addFunctionMethod(class.name,methodName....)导致脚本运行期间每次去new Object（），效率变慢，影响了qps，换用了addServiceMethod（bean,methodName）之后得到解决。
+对classname-object做了一层缓存保护，保证即使误用也能够获取到较好地性能。
+
+## 4、3.0.9版本[2015-09-21 fixed] 
+（1）修复多线程下的重大bug，token使用的分隔符号数组在多线程解析脚本的情况下，有可能出现数组排序异常，导致数组中的元素混乱。
+重新问题的单元用例：
+
+http://gitlab.alibaba-inc.com/alibaba-rule-platform/qlExpress2
+
+com.ql.util.express.bugfix.CrashTest
+
+根本解决方案：在ExpressRunner创建的时候，就排序完毕，之后不再排序，保证多线程安全，同时也提升了编译器的性能和效率。
+临时解决方案：在脚本中，需要分割的地方加一些不可见字符，比如空格等。
+
+比如："单价*数量+运费"   修改成 "单价 * 数量 + 运费" 就会不受这个bug影响
+
+目前要求所有核心系统版本升级到3.0.9及以上版本。
+```xml
+<dependency>
+  <groupId>com.taobao.util</groupId>
+  <artifactId>taobao-express</artifactId>
+  <version>3.0.9</version>
+</dependency>
+```
+ 
+
+
+
+## 5、3.0.11版本[2016-1]
+(1)解决了指令中引用ExpressRunner的问题，使用分离的ExpressRunner来解决指令集运行期间相互的影响。
+
+## 6、3.0.12版本[2016-08-03]
+（1）分支迁移到git上，字符集修改为utf-8
+
+## 7、3.0.13版本[2016-08-15]
+(1)玄难通过jprofile进行性能分析，对数组的创建、数据获取采用了swapArray方式，大量的较少了Array的创建。
+(2)补上遗漏的反射缓存。
+(3)对部分对象做缓存，进一步提升性能。
+(4)解决null关键字导出变量列表的时候的bug
+(5)注意：取消了ExpressRunner.java的以下接口，主要用在自己管理指令缓存，这个可以通过clearExpressCache()实现，所以不推荐使用，万一还是想使用这个接口，请升级到3.0.17版本。
+public Object execute(InstructionSet[] instructionSets,IExpressContext<String,Object> context, List<String> errorList,
+                 boolean isTrace,boolean isCatchException, Log aLog)
+ 
+
+
+
+## 8、3.0.14版本[2016-09-13]
+(1)支持java不定参数的调用
+(2)提高数组定义的灵活性和准确性。
+
+## 9、3.0.15版本[2016-10-26]
+(1)支持Method导出，用于给菜鸟业务动态绑定函数使用
+
+## 10、3.0.16版本[2016-10-28]
+(1)支持在脚本中给任意的Object增加字段field或者方法method，比如增加string的方法，"helloworld".isNotBlank()或者"helloworld".长度  非常安全，只在脚本中生效，没有采用任何aop或者增强字节码的技术，不会影响外部的调用。
+
+## 11、3.0.17版本[2016-11-30]
+(1)考虑到老系统二方包的兼容，恢复了兼容接口ExpressRunner.execute(InstructionSet[] instructionSets....)但是不推荐使用。
+(2)bugfix 3.0.16版本特性的表达式，最后不return情况下的bug。
+
+## 12、3.0.18版本[2017-1-16]
+(1)来自开源用户的反馈，bugfix 使用addFunctionOfServiceMethod指令集无法序列化的问题。
+
+## 12、3.1.0版本[2017-3-27]
+(1)增加 | & ~ << >>位操作符
+(2)增加executeRule函数，打印出规则逻辑结构
+
+## 13、3.1.1版本[2017-4-5]
+(1)增加指令集的行数，出错的时候增加出错行数信息
+
+## 14、3.1.3版本[2017-6-4]
+(1)内部版本调整，避免其他的分支干扰，覆盖版本3.1.2版本
+
+## 15、3.1.4版本[2017-9-19]
+(1)增加instanceof 的操作符
+
+## 16、3.1.5版本[2017-11-17]
+(1)负号某些特殊情况下的解析bug：三元操作符，return
+
+## 17、3.1.6版本[2017-11-17]
+(1)bugfix 嵌套runner调用的时候，数据池的还原
+
+## 18、3.1.7版本[2017-11-17]
+(1)bugfix 在自定义操作符的情况下，调用 runner.getOutVarNames Api 可能引发的空指针问题
+
+## 18、3.1.8版本[2018-1-30]
+(1)增加扩展功能:ExpressRunner#setIgnoreConstChar(Boolean),设置可以忽略单字符操作，即 'a'自动变成"a"。
\ No newline at end of file