VTL

VTL

关注
发信
关注(28)粉丝(399)

Velocity入门系列

Velocity介绍

　　Velocity是一个java模板引擎，通过简洁的语法可以返回动态内容给浏览器使用，本系类是基于velocity官方文档（就是照着翻译，同时对不清楚的地方进行详细讲解），其实技术文档我一直推崇看官方文档，官方文档更新及时同时讲解也很详细，但是主要是需要英语基础哈哈，下面我们就开始velocity的学习了。

简单的环境搭建

　　在学习之前我们先下载jar包，由于官方文档是先进行语法学习（蛋蛋的忧桑~~~~），所以这里我先进行简单的velocity搭建， 使用的是servlet，贴代码！

　　

 Properties p = new Properties();

         p.setProperty("file.resource.loader.class", "org.apache.velocity.runtime.resource.loader.ClasspathResourceLoader");

         Velocity.init( p );

         VelocityContext context = new VelocityContext();

         context.put( "name", new String("Velocity") );

         Template template = null;

         StringWriter sw = new StringWriter();

         PrintWriter out = response.getWriter();

         try

         {

            //template = Velocity.getTemplate("cn/dota/mytemplate.vm");

            Velocity.mergeTemplate("cn/dota/mytemplate.vm", context, out);

         }

         catch( ResourceNotFoundException rnfe )

         {

            // couldn't find the template

         }

         catch( ParseErrorException pee )

         {

           // syntax error: problem parsing the template

         }

         catch( MethodInvocationException mie )

         {

           // something invoked in the template

           // threw an exception

         }

         catch( Exception e )

         {}

这里核心的就是 1-11行，这里简单的说下velocity加载模板只有文件路径和类路径（使用velocity-tool可以增加web上下文路劲配置），第二行就是指定使用类路径， context其实就是传递参数，好了简单的环境配置好了，我们就开始来学习le !!!!!!!!

目录

  1. velocity template language(VTL):介绍
  2. Hello velocity world!
  3. 注释

  4. References

  5. 格式参考标记
  6. 替代案例
  7. 指令
  8. 得到常量（$符号问题）
  9. VTL:格式化问题
  10. 其他特点和事项
  11. 反馈

velocity template language(VTL):介绍

　　VTL可以提供容易最简单最干净的方式讲动态内容放入web应用，甚至一个没有编程经验的网页开发者也能很快的使用VTL。

　　VTL使用references将动态内容嵌入到网页里面。变量是references的一种类型可以关联到java代码中定义的变量，他也可以在网页中自己定义的参数

Hello velocity world!

　　我们开始运行第一个程序

 <html>

 <body>

 #set( $foo = "Velocity" )

 Hello $foo World!

 </body>

 <html>

　　由于这个代码没有使用java传入的参数所以可以直接运行，后台模板配置好直接访问吧 修改 $foo 等于的值那么我们就可以看到不一样的结果

注释

　　单行注释 #

　　多行注释 #* 内容*#

　　当然也可以使用#**内容*#

 <html>

 <body>

 看到我1</br>##看不到我1

 看到我2</br>#*看不到我1 *#

 看到我3

 #**

 你看不到我3

 *#

 </body>

 <html>

　看下效果吧 这个比较简单

References

　　在vtl中有三种类型的references:变量、属性和方法

　　变量（Variables ）

　　可以使用字符a-z A-Z 数字0-9 中划线 下划线组成如下

　　$foo 　　$mudSlinger 　　$mud-slinger 　　$mud_slinger 　　$mudSlinger1　　
　　变量的值可以是使用$set指令也可以从java代码获取　如 #set( $foo = "bar" ) 那么foo的值就被设置为 bar

　　属性（Properties ）

　　属性的使用格式是$后面加变量 加 .  比如 $foo.bar

　　方法（Method）

　　比如$foo.getBar()   $foo.setBar("哈哈");

　　简单点讲velocity的后两种类型其实就是可以对应到java 的一个类, 此处有补充

　　我们使用变量的时候可以增加一个大括号{} 为了防止我们的变量和web中的字母混合在一起 比如 ${foo}good 就会把foo翻译 如果不加  velocity就会把整个翻译 那就会有问题了（注意 在使用指令的时候不能加{}符号 否则是会报错的）

　　我们在使用的时候最好还可以加上！ 如 $!{foo} 或者 $!foo ， 在使用的时候我们知道如果没有定义的东西velocity会直接显示或者有些为null 加上！用来强制把不存在的变量显示为空白

　　下面两个代码各位可以看看效果

<html>

<body>

Hello $!foo World!

</body>

<html>
<html>

<body>

Hello $foo World!

</body>

<html>

　　严格模式

　　velocity从1.6开始推出了严格模式， 从字面理解就是要求更严啦~比如上面出现的 未定义而使用的话就会直接泡出异常（配置属性runtime.references.strict 设置为true为严格模式）

$foo                         ## Exception

#set($bar = $foo)            ## Exception

#if($foo == $bar)#end        ## Exception

#foreach($item in $foo)#end  ## Exception

替代案例

　　现在你已经熟悉了三种使用方式那么你就可以快速的进行开发。同时velocity利用了java标准从而可以更快的进行开发

$foo

$foo.getBar()

## 也可以是这样

$foo.Bar

$data.setUser("jon")

## 也可以是这样

#set( $data.User = "jon" )

$data.getRequest().getServerName()

## 也可以是这样

$data.Request.ServerName

## 也可以是这样

${data.Request.ServerName}

　　其实相当于velocity自己后台进行了一次转化类似的javabean模式 实际上我觉得一般般看个人咯

指令

　　指令前面都是加上#符号

　　#set

#set( $primate = "monkey" )

#set( $customer.Behavior = $primate )

　　左边可以是变量或者对象属性 而右边只能是 变量，String,对象属性，对象方法，数字，ArrayList，Map

　　下面是例子

#set( $monkey = $bill ) ## variable reference

#set( $monkey.Friend = "monica" ) ## string literal

#set( $monkey.Blame = $whitehouse.Leak ) ## property reference

#set( $monkey.Plan = $spindoctor.weave($web) ) ## method reference

#set( $monkey.Number = 123 ) ##number literal

#set( $monkey.Say = ["Not", $my, "fault"] ) ## ArrayList

#set( $monkey.Map = {"banana" : "good", "roast beef" : "bad"}) ## Map
#set( $foo = "bar" )

$foo

#set( $blargh = '$foo' )

$blargh

#**

bar

$foo

**#

　　#if/#elseif/#else　

<html>

<body>

#if( $foo )

   <strong>Velocity!</strong>

#end

</body>

<html>

　　这里执行的要求是1.foo是为true的boolean 2.foo是一个不为null,空的string或者集合 3.foo是一个不为null的对象

　　看一下三种类型的简单使用

#if( $foo < 10 )

    <strong>Go North</strong>

#elseif( $foo == 10 )

    <strong>Go East</strong>

#elseif( $bar == 6 )

    <strong>Go South</strong>

#else

    <strong>Go West</strong>

#end

　　#foreach

　　例子　

<ul>

#foreach( $product in $allProducts )

    <li>$product</li>

#end

</ul>

allProducts 可以是vector,hashtable,array

如果是hashtable那么我们还可以获取键值

<ul>

#foreach( $key in $allProducts.keySet() )

    <li>Key: $key -> Value: $allProducts.get($key)</li>

#end

</ul>

veloctiy还提供了简单的方法来获取循环的个数

<table>

#foreach( $customer in $customerList )

    <tr><td>$foreach.count</td><td>$customer.Name</td></tr>

#end

</table>

同时，velocity还有 $foreach.hasNext，$foreach.last，$foreach.first， 同时 你还可以在循环的时候使用#break中断

## list first 5 customers only

#foreach( $customer in $customerList )

    #if( $foreach.count > 5 )

        #break

    #end

    $customer.Name

#end

#include

　　通过该指令可以导入自己的文件(只能是静态文件，就算导入了 .vm文件也是没用的) 多个文件可以用逗号隔开

#include("cn/dota/me.txt")

#parse

　　可以导入动态模板，但是只能传递一个参数用法和include一样

#evaluate

　　可以动态执行一个语句 类似于js中的eval

#define

　　可以定义一个类似宏的指令

#define( $block )Hello $who#end

#set( $who = 'World!' )

$block
04-27 21:09
Powered by LMLPHP ©2024 VTL 0.083128