velocity基本用法

文章目录

  • 基本用法
    • 导入依赖
    • 1.基本用法
      • 1.1 注释
      • 1.2 替换变量
      • 1.3 不解析,原文输出
      • 1.4 调用对象方法
    • vtl 指令
      • set (String、int、Boolean、List、Map)
      • if 、else
      • foreach
      • include 、 parse
      • define
      • evaluate
      • macro
        • macro的注意

基本用法

导入依赖

<dependency>
  	<groupId>org.apache.velocitygroupId>
    <artifactId>velocityartifactId>
    <version>1.7version>
dependency>

创建一个公共方法,它是通过类路径来获取模板的,接下来就可以开始测试了!

public class VelocityUtils {
/**
     * 执行模板渲染
     * @param inputPath 输入路径
     * @param velocityContext 内容
     */
    public static String replace(String inputPath ,VelocityContext velocityContext){
        if(!inputPath.startsWith("\\")){
            inputPath="\\"+inputPath;
        }
        // 初始化模板引擎
        VelocityEngine ve = new VelocityEngine();
        ve.setProperty(Velocity.INPUT_ENCODING, "UTF-8");
        ve.setProperty(Velocity.OUTPUT_ENCODING, "UTF-8");
        ve.setProperty(RuntimeConstants.RESOURCE_LOADER, "classpath");
        ve.setProperty("classpath.resource.loader.class", ClasspathResourceLoader.class.getName());
        //TODO 绝对路径
//        ve.setProperty(Velocity.FILE_RESOURCE_LOADER_PATH, System.getProperty("user.dir") + "\\config\\" );
        ve.init();
        // 获取模板文件
        Template t = ve.getTemplate(inputPath);
        StringWriter sw = new StringWriter();
        t.merge(velocityContext,sw);
        //测试查看
        System.out.println(sw.toString());
        return sw.toString();
    }
}

测试类

public class Test {
    //获取模板
    private VelocityContext get(){
        VelocityContext context = new VelocityContext();
        context.put("name","王尼玛");
        Student stu = new Student();
        stu.setAge(23);
        stu.setName("王小二");
        stu.setBirth(new Date());
        context.put("stu",stu);
        return context;
    }
    @Test
    public void test1(){
        VelocityContext context = get();
        //放在resources目录下
        VelocityUtils.replace("/test/test1.html.vm",context);
    }
}

1.基本用法

1.1 注释

##注释
#**
 * TODO 多行注释
 *#

1.2 替换变量

## 基础
hello, ${name}  $name

## 若有数据则输出,无则输出空串
H$!{name}H   无$!{name2}

这里要注意:尽量用标准的写法${},否则容易导致语法错误
velocity基本用法_第1张图片

1.3 不解析,原文输出

## 不解析
#[[------
    非解析内容
    ${name}
-----]]#

输出结果

	非解析内容
    ${name}

1.4 调用对象方法

${stu.name}  ${stu.getStr()}
#set($name = "abc def")
$name.split(" ")[0]   --结果是abc

vtl 指令

set (String、int、Boolean、List、Map)

velocity基本用法_第2张图片
结果:

王尼玛 18
[1, 2, 3, 4, 5]  2
true
{name=Mike, age=12, isBoy=true}  Mike

if 、else

这个简单理解

#if($prop.name!='username' && $prop.name!='password')
..
#elseif($prop.name=='id')
..
#else
..
#end

其中,if可以识别为true的内容为:非null(java的String空串,也是识别为true!)、Boolean=true

foreach

#break可以终止循环

#循环遍历List  
#foreach($prop in $struct.cppPropList)
	$prop
#end

遍历map
velocity基本用法_第3张图片

循环内部$foreach的属性使用:

velocity基本用法_第4张图片

include 、 parse

基于类路径(在VelocityEngine 中设置读取的基本路径)

#include 包含,不会被velocity解析

#parse 会被velocity解析

#include("/template/utils/compare.vm")
#parse("/template/component/menu.vm")

define

用于定义某个公共模块,在调用之前我们可以提前定义好一些参数,然后通过模块名去调用

#set($name = "小白")
#define($common)
    hello,$name,你好呀!
#end
#set($name = "王尼玛")
$common
#set($name = "张三")
$common

velocity基本用法_第5张图片

evaluate

可以后端保存velocity语句,传入解析:

比如我们在java中:

context.put("v","#set($name = \"王尼玛\")");

模板内容如下:

#evaluate($v)
$name

解析结果:王尼玛

macro

#macro(method $name $age)
    hello!  $name, your age:$age
#end
## 调用宏,结果:hello!  Mike, your age:13
#method("Mike",13)

velocity基本用法_第6张图片

macro的注意

在使用中,有时候会用到嵌套循环,看一个例子。

java中定义一个list,内有 w1 w2 ccc 3个字符串

List<String> authRoleFind = new ArrayList<String>();
authRoleFind.add("w1");
authRoleFind.add("w2");
authRoleFind.add("ccc");
context.put("list",authRoleFind);

首先定义一个宏
velocity基本用法_第7张图片
这个时候,在一个和宏内调用了相同的List的循环,想当然的预想结果应该是:

w1 -> w1
w1 -> w2
w1 -> ccc
w2 -> w1
w2 -> w2
w2 -> ccc

velocity基本用法_第8张图片
但是它的结果却是这样的.$auth -> $name始终相等了!
velocity基本用法_第9张图片
那就和这个方法的结果一样了!
velocity基本用法_第10张图片
不知道有什么好的解决方案,反正不能用C、Java函数的思想去思考了。

或许它是将 #macro 的内容,直接copy过去再进行 编译/执行 ?

解决:在引入时,我们要防止调用时参数的名字 和 #macro中的变量名冲突!
像上面那个例子,#macro 内容中,就已经使用了$name这个参数了,所以在调用的时候#methodFind()中不要再有$name

velocity基本用法_第11张图片

小结:我们在调用一个宏的时候 例#macro(methodFind $a $b) ,尽量以相同的参数名去调用#methodFind($a $b),以防止参数名冲突

你可能感兴趣的:(Java实例,java,velocity)