velocity的一些优化记录-优快云博客

本文针对Velocity模板引擎进行了详细的性能优化，包括锁优化、cache策略调整、modificationCheckInterval优化及MapGetExecutor自定义等方面，有效提升了系统的运行效率。

背景

前段时间做了个项目，主要优化一个产品页面。整个优化过程中，针对velocity的分析过程占了比较大的比重，这里做一下整理和记录。

描述

velocity版本：

1.<dependency>  
2.    <groupId>org.apache.velocity</groupId>  
3.    <artifactId>velocity</artifactId>  
4.    <version>1.6.4</version>  
5.</dependency>

优化1：锁优化

通过velocimacro.library.autoreload=false进行关闭autoreload，因为使用了同步锁，非常影响性能

1."TP-Processor20" daemon prio=10 tid=0x00002aab4c7cb800 nid=0x3d46 waiting for monitor entry [0x00000000423a3000]  
2.   java.lang.Thread.State: BLOCKED (on object monitor)  
3.    at org.apache.velocity.runtime.VelocimacroFactory.getVelocimacro(VelocimacroFactory.java:571)  
4.    - waiting to lock <0x00002aaad964ca48> (a org.apache.velocity.runtime.VelocimacroFactory)  
5.    at org.apache.velocity.runtime.RuntimeInstance.getVelocimacro(RuntimeInstance.java:1563)  
6.    at org.apache.velocity.runtime.directive.RuntimeMacro.render(RuntimeMacro.java:199)  
7.    at org.apache.velocity.runtime.parser.node.ASTDirective.render(ASTDirective.java:175)  
8.    at org.apache.velocity.runtime.parser.node.ASTBlock.render(ASTBlock.java:72)  
9.    at org.apache.velocity.runtime.parser.node.ASTIfStatement.render(ASTIfStatement.java:87)  
10.    at org.apache.velocity.runtime.parser.node.SimpleNode.render(SimpleNode.java:336)  
11.    at org.apache.velocity.Template.merge(Template.java:328)  
12.    at org.apache.velocity.Template.merge(Template.java:235)

说明：

1. velocity针对macros的自动reload，采用了同步排他锁进行控制

2. 在velocity实现中，org.apache.velocity.runtime.VelocimacroFactory.getVelocimacro中，line 569，每次获取一个宏对象，都会进行一个是否需要自动reload的逻辑控制

3. 针对设置了autoReloadLibrary为true时，velocity就会先获取一个同步锁,然后进行相应检查判断是否需要重新载入

默认是关闭的，因为公司开发的框架中针对线上和线下velocity参数设置有所不同，在开发环境开启了autoreload，所以导致在测试时发现block现象很严重。

优化2： veocity cache策略

velocity针对template查找有一定的cache策略，比如是否启用cache，cache的数量大小。resource.manager.defaultcache.size=89(默认值为89，0代表不限制)

1.TP-Processor12" daemon prio=10 tid=0x00002aab4c868800 nid=0x3d3c waiting on condition [0x0000000042abf000]  
2.   java.lang.Thread.State: RUNNABLE  
3.    at org.springframework.core.io.ClassPathResource.getFile(ClassPathResource.java:175)  
4.    at org.springframework.core.io.AbstractResource.exists(AbstractResource.java:51)  
5.    at com.alibaba.citrus.service.velocity.impl.AbstractResourceLoader.getLastModified(AbstractResourceLoader.java:72)  
6.    at org.apache.velocity.runtime.VelocimacroFactory.getVelocimacro(VelocimacroFactory.java:601)  
7.    - locked <0x00002aaad964ca48> (a org.apache.velocity.runtime.VelocimacroFactory)  
8.    at org.apache.velocity.runtime.RuntimeInstance.getVelocimacro(RuntimeInstance.java:1563)  
9.    at org.apache.velocity.runtime.directive.RuntimeMacro.render(RuntimeMacro.java:199)  
10.    at org.apache.velocity.runtime.parser.node.ASTDirective.render(ASTDirective.java:175)  
11.    at org.apache.velocity.runtime.parser.node.ASTBlock.render(ASTBlock.java:72)  
12.    at org.apache.velocity.runtime.parser.node.ASTIfStatement.render(ASTIfStatement.java:87)  
13.    at org.apache.velocity.runtime.parser.node.SimpleNode.render(SimpleNode.java:336)  
14.    at org.apache.velocity.Template.merge(Template.java:328)  
15.    at org.apache.velocity.Template.merge(Template.java:235)

1. velocity中使用ResourceManager进行资源查找，在ResourceManagerImpl资源管理查找中，定义了一份resource globalCache

2. 在globalCache.initialize()方法中，会读取定义 resource.manager.defaultcache.size配置，默认值只有89

3. global cache生效，必须要开启对应xxx.resource.loader.cache=true,这样的size调整才有意义，不然velocity个根本不会进行global cache

优化3：modificationCheckInterval优化

如果开启了优化2，则会对该Resource定期进行是否已经进行了修改的扫描，file.resource.loader.modificationCheckInterval = 2 (单位为秒，如果不需要hot deploy，可以设置更大点)

说明:

1. velocity通过ResourceManagerImpl进行资源加载，在开启优化2后，会针对从cache中返回的resource资源(velocity中模板都认为是一个resource)。

2. 针对resource会进行requiresChecking()判断，主要的依据就是modificationCheckInterval。 0代表永不做检查处理

优化4： MapGetExecutor优化处理

背景知识

Uberspect : velocity中用于Node render时进行数据解析的一个操作 (introspection/reflection interface)
- UberspectImpl : Uberspect的默认实现类
- SecureUberspector(安全调用) , LinkingUberspector(链式支持)
AbstractExecutor :velocity中实现具体$bean交互操作的工具(getMethod , render数据)
- PropertyExecutor : pojo bean的处理规则，通过getXXX()进行处理
- BooleanPropertyExecutor : boolean方法处理，通过isXXX()进行处理
- MapGetExecutor : 如果是Map的子类，通过调用map.get()方法进行处理
- GetExecutor : 默认调用bean的get()方法进行处理。我们使用的一些PullTool，比如$form.preTest.defaultInstance，就是调用了$form.get("preTest")
SetExecutor : 和AbstractExecutor相对应，是针对set进行处理.
- SetPropertyExecutor , MapSetExecutor , PutExecutor 与get处理类似。

1.protected void discover (final Class clazz)  
2.    {  
3.        Class [] interfaces = clazz.getInterfaces();  
4.        for (int i = 0 ; i < interfaces.length; i++)  
5.        {  
6.            if (interfaces[i].equals(Map.class))  
7.            {  
8.                try  
9.                {  
10.                    if (property != null)  
11.                    {  
12.                        setMethod(Map.class.getMethod("get", new Class [] { Object.class }));  
13.                    }  
14.                }  
15.  
16.        .......  
17.            }  
18.        }  
19.    }

profile截图：

代码分析：MapGetExecutor的本意是对一个class如果是Map.class的之类，就委托对应的map.get方法进行处理。但在判断是否是Map之类的过程，通过getInterfaces后进行便利匹配，性能比较差。

优化：

1. 自定义MapGetExecutor, 直接调用native方法isAssignableFrom进行Map转型判断

1.if (Map.class.isAssignableFrom(<span style="line-height: 1.5; font-size: 1em;">clazz</span><span style="line-height: 1.5; font-size: 1em;">)) { // 直接调用native方法进行,Map接口判断</span>  
2.            try {  
3.                if (property != null) {  
4.                    // 通过introspector进行method cache，同时直接查找对象clazz实例的method方法  
5.                    setMethod(introspector.getMethod(clazz, "get", new Class[] { Object.class }));  
6.                }  
7.           }

2. 自定义UberspectImpl，引入前面自定义的CustomxMapGetExecutor

1.public VelPropertyGet getPropertyGet(Object obj, String identifier, Info i) throws Exception {  
2........  
3.if (!executor.isAlive()) {  
4.            executor = new CustomxMapGetExecutor(log, claz, identifier);  
5.        }  
6......  
7.}

3. 配置velocity参数，将自定义的CustomUberspectImpl引入到velocity调用

1.runtime.introspector.uberspect=xxxx.velocityx.CustomUberspectImpl

总结一下

最后的优化参数列表

1.file.resource.loader.cache = true  
2.file.resource.loader.modificationCheckInterval = 0 #不检查  
3.resource.manager.defaultcache.size=0 #无限制  
4.  
5.velocimacro.library.autoreload=false  
6.  
7.runtime.introspector.uberspect = xxxx.velocityx.CustomUberspectImpl

velocity的几个概念

Resource ：在velocity中每个模板都可以用一个Resource来表示，类似于velocity资源概念。
Node : 在velocity中系统引擎对resource解析后的生成的Node对象，可以理解为语法树等概念。主要的基类：SimpleNode
Directive : 在velocity系统中定义的一系统指令，比如#foreach ,#if, #macro等。
EventHandler & EventCartridge : velocity系统中提供的扩展机制，可以监听在velocity解析，渲染，异常过程中进行自定义的业务处理。比如我们的校长大人的安全框架，在webx3上已经被宝宝内嵌到velocity指令级别，而不是原先定义的宏概念。比如$sql和#escapse('sql')$value#end

说明：