大家好，又见面了，我是你们的朋友全栈君。

文章目录

基本用法

基本用法

导入依赖

<dependency>
  	<groupId>org.apache.velocity</groupId>
    <artifactId>velocity</artifactId>
    <version>1.7</version>
</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}无

这里要注意：尽量用标准的写法${},否则容易导致语法错误

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）

结果：

王尼玛 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

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

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

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)

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);

首先定义一个宏

这个时候，在一个和宏内调用了相同的List的循环，想当然的预想结果应该是：

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

但是它的结果却是这样的.auth ->

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

解决：在引入时，我们要防止调用时参数的名字和 #macro中的变量名冲突！

像上面那个例子，#macro 内容中，就已经使用了$name这个参数了，所以在调用的时候#methodFind（）中不要再有$name了

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

发布者：全栈程序员栈长，转载请注明出处：https://javaforall.cn/180158.html原文链接：https://javaforall.cn

原文地址：https://cloud.tencent.com/developer/article/2149833

velocity定义_velocity模板