Как создать пользовательскую директиву для Apache Velocity - PullRequest
6 голосов
/ 01 октября 2008

Я использую шаблонизатор Apache Velocity и хотел бы создать собственную директиву. То есть я хочу иметь возможность написать "#doMyThing ()" и заставить его вызывать некоторый Java-код, который я написал для генерации текста.

Я знаю, что могу зарегистрировать пользовательскую директиву, добавив строку

userdirective=my.package.here.MyDirectiveName

в мой файл speed.properties. И я знаю, что могу написать такой класс, расширив класс директивы . Чего я не знаю, так это как расширить класс Директивы - своего рода документация для автора новой Директивы. Например, я хотел бы знать, возвращает ли мой метод getType () «BLOCK» или «LINE», и я хотел бы знать, что должен делать мой метод setLocation ()?

Есть ли какая-нибудь документация, которая лучше, чем просто " Используйте источник, Люк "?

Ответы [ 5 ]

8 голосов
/ 10 сентября 2009

Я собрал небольшую статью о написании пользовательских директив скорости (и инструментов). Возможно, кто-то найдет это полезным.

4 голосов
/ 09 августа 2009

На вики Velocity есть презентация и пример кода из выступления, которое я дал под названием " Hacking Velocity ". Включает пример пользовательской директивы.

4 голосов
/ 10 июля 2009

Также пытался придумать пользовательскую директиву. Не смог найти никакой документации вообще, поэтому я посмотрел на некоторые созданные пользователем директивы: IfNullDirective (красивый и простой), MergeDirective , а также директивы для встроенной скорости.

Вот моя простая блочная директива, которая возвращает сжатый контент (полный проект с некоторыми инструкциями по установке находится здесь ):

import java.io.IOException;
import java.io.StringWriter;
import java.io.Writer;

import org.apache.velocity.context.InternalContextAdapter;
import org.apache.velocity.exception.MethodInvocationException;
import org.apache.velocity.exception.ParseErrorException;
import org.apache.velocity.exception.ResourceNotFoundException;
import org.apache.velocity.exception.TemplateInitException;
import org.apache.velocity.runtime.RuntimeServices;
import org.apache.velocity.runtime.directive.Directive;
import org.apache.velocity.runtime.parser.node.Node;
import org.apache.velocity.runtime.log.Log;

import com.googlecode.htmlcompressor.compressor.HtmlCompressor;

/**
 * Velocity directive that compresses an HTML content within #compressHtml ... #end block.
 */
public class HtmlCompressorDirective extends Directive {

    private static final HtmlCompressor htmlCompressor = new HtmlCompressor();

    private Log log;

    public String getName() {
        return "compressHtml";
    }

    public int getType() {
        return BLOCK;
    }

    @Override
    public void init(RuntimeServices rs, InternalContextAdapter context, Node node) throws TemplateInitException {
        super.init(rs, context, node);
        log = rs.getLog();

        //set compressor properties
        htmlCompressor.setEnabled(rs.getBoolean("userdirective.compressHtml.enabled", true));
        htmlCompressor.setRemoveComments(rs.getBoolean("userdirective.compressHtml.removeComments", true));
    }

    public boolean render(InternalContextAdapter context, Writer writer, Node node) 
            throws IOException, ResourceNotFoundException, ParseErrorException, MethodInvocationException {

        //render content to a variable
        StringWriter content = new StringWriter();
        node.jjtGetChild(0).render(context, content);

        //compress
        try {
            writer.write(htmlCompressor.compress(content.toString()));
        } catch (Exception e) {
            writer.write(content.toString());
            String msg = "Failed to compress content: "+content.toString();
            log.error(msg, e);
            throw new RuntimeException(msg, e);

        }
        return true;

    }

}
2 голосов
/ 18 июня 2009

До скорости v1.6 у меня была директива #blockset ($ v) #end, чтобы иметь возможность работать с многострочным #set ($ v), но теперь эта функция обрабатывается директивой #define. Настраиваемые директивы блоков - это проблема современных IDE, потому что они неправильно анализируют структуру, предполагая, что ваш #end, связанный с #userBlockDirective, является дополнительным и рисует весь файл RED. Их следует избегать, если это возможно.

Я скопировал нечто подобное из исходного кода скорости и создал директиву blockset (multiline).

import org.apache.velocity.runtime.directive.Directive;
import org.apache.velocity.runtime.RuntimeServices;
import org.apache.velocity.runtime.parser.node.Node;
import org.apache.velocity.context.InternalContextAdapter;
import org.apache.velocity.exception.MethodInvocationException;
import org.apache.velocity.exception.ResourceNotFoundException;
import org.apache.velocity.exception.ParseErrorException;
import org.apache.velocity.exception.TemplateInitException;

import java.io.Writer;
import java.io.IOException;
import java.io.StringWriter;

public class BlockSetDirective extends Directive {
    private String blockKey;

    /**
     * Return name of this directive.
     */
    public String getName() {
        return "blockset";
    }

    /**
     * Return type of this directive.
     */
    public int getType() {
        return BLOCK;
    }

    /**
     * simple init - get the blockKey
     */
    public void init( RuntimeServices rs, InternalContextAdapter context,
                      Node node )
        throws TemplateInitException {
        super.init( rs, context, node );
        /*
         * first token is the name of the block. I don't even check the format,
         * just assume it looks like this: $block_name. Should check if it has
         * a '$' or not like macros.
         */
        blockKey = node.jjtGetChild( 0 ).getFirstToken().image.substring( 1 );
    }

    /**
     * Renders node to internal string writer and stores in the context at the
     * specified context variable
     */
    public boolean render( InternalContextAdapter context, Writer writer,
                           Node node )
        throws IOException, MethodInvocationException,
        ResourceNotFoundException, ParseErrorException {
        StringWriter sw = new StringWriter(256);
        boolean b = node.jjtGetChild( 1 ).render( context, sw );
        context.put( blockKey, sw.toString() );
        return b;
    }

}
2 голосов
/ 18 октября 2008

Директивы блока всегда принимают тело и должны заканчиваться символом #end при использовании в шаблоне. например #foreach ($ i in $ foo) это тело! # Конец

Строковые директивы не имеют тела или #end. например #parse ('foo.vtl')

Вам не нужно оба с setLocation () вообще. Парсер использует это.

Любые другие особенности, с которыми я могу помочь?

Кроме того, вы рассматривали возможность использования «инструментального» подхода? Даже если вы не используете VelocityTools, чтобы автоматически сделать ваш инструмент доступным и так далее, вы можете просто создать класс инструмента, который делает то, что вам нужно, поместить его в контекст и либо иметь метод, который вы вызываете для создания контента, либо просто иметь Метод toString () создает содержимое. например $ tool.doMyThing () или просто $ myThing

Директивы лучше всего подходят для случаев, когда вам нужно связываться с внутренностями Velocity (доступ к InternalContextAdapter или фактическим узлам).

...