公司的网站需要有些新闻,每次的新闻格式都是一样的,而不想每次都查询操作,所以想把这些新闻的页面保存成静态的html,之后搜索了下就找到了这个模板引擎,当然其他的模板引擎可以的,例如:Razor,自己写的手动替换等。NVelocity是Apache Jakarta Velocity中的一个优秀项目,有java版的(Velocity),.NET版(NVelocity),它是非常简单,易于学习和可扩展的模板引擎,并且支持.NET Core.

在NVelocity中对变量的引用都是以$开头,加上变量名称,当使用 ! 时表示为空字符串,语法都是#开头。

语法

1. 赋值指令#set

#set($book.title="test")

2.条件指令#if   if/elseif/else

#if($books.Total>1)
$books.Total
#else
没有数据
#end

3.循环指令 #foreach

#foreach($book in $books)
$book.Title
#end 高级foreach
#foreach($i in $items)
#each
每次【循环】显示的文本
#before
每次【循环前】显示的文本
#after
每次【循环后】显示的文本
#between
每【两次】【循环】显示的文本
#odd
奇数显示
#even
偶数显示
#nodata
空或者没有数据
#beforeall
循环之前显示
#afterall
循环之后显示
#end

4.引用静态资源指令 #include

#include('jquery.js') 会把当前js当作当前流插入到内容中

5.引用并解析资源指令 #parse

#parse('temo.js');
与#include不同的是,假如temp.js中有NVelocity的指令,变量进行处理,并把结果插入到当前流中;

6. 双数执行 #even   odd

#foreach(book in $books)
#even
<p>双行:$book.Title</p>
#odd
<p>单行:$book.Title</p>
#end

7. 关系运算符

AND、OR 和 NOT 操作符,分别对应&&、||和!
#if($foo && $bar)
#end

C#例子

1.Nuget中引用NVelocity

2.编写模板页(Hellovelocity.vm,也可以是Hellovelocity.html等任意的名称后缀)

<!DOCTYPE html>

<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta charset="utf-8" />
<title>$news.Title</title>
</head>
<body>
<h3>$news.Title</h3>
<div>
<span>$news.Desc</span>
</div>
<div>
$news.Content
</div>
</body>
</html>

3.编写后台程序

public static string TransformBooksToHtml(News news, string resourceTemplateName)
{
// 初始化模板引擎
VelocityEngine ve = new VelocityEngine();
ve.Init(); // 获取模板文件
Template t = ve.GetTemplate(resourceTemplateName); // 设置变量
VelocityContext ctx = new VelocityContext();
ctx.Put("news", news); // 输出
StringWriter sw = new StringWriter();
t.Merge(ctx, sw);
string message = sw.ToString();
sw.Dispose(); File.WriteAllText($@"{DateTime.Now.ToString("yyyy-MM-dd-HH-mm-ss")}.html", sw.ToString());//生成文件的路径可以自由选择 return message;
}

4. 程序调用

News news = new News() { Title = $"{DateTime.Now} 新闻", Desc = "新闻的描述信息", Content = "新闻的详细内容", CreateTime = DateTime.Now };
Console.WriteLine(MyNVelocity.TransformBooksToHtml(news, @"/NVelocityTest/Hellovelocity.html"));//这里的模板路径是NVelocityTest目录下的,可以任意

5. 查看生成的文件

<!DOCTYPE html>

<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta charset="utf-8" />
<title>// :: 新闻</title>
</head>
<body>
<h3>// :: 新闻</h3>
<div>
<span>新闻的描述信息</span>
</div>
<div>
新闻的详细内容
</div>
</body>
</html>

总结

NVelocity可以应用在很多地方,不仅仅局限于生成html页,也可以是邮件模板等。

05-11 22:22
查看更多