什么是Velocity指令
在Velocity中,#set,#if, #foreach, #elseif, #parse等,以#开头的称之为指令,Velocity内置的这些指令可以用来做赋值,条件判断,循环控制等脚本语言必备的逻辑控制等语句,Velocity的指令是可扩展的,即用户可以根据实际的需要自定义Velocity指令
自定义指令(Directive)的一般步骤
1.定义自定义指令对应的Java代码,这个需要继承自org.apache.velocity.runtime.directive.Directive,覆盖其中的三个抽象方法,
- getName(表示指令的名字,下面的例子中,自定义指令的名字是test)
- getType(表示是行级指令还是块级指令,行级指令解析得到的只有一行,不需要#end指令表明指令结束;而块级指令则需要使用#end显示的指明指令的结束)
- render( public boolean render(InternalContextAdapter context, Writer writer,Node node),用于根据需要,对vm页面进行渲染,以返回期望在页面上显示的值)
2. 在vm文件中使用自定义指令,比如#test,每个指令可以有参数,需要再#test的API文档中清楚说明,例如示例中的#test指定可以包含3个参数
3. 在velocity.properties中指明用户自定义的指令类
指令Java代码
package com.tom.directive import org.apache.velocity.VelocityContext; import org.apache.velocity.app.VelocityEngine; 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.runtime.directive.Directive; import org.apache.velocity.runtime.parser.node.Node; import org.apache.velocity.runtime.parser.node.SimpleNode; import java.io.IOException; import java.io.Serializable; import java.io.StringWriter; import java.io.Writer; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; public class TestDirective extends Directive { private static final VelocityEngine velocityEngine = new VelocityEngine(); @Override public String getName() { return "test"; } @Override public int getType() { return LINE; } @Override public boolean render(InternalContextAdapter context, Writer writer, Node node) throws IOException, ResourceNotFoundException, ParseErrorException, MethodInvocationException { SimpleNode sn = (SimpleNode) node.jjtGetChild(0); String value = (String) sn.value(context); sn = (SimpleNode) node.jjtGetChild(1); Serializable s = (Serializable) sn.value(context); sn = (SimpleNode) node.jjtGetChild(2); Object data = sn.value(context); Map map = new HashMap(); List<String> strings = new ArrayList<String>(); strings.add("MSN"); strings.add("QQ"); strings.add("Gtalk"); map.put("data", strings); String vel = "#foreach($element in $data) \n<li>$element</li>\n #end"; writer.write(renderTemplate(map, vel)); return true; } public static String renderTemplate(Map params, String vimStr) { VelocityContext context = new VelocityContext(params); StringWriter writer = new StringWriter(); velocityEngine.evaluate(context, writer, "", vimStr); return writer.toString(); } }
velocity代码
<html> <body> <div id="123"> #test("Attribute1","Attribute2","Attribute3") </div> </body> </html>
velocity.properties文件的修改
需要把velocity.properites文件放到classpath根目录,在userdirective这个节点添加用户自定义的指令,多个指令类需要用,\进行分割
userdirective=com.tom.directive.DevelopmentDirective,\ com.tom.directive.TestDirective
示例结果
以上代码经Velocity模板引擎解析后,得到的结果是
<html> <body> <div id="123"> <li>MSN</li> <li>QQ</li> <li>Gtalk</li> </div> </body> </html>
相关推荐
4. **可扩展性**:Velocity支持自定义指令和工具,可以轻松扩展其功能以满足特定需求。 5. **性能**:Velocity在执行速度上表现出色,因为它在编译时就生成了Java字节码,从而提高了运行效率。 **依赖关系:** 在...
1. **模板引擎**:Velocity提供了一个强大的模板引擎,允许开发者使用简单的文本格式来创建动态页面,模板中的指令由#号开头,如#{if}、#{foreach}等。 2. **模板语言**:Velocity模板语言(VTL)是 Velocity 的...
1. **模板(Template)**:模板是Velocity的核心,它是HTML或XML等静态页面中嵌入了Velocity指令的文件,用于生成最终的输出文档。 2. **上下文(Context)**:上下文是模板和应用程序之间的桥梁,它存储了模板需要...
- 自定义指令:可以通过扩展Velocity,编写自定义指令以满足特定需求。 7. **最佳实践** - 尽量避免在模板中进行复杂的逻辑处理,保持模板简洁。 - 合理使用`#set`指令,避免全局变量污染。 - 使用`#macro`定义...
5. **指令集**:Velocity提供了一系列内置指令,如#set、#if、#foreach等,用于控制模板的逻辑流程。 6. **可扩展性**:Velocity允许自定义宏库和工具,进一步扩展其功能。 ### 使用示例 在Velocity模板中,我们...
当使用#set 指令时,括在双引号中的字面字符串将解析和重新解释,如下所示: #set($directoryRoot = "www" ) #set($templateName = "index.vm" ) #set($template = "$directoryRoot/$templateName" ) $template 输出...
3. 指令:Velocity提供了一系列内置指令,如#set、#if、#foreach、#include等,用来控制模板逻辑。 4. 宏:定义可复用的代码块称为宏,可以通过`#macro`指令定义,通过`#end`指令结束。 #### velocity.properties...
4. **宏**:Velocity 支持宏定义,类似于 HTML 中的自定义标签,可以复用和封装代码,增强模板的模块化。 5. **指令集**:Velocity 提供了多种内置指令,如 #if, #foreach, #set 等,用于控制流程和处理数据。 ** ...
- **可扩展性强**:Velocity 支持自定义指令和工具,可以根据需求进行扩展。 **5. 实战经验分享** 在实际项目中,`Java的模板引擎Velocity初体验.doc` 可能包含了初学者如何快速上手 Velocity 的步骤和常见问题。...
4. **可扩展性**:Velocity允许自定义宏库和工具方法,增强了模板的功能和灵活性。 总的来说,Velocity作为一个强大的模板引擎,为Java开发者提供了便利的手段来生成动态内容,提高开发效率和代码的可维护性。通过...
4. **可扩展性**: Velocity支持自定义指令和宏,可以轻松地扩展功能以满足特定需求。 5. **社区支持**: 作为Apache项目,Velocity有着丰富的文档和活跃的社区支持,遇到问题时可以得到及时的帮助。 **Velocity核心...
- **强大的内置指令**:Velocity 提供了丰富的内置指令,如 #if、#foreach、#set 等,用于控制流程和数据处理。 - **良好的扩展性**:Velocity 支持自定义方法和宏,可以轻松扩展其功能。 在实际应用中,Velocity ...
- 配置Velocity引擎涉及到设置资源加载器、缓存策略、错误处理以及自定义指令等。 - 通过调整配置,可以优化Velocity的性能和适应不同项目需求。 5. **Velocity与MVC模式** - 在Model-View-Controller架构中,...
在Velocity中,开发者定义了模板(Template),这些模板包含HTML、CSS和JavaScript等静态内容,以及Velocity指令(如#set、#if、#foreach等)。Velocity引擎负责解析这些模板,执行嵌入的Java代码,并将结果合并到...
4. **可扩展性**:Velocity 支持自定义指令和方法,可以根据需求扩展其功能。 通过这个简单的 "Velocity 小 demo",你可以了解到 Velocity 如何工作以及如何在实际项目中使用它。进一步深入学习,你会发现 Velocity...
Velocity 允许自定义指令和事件处理器,以适应特定的业务需求。 总结,Velocity API 提供了一套强大且灵活的工具,帮助开发者构建高效的数据驱动的模板。通过理解和熟练运用 Velocity API,我们可以创建出既美观又...
1. **模板(Template)**:模板是Velocity的基本元素,它是HTML或其他格式的文档,其中包含Velocity指令和变量。在运行时,这些指令和变量会被替换为相应的值。 2. **变量(Variable)**:在模板中,变量以`$`符号...
- **自定义指令(Directives)**:你可以通过扩展 Velocity,实现自定义的 VTL 指令,满足特定需求。 - **事件处理器(Event Handlers)**:Velocity 提供了一套事件处理机制,允许你在模板解析和渲染过程中进行...