7

我们的网站使用Apache Velocity模板语言。我们的内容管理系统已经检查任何生成的 XML 文档的格式是否正确。我们被要求在将文件推送到实时站点之前检查文档以捕获 Velocity 语法错误。

是否有从命令行验证 Velocity 模板正确性的标准方法?

我准备读取模板路径,初始化 Velocity Engine,解析模板,并捕获本页所示的任何错误,但是如果有一个现成的工具可以获取文件和配置,并吐出任何错误,那我宁愿用那个。


更新

这就是我最终做的事情:

package velocitysample;

import java.io.IOException;
import java.io.StringWriter;
import org.apache.log4j.Logger;
import org.apache.log4j.BasicConfigurator;
import org.apache.velocity.VelocityContext;
import org.apache.velocity.Template;
import org.apache.velocity.app.Velocity;
import org.apache.velocity.exception.ResourceNotFoundException;
import org.apache.velocity.exception.ParseErrorException;
import org.apache.velocity.exception.MethodInvocationException;

public class Main
{
   /** Define a static logger variable so that it references the Logger
    *  instance named "MyApp".
    */
    private static Logger logger = Logger.getLogger(Main.class);


    /**
     * @param args the command line arguments
     */
    public static void main(String[] args)
    {

        /* Set up a simple log4j configuration that logs on the console. */
        BasicConfigurator.configure();


        /* Check to see that a template path was passed on the command line. */
        if (args.length != 1)
        {
            logger.fatal("You must pass the path to a template as a " +
                    "command line argument.");
            return;
        }

        /* Pull the template filename from the command line argument. */
        String fileName = args[0];

        try
        {
            Velocity.setProperty("resource.loader", "file");
            Velocity.setProperty("file.resource.loader.class", "org.apache.velocity.runtime.resource.loader.FileResourceLoader");
            Velocity.setProperty("file.resource.loader.path", "/templates/");
            Velocity.setProperty("file.resource.loader.cache", "false");
            Velocity.setProperty("file.resource.loader.modificationCheckInterval", "0");

            Velocity.init();
        }
        catch (Exception ex)
        {
            logger.fatal("Error initializing the Veolcity engine.", ex);
            return;
        }

        boolean error = false;

        /* Create an empty Velocity context */
        VelocityContext context = new VelocityContext();

        Template template = null;

        try
        {
           template = Velocity.getTemplate(fileName);
        }
        catch( ResourceNotFoundException rnfe )
        {
           logger.error("Couldn't find the template to parse at this path: " +
                   fileName + ".", rnfe);
           error = true;
        }
        catch( ParseErrorException peex )
        {
            logger.error("Error parsing the template located at this path: " +
                    fileName + ".", peex);
            error = true;
        }
        catch( MethodInvocationException mie )
        {
            logger.error("Something invoked in the template (" + fileName +
                    ") threw an Exception while parsing.", mie);
            error = true;
        }
        catch( Exception e )
        {
            logger.error("An unexpected exception was thrown when attempting " +
                    "to parse the template: " + fileName + ".", e);
            error = true;
        }

        if (error)
        {
            return;
        }

        StringWriter sw = new StringWriter();
        try
        {
            template.merge(context, sw);
        } 
        catch (ResourceNotFoundException rnfe)
        {
            logger.error("Couldn't find the template to merge at this path: " +
                   fileName + ".", rnfe);
            error = true;
        } 
        catch (ParseErrorException peex)
        {
            logger.error("Error parsing the template at this path during merge: " +
                    fileName + ".", peex);
            error = true;
        } 
        catch (MethodInvocationException mie)
        {
            logger.error("Something invoked in the template (" + fileName +
                    ") threw an Exception while merging.", mie);
            error = true;
        } 
        catch (IOException ioe)
        {
            logger.error("Error reading the template located at this path from " +
                    "disk: " + fileName + ".", ioe);
            error = true;
        }
        catch( Exception e )
        {
            logger.error("An unexpected exception was thrown when attempting " +
                    "to merge the template: " + fileName + ".", e);
            error = true;
        }

        if (!error)
        {
            logger.info("No syntax errors detected.");
        }
    }
}
4

3 回答 3

4

有一个与 Velocity 一起分发的名为 TemplateTool 的工具,它可以转储所有引用,并且可以用来验证模板的语法。

但是,您必须正确设置上下文才能验证任何模板。所以最好的验证是用你自己的上下文编写你自己的工具。

于 2009-12-16T01:11:15.670 回答
1

要捕获 Velocity 语法错误,您的方法可能是最好的。

但是,它将忽略无效的宏参数和不存在的引用。在 Velocity 1.6 中,您可以设置一个严格模式,该模式将针对错误的宏参数(例如错误的数字)或错误的引用(例如 $abc.badMethod() )引发异常。这假设您正在填充测试工具中使用的模板的上下文,就像在生产中使用模板时一样。

于 2010-01-01T06:42:39.530 回答
1

2010 年 12 月,有人发布了一个验证 Velocity 的工具。我试了一下,效果很好。它使用 Velocity 1.6.4,但如果需要,可以将其换成不同的版本。

http://code.google.com/p/velocity-validator/

于 2012-06-06T08:25:18.347 回答