国产亚洲一区二区三区在线,在线观看午夜亚洲一区,国产精品亚洲A∨天堂不卡

TrampEagle — Wed, 31 May 2006 14:03:00 GMT

Velocity��?br />原文引自�Q?a >http://www.3doing.net/forums/dispbbs.asp?boardID=57&ID=593&page=1

Velocity是一个开放源吗的模版引擎�Q�由apache.org��组负责开发，现在最新的版本是Velocity1.3.1
http://jakarta.apache.org/velocity/index.html 可以了解Velocity的最��C��息�?br /> Velocity允许我们在模版中讑֮�变量�Q�然后在�q�行�Ӟ��动态的��数据插入到模版中，替换�q�些变量�?br /> 例如�Q?br />

<HTML>
HELLO $CUSTOMERNAME
HTML>

我们可以在运行时得到客户的名字，然后把它插入到这个模版中替换变量$CUSTOMERNAME�Q�整个替换过�E�是由Velocity�q�行控制的，而且java的调用代码也非常��?br /> 如我们可以在java代码中这栯��?br />

//�q�个文�g中设定了Velocity使用的log4j的配�|�和Velocity的模版文件所在的目录
Velocity.init("D:\\Template\\resource\\jt.properties");
//模版文�g名，模版文�g所在的路径在上一条语句中已经讄��?/font>
Template template =Velocity.getTemplate("hello.vm", "gb2312");
//实例化一个Context
VelocityContext context = new VelocityContext();
//把模版变量的��D��|�到context�?/font>
context.put("CUSTOMERNAME", "My First Template Engine ---- Velocity.");
//开始模版的替换
template.merge(context, writer);
//写到文�g�?/font>
PrintWriter filewriter = newPrintWriter(newFileOutputStream(outpath),true);
filewriter.println(writer.toString());
filewriter.close();

    �q�就是整个java的代码，非常的简单。如果我们有多个模版变量�Q�我们仅需要把�q�些模版变量的��D��|�到context中�?br />
    下面我们��单的分析一下，Velocity引擎��d��模板文�g�Ӟ��它直接输出文件中所有的文本�Q�但�?字符开头的除外�Q?�W�号标识着一个模版变量位�|�，context.put("CUSTOMERNAME", "My First Template Engine ---- Velocity.");当Velocity模板引擎解析�q�输出模板的�l�果�Ӟ��模板中所有出�?CUSTOMERNAME的地斚w��插入客��L��名字�Q�即被加入到VelocityContext的对象的toString()�Ҏ��q�回值将替代Velocity变量�Q�模板中�?开头的变量�Q��?br />    模板引擎中最强大、��用最频繁的功能之一是它通过内徏的映�?/b>�Q�Reflection�Q�引擎查扑֯�象信息的能力。这个映像引擎允许用一�U�方便的Java�?”类似的操作�W�，提取��L��加入到VelocityContext的对象的��M��公用�Ҏ��的��|��或对象的��L��数据成员。映像引擎还带来了另外一个改�q�：快速引用JavaBean的属性。��用JavaBean属性的时候，我们可以忽略get�Ҏ��和括受��请看下面这个模板的例子�?br />

    <HTML>

            Name:         $Customer.Name()
            Address:    $Customer.Address()
            Age:        $Customer.Age()

    HTML>

    java的代码：

    //讄��客户信息
    Customer mycustomer = new Customer();
    mycustomer.setName("Velocity");
    mycustomer.setAddress("jakarta.apache.org/velocity/index.html");
    mycustomer.setAge(2);

    //�q�个文�g中设定了Velocity使用的log4j的配�|�和Velocity的模版文件所在的目录
    Velocity.init("D:\\Template\\resource\\jt.properties");
    //模版文�g名，模版文�g所在的路径在上一条语句中已经讄��?/font>
    Template template =Velocity.getTemplate("hello.vm", "gb2312");
    //实例化一个Context
    VelocityContext context = new VelocityContext();
    //把模版变量的��D��|�到context�?/font>
    context.put("Customer", mycustomer);
    //开始模版的替换
    template.merge(context, writer);
    //写到文�g�?/font>
    PrintWriter filewriter = newPrintWriter(newFileOutputStream(outpath),true);
    filewriter.println(writer.toString());
    filewriter.close();

    输出�l�果�Q?br />
    <HTML>

            Name:        Velocity
            Address:    jakarta.apache.orgvelocityindex.html
            Age:        2

    HTML>

    除了替换变量之外�Q�象Velocity高��引擎�q�能做其他许多事情，它们有用来比较和�q�代的内建指令，通过�q�些指��o我们可以完成�E�序语言中的条�g判断语句和��@环语句等

    例如�Q�我们想要输出年龄等�?的所有客��L��信息�Q�我们可以这样定义我们的模版
    模版�Q?br />
    <HTML>








                #foreach ($Customer in $allCustomer)
                    #if($Customer.Age()=="2")










                    #end
                #end


名称地址 �q�龄

$Customer.Name() $Customer.Address() $Customer.Age()


    HTML>


    java的代码：

    //讄��客户信息
    ArrayList allMyCustomer = newArrayList();

    //客户1
    Customer mycustomer1 = new Customer();
    mycustomer1.setName("Velocity");
    mycustomer1.setAddress("jakarta.apache.org/velocity/index.html");
    mycustomer1.setAge(2);

    //客户2
    Customer mycustomer2 = new Customer();
    mycustomer2.setName("Tomcat");
    mycustomer2.setAddress("jakarta.apache.org/tomcat/index.html");
    mycustomer2.setAge(3);

    //客户3
    Customer mycustomer3 = new Customer();
    mycustomer3.setName("Log4J");
    mycustomer3.setAddress("jakarta.apache.org/log4j/docs/index.html");
    mycustomer3.setAge(2);

    //��d��到allMyCustomer(ArrayList)�?
    allMyCustomer.add(mycustomer1);
    allMyCustomer.add(mycustomer2);
    allMyCustomer.add(mycustomer3);

    //�q�个文�g中设定了Velocity使用的log4j的配�|�和Velocity的模版文件所在的目录
    Velocity.init("D:\\Template\\resource\\jt.properties");
    //模版文�g名，模版文�g所在的路径在上一条语句中已经讄��?/font>
    Template template =Velocity.getTemplate("hello.vm", "gb2312");
    //实例化一个Context
    VelocityContext context = new VelocityContext();
    /**
     * 注意�q�里我们仅仅需要给一个模版变量负�?/font>
     */
    context.put("allCustomer", allMyCustomer);
    //开始模版的替换
    template.merge(context, writer);
    //写到文�g�?/font>
    PrintWriter filewriter = newPrintWriter(newFileOutputStream(outpath),true);
    filewriter.println(writer.toString());
    filewriter.close();

    �l�果�Q?br />
    <HTML>






























名称地址 �q�龄

Velocity jakarta.apache.orgvelocityindex.html 2

Log4J jakarta.apache.orglog4jdocsindex.html 2


    HTML>

    #IF语句完成逻辑判断�Q�这个我想不用多说了�?br />    allCustomer对象包含零个或者多个Customer对象。由于ArrayList(List,HashMap,HashTable,Iterator,Vector�{?属于Java Collections Framework的一部分�Q�我们可以用#foreach指��o�q�代其内宏V��我们不用担心如何定型对象的�c�d��——映像引擎会为我们完成这个�Q务�?foreach指��o的一般格式是�?foreach in ”�?foreach指��o�q�代list�Q�把list中的每个元素攑օ�item参数�Q�然后解�?foreach块内的内宏V��对于list内的每个元素�Q?foreach块的内容都会重复解析一�ơ。从效果上看�Q�它相当于告诉模板引擎说�Q�“把list中的每一个元素依�ơ放入item变量�Q�每�ơ放入一个元素，输出一��?foreach块的内容”�?br />
    MVC设计模型�Q?br />    使用模板引擎最大的好处在于�Q�它分离了代码（或程序逻辑�Q�和表现�Q�输出）。由于这�U�分��，你可以修改程序逻辑而不必担心邮件消息本�w�；�c�M��圎ͼ�你（或公关部门的职员�Q�可以在不重新编译程序的情况下，重新�~�写客户列表�?实际上，我们分离了系�l�的数据模式�Q�Data Model�Q�即提供数据的类�Q�、控制器�Q�Controller�Q�即客户列表�E�序�Q�以及视图（View�Q�即模板�Q�。这�U�三层体�pȝ��为Model-View-Controller模型�Q�MVC�Q�。如果遵从MVC模型�Q�代码分成三个截然不同的层，��化了软�g开发过�E�中所有相关�h员的工作�?�l�合模板引擎使用的数据模式可以是��M��Java对象�Q�最好是使用Java Collection Framework的对象。控制器只要了解模板的环境（如VelocityContext�Q�，一般这�U�环境都很容易��用。一些关�p�L��据库的“对�?关系”映��工兯��够和模板引擎很好地协同，��化JDBC操作�Q�对于EJB�Q�情形也�c�M��?模板引擎与MVC中视图这一部分的关�p�L��为密切。模板语�a�的功能很丰富、强大，��以处理所有必需的视囑֊�能，同时它往往很简单，不熟悉编�E�的��Z��可以使用它。模板语�a�不仅使得设计者从�q�于复杂的编�E�环境中解脱出来�Q�而且它保护了�pȝ��Q�避免了有意或无意带来危险的代码。例如，模板的编写者不可能�~�写出导致无限��@环的代码�Q�或侵占大量内存的代码。不要轻估这些安全机制的价��|��大多数模板编写者不懂得�~�程�Q�从长远来看�Q�避免他们接触复杂的�~�程环境相当于节省了你自��q��旉��?许多模板引擎的用��L��信，在采用模板引擎的�Ҏ��中，控制器部分和视图部分的明��分��，再加上模板引擎固有的安全机制�Q��得模板引擎��以成为其他内容发布系�l�（比如JSP�Q�的替代�Ҏ��。因此，Java模板引擎最常见的用途是替代JSP也就不��为奇了�?
    HTML处理 �Q?br />    �׃��Z��L��看重模板引擎用来替换JSP的作用，有时他们会忘记模板还有更�q�泛的用途。到目前为止�Q�模板引擎最常见的用途是处理HTML Web内容。但我还用模板引擎生成过SQL、email、XML甚至Java源代码�?br />

TrampEagle 2006-05-31 22:03 发表评论

DisplayTag应用

TrampEagle — Mon, 29 May 2006 10:24:00 GMT
引自�Q?br />--  作者：bibiye
--  发布旉��Q?005-12-16 13:18:07

--  DisplayTag应用
DisplayTag是一个非常好用的表格昄��标签�Q�适合MVC模式�Q�其主页�?a target="_blank">http://displaytag.sourceforge.net
一、最��单的情况�Q�未使用标签
  <%request.setAttribute( "test", new ReportList(6) );%>

  标签遍历List里的每一个对象，�q�将对象里的所有属性显�C�出来。一般用于开发的时候检查对象数据的完整性�?br />
二、��?lt;display:column/>标签的情�?/b>







   property对应List里对象的属性（用getXXX()�Ҏ��取得�Q�，title则对应表��D��头里的列名。定义列有两�U�方式：
   A�?lt;display:column property="email" />
      使用标签里的property属性来定义
   B�?lt;display:column title="email">email@it.com
      �?lt;display:column/>标签体里增加内容�Q�可以是帔R��Q�也可以用其他标�{��{?br />   两种方式比较�Q�用property属性来定义更加快速和利于排序�?br />
三、表格显�C�样式的定义
  A、在�?lt;display:column/>标签里指定标准的html属性，烦琐
  B、修�Ҏ��式表







   通过class属性来指定所要应用的样式。可以在光��认样式表里（./css/screen.css�Q�直接修�?br />
四、标�{�֏�得数据的数据�?br />  有四�U�范�?br />   pageScope
   requestScope (默认)
   sessionScope   注意�Q�这里要指定范围�Q�非默认
   applicationScope

五、通过增加id属性创建隐含的对象



    static
    <%=pageContext.getAttribute("testit_rowNum")%>
    <%=((ListObject)pageContext.getAttribute("testit")).getMoney()%>

   注意到在里增加了id属性，�q�时��在page context里创��Z��一个隐含对象，指向List里的当前对象�Q?br />   可以通过(ListObject)pageContext.getAttribute("id")来捕莯��个对象。同时还创徏了一个id_rowNum对象�Q�同��P��?br />   通过pageContext.getAttribute("testit_rowNum")来捕��P��它仅仅代表当前行的行数�?br />   有了�q�两个隐含对象，��可以通过其他标签来访问，例如Jstl:










六、显�C�部分数�?/b>
   昄��开始五条数据：通过讑֮�length属�?br />




   昄��W�三到第八条数据�Q�通过讑֮�offset和length属�?br />




七、对email和url地址的直接连�?/b>





如果要显�C�的对象里包含email和url地址�Q�则可以在display:column里直接设定autolink="true"来直接连�?br />
八、��用装饰模式�{换数据显�C�（写自��q�� decorator �Q?/b>
  A、对整个表格应用decorator







    org.displaytag.sample.Wrapper卌��己写的decorator�Q�它要��承TableDecorator�c�，看看它的一个方法：
        public String getMoney()
    {
        return this.moneyFormat.format(((ListObject) this.getCurrentRowObject()).getMoney());
    }
    很明显，它通过父类的getCurrentRowObject()�Ҏ��获得当前对象�Q�然后对其getMoney()�Ҏ��q�行‘��a漆�?br />  B、对单独的column应用decorator






    org.displaytag.sample.LongDateWrapper要实现ColumnDecorator接口�Q�它的方法：
        public final String decorate(Object columnValue)
    {
        Date date = (Date) columnValue;
        return this.dateFormat.format(date);
    }
    昄��Q�它获得不了当前对象�Q�因为它实现的是接口�Q�，仅仅是获得该对象的columnValue�Q�然后‘��a漆�?br />
九、创建动态连�?br />   有两�U�方法创建动态连接：
   A、在里通过增加href、paramId、paramName、paramScope、paramProperty属�?br />      href             基本的URL 地址
      paramId          加在URL 地址后的参数名称
      paramName        数据bean的名�U�ͼ�一般�ؓnull�Q�即使用当前List里的对象�Q?br />      paramScope       数据bean的范��_��一般�ؓnull
      paramProperty    数据bean的属性名�U�ͼ�用来填充URL 地址后的参数�?br />




    �q�种�Ҏ��便直接，但缺�Ҏ��无法产生�c�M��details.jsp?id=xx&action=xx的复合URL
   B、应用decorator 创徏动态连接：





   org.displaytag.sample.Wrapper里的�Ҏ��Q?br />public String getLink1()
{
  ListObject lObject= (ListObject)getCurrentRowObject();
  int lIndex= getListIndex();
  return "" + lObject.getId() + "";
}

public String getLink2()
{
  ListObject lObject= (ListObject)getCurrentRowObject();
  int lId= lObject.getId();
  return "   + "&action=view\\">View | "
   + "   + "&action=edit\\">Edit | "
   + "   + "&action=delete\\">Delete";
}
十、分��?br />   实现分页非常的简单，增加一个pagesize属性指定一�ơ想昄��的行数即�?br />

十一、排�?br />   排序实现也是很简单，在需要排序的column里增加sortable="true"属性，headerClass="sortable"仅仅�?br />   指定昄��的样式。column里的属性对象要实现Comparable接口�Q�如果没有的话可以应用decorator
   defaultsort="1"              默认�W�一个column排序
   defaultorder="descending"    默认递减排序






  注意的是�Q�当同时存在分页时排序仅仅针对的是当前页面，而不是整个List都进行排�?br />
十二、column 分组
   分组只是需要在column里增加group属�?br />




十三、导出数据到其他格式�Q�页面溢出filter??�Q?/b>
   �?lt;display:table/>里设定export="true"
   �?lt;display:column/>里设定media="csv excel xml pdf" 军_��该字�D�在导出到其他格式时被包不包含，不设定则都包�?br />
   军_��该种格式能不能在��面中导�?br />







十四、配�|�属性，覆盖默认
  两种�Ҏ��Q?br />  A、在�E�序classpath下新建displaytag.properties文�g
  B、对于单个表��|��应用标签
  具体可配�|�的属性：http://displaytag.sourceforge.net/configuration.html

十五、一个完整的例子






   sort="list" �Ҏ��个list�q�行排序
   导出数据到其他格式时�Q�group无效

解决DisplayTag有中文条件时的分��问�?(转自�Q?a >http://blog.donews.com/lveyo/archive/2006/04/27/848346.aspx)

很早��开始用DisplayTag了，真得很方便，不用考虑分页�Q�表格等问题�?/p>
但是有一个问题一直困扰我�Q�就是有中文作�ؓ表单提交内容的时候，��页��׃��能用了，中文变成了�ؕ码�?/p>
表单传送时�Q?!--StartFragment --> form的提交采用的是Post�Ҏ��Q�这没错�Q�但链接采用的是Get�Ҏ��Q�问题就出在�q�里�Q�因为和Tomcat4相比�Q�Tomcat5的post和get采用的方式不再相同了�Q�汉字编码的实现方式也不同了�?/p>
Post是将地址传送一�ơ，��form的数据单独提交，而Get则是��地址和参��C��起传送，传送的不止是form的数据�?br />
默认情况下，Tomcat对请求采用的默认�~�码是ISO-8859-1�Q?/a>�q�样我们提交的汉字被认�ؓ是ISO-8859-1的编码，所以在�E�序中接收时昄��q��。�?!--StartFragment --> 在过滤器中调用request.setCharacterEncoding("GBK")�Q�那么Post上来的汉字将被认为是GBK�~�码�Q�而Tomcat5对于Get��h��上来的编码�ƈ不根据过滤器的设定��L认编码方式，默认的依然是ISO-8859-1�Q?a>所以，即��你的��面使用默认的编码方式进行编码，然后使用ISO-8859-1�q�行解码�Q�得到的�l�果也不�?/a>�?
解决�Ҏ��Q?br />在Server.xml的connector部分讑֮�URIEncoding的��|��Ҏ��~�码方式指定自己的�?/a>��可以了
例如�Q�URIEncoding="GB2312"

TrampEagle 2006-05-29 18:24 发表评论

EasyJWeb�Q�Velocity脚本教程

TrampEagle — Fri, 07 Apr 2006 08:57:00 GMT

引自�Q?a >http://www.easyjf.com/easyjweb/velocity.htm

Velocity是一个基于java的模板引擎（template engine�Q�。它允许��M��Z��仅简单的使用模板语言�Q�template language�Q�来引用由java代码定义的对象�?当Velocity应用于web开发时�Q�界面设计�h员可以和java�E�序开发�h员同步开发一个遵循MVC架构的web站点�Q�也��是��_��面设计人员可以只关注页面的昄��效果�Q�而由java�E�序开发�h员关注业务逻辑�~�码。Velocity��java代码从web��面中分��d��来，�q�样为web站点的长期维护提供了便利�Q�同时也为我们在JSP和PHP之外又提供了一�U�可选的�Ҏ��?

官方�|�站�Q?a class="style1" target="_blank">http://jakarta.apache.org/velocity/

Velocity脚本摘要
1、声�?#set ($var=XXX)
左边可以是以下的内容
Variable reference
String literal
Property reference
Method reference
Number literal #set ($i=1)
ArrayList #set ($arr=["yt1","t2"])
技持算术运��符

2、注�?
单行## XXX
多行#* xxx
xxxx
xxxxxxxxxxxx*#

References 引用的类�?br />3、变�?Variables
�?"$" 开��_��W�一个字�W�必��Mؓ字母。character followed by a VTL Identifier. (a .. z
or A .. Z).
变量可以包含的字�W�有以下内容�Q?br />alphabetic (a .. z, A .. Z)
numeric (0 .. 9)
hyphen ("-")
underscore ("_")

4、Properties
$Identifier.Identifier
$user.name
hashtable user中的的name�?�c�M��Q�user.get("name")

5、Methods
object user.getName() = $user.getName()

6、Formal Reference Notation
用{}把变量名跟字�W�串分开

�?br />#set ($user="csy"}
${user}name
�q�回csyname

$username
$!username
$�?!的区�?br />当找不到username的时候，$username�q�回字符�?$username"�Q��?!username�q�回�I�字�W�串""

7、双引号 �?引号
#set ($var="helo")
test"$var" �q�回testhello
test'$var' �q�回test'$var'
可以通过讄�� stringliterals.interpolate=false改变默认处理方式

8、条件语�?br />#if( $foo )
Velocity!
#end
#if($foo)
#elseif()
#else
#end
�?foo为null或�ؓBoolean对象的false值执�?

9、逻辑�q�算�W?== && || !

10、��@环语�?foreach($var in $arrays ) // 集合包含下面三种Vector, a Hashtable or an Array
#end
#foreach( $product in $allProducts )
$product

#end

#foreach( $key in $allProducts.keySet() )
Key: $key -> Value: $allProducts.get($key)

#end

#foreach( $customer in $customerList )
$velocityCount$customer.Name
#end
11、velocityCount变量在配�|�文件中定义
# Default name of the loop counter
# variable reference.
directive.foreach.counter.name = velocityCount
# Default starting value of the loop
# counter variable reference.
directive.foreach.counter.initial.value = 1

12、包含文�?
#include( "one.gif","two.txt","three.htm" )

13、Parse导入脚本
#parse("me.vm" )

14�?stop 停止执行�q�返�?

15、定义宏Velocimacros ,相当于函�?支持包含功能
#macro( d )

#end
调用
#d()

16、带参数的宏
#macro( tablerows $color $somelist )
#foreach( $something in $somelist )
$something
#end
#end

17、Range Operator
#foreach( $foo in [1..5] )

Velocity用户手册---中文�?(来源�|�络)

Velocity是什么？

Velocity是一个基于java的模板引擎（template engine�Q�。它允许��M��Z��仅简单的使用模板语言�Q�template language�Q�来引用由java代码定义的对象�?

当Velocity应用于web开发时�Q�界面设计�h员可以和java�E�序开发�h员同步开发一个遵循MVC架构的web站点�Q�也��是��_��面设计人员可以只关注页面的昄��效果�Q�而由java�E�序开发�h员关注业务逻辑�~�码。Velocity��java代码从web��面中分��d��来，�q�样为web站点的长期维护提供了便利�Q�同时也为我们在JSP和PHP之外又提供了一�U�可选的�Ҏ��?

Velocity的能力远不止web站点开发这个领域，例如�Q�它可以从模板（template�Q��生SQL和PostScript、XML�Q�它也可以被当作一个独立工��h��产生源代码和报告�Q�或者作为其他系�l�的集成�l��g使用。Velocity也可以�ؓTurbine web开发架构提供模板服务（template service�Q�。Velocity+Turbine提供一个模板服务的方式允许一个web应用以一个真正的MVC模型�q�行开发�?

Velocity能�ؓ我们作什么？

The Mud Store Example

假设你是一家专门出售Mud的在�U�商店的��面设计人员�Q�让我们暂且�U�它为“在�U�MUD商店”。你们的业务很旺�Q�客户下了各�U�类型和数量的mud订单。他们都是通过输入用户名和密码后才登陆��C��的网站，登陆后就允许他们查看订单�q�购买更多的mud。现在，一�U�非常流行的mud正在打折销售。另外有一些客戯��律性的购买另外一�U�也在打折但是不是很��行的Bright Red Mud�Q�由于购买的人�ƈ不多所以它被安�|�在��面的边�~�。所有用��L��信息都是被跟�t��ƈ存放于数据库中的�Q�所以某天有一个问题可能会冒出来：��Z��么不使用velocity来��用户更好的浏览他们感兴趣的商品呢�Q?

Velocity使得web��面的客户化工作非常�Ҏ��。作��Z��个web site的设计�h员，你希望每个用��L��陆时都拥有自��q��面�?

你会见了一些公司内的��Y件工�E�师�Q�你发现他们每个人都同意客户应该拥有��h��个性化的信息。那让我们把软�g工程师应该作的事情发在一边，看一看你应该作些什么吧�?

你可能在��面内嵌套如下的VTL声明�Q?

Hello $customer.Name!

#foreach( $mud in $nudsOnSpecial )
#if ( $customer.hasPurchased( $mud ) )
#end
#end

$flogger.getPromo( $mud )

Velocity Template Language(VTL):AN introduction

VTL意味着提供最��单、最�Ҏ��q�且最整洁的方式合�q��面动态内宏V�?

VTL使用references来在web site内嵌套动态内容，一个变量就是一�U�类型的reference。变量是某种�c�d��的refreence�Q�它可以指向java代码中的定义�Q�或者从当前��面内定义的VTL statement得到倹{��下面是一个VTL statement的例子，它可以被嵌套到HTML代码中：

#set ( $a = “Velocity�?)

和所有的VTL statement一��P��q�个statement以＃字符开始�ƈ且包含一个directive�Q�set。当一个在�U�用戯��求你的页面时�Q�Velocity Templating Engine��查询整个页面以便发现所有＃字符�Q�然后确定哪些是VTL statement�Q�哪些不需要VTL作�Q何事情�?

�Q�字�W�后紧跟一个directive�Q�set�Ӟ��q�个set directive使用一个表辑ּ��Q��用括号封闭）――一个方�E�式分配一个值给变量。变量被列在左边�Q�而它的��D��列在双��Q�最后他们之间��用＝号分剌Ӏ?

在上面的例子中，变量�?a�Q�而它的值是Velocity。和其他的references一样以$字符开始，而值��L��以双引号��闭。Velocity中仅有String可以被赋值给变量�?

��C��以下的规则：

使用$字符开始的references用于得到什么；使用#字符开始的directives用于作些什么�?

Hello Velocity World!

一旦某个变量被分配了一个��|��那么你就可以在HTML文�g的�Q何地方引用它。在下面的例子中�Q�一个��D��分配�l?foo变量�Q��ƈ在其后被引用�?

#set ( $foo = “Velocity�?)

Hello $foo World!

上面的实现结果是在页面上打印“Hello Velocity World�Q��?

��Z��使包含VTL directives的statement更具有可��L��，我们鼓励你在新行开始每个VTL statement�Q�尽��你不是必须�q�么作。Set directive��在后面详细描述�?

注释

单行注释�Q?

## This is a single line comment.

多行注释�Q?

#*

Thus begins a multi-line comment. Online visitors won't

see this text because the Velocity Templating Engine will

ignore it.

*#

文档格式�Q?

#**

This is a VTL comment block and

may be used to store such information

as the document author and versioning

information:

@version 5

@author

*#

References

在VTL中有三种�c�d��的references�Q�变�?variables)、属�?properties)、方�?methods)。作��Z��个��用VTL的页面设计者，你和你的工程师必��d��references的名�U�达成共识，以便你可以在你的template中��用它们�?

Everything coming to and from a reference被作��Z��个String对象处理。如果有一个对�?foo是一个Integer对象�Q�那么Velocity��调用它的toString()�Ҏ��这个对象�{型�ؓString�c�d��?

变量

格式要求同java�?

属�?

例子�Q?

$customer.Address

$purchase.Total

$customer.Address有两�U�含义。它可以表示�Q�查找hashtable对象customer中以Address为关键字的��|��也可以表�C��用customer对象的getAddress()�Ҏ��。当你的��面被请求时�Q�Velocity��确定以上两�U�方式选用那种�Q�然后返回适当的倹{�?

�Ҏ��

一个方法就是被定义在java中的一�D�代码，�q�且它有完成某些有用工作的能力，例如一个执行计��和判断条�g是否成立、满��等。方法是一个由$开始�ƈ跟随VTL标识�W�组成的References�Q�一般还包括一个VTL�Ҏ��体。例如：

$customer.getAddress()

$purchase.getTotal()

$page.setTitle( “My Home Page�?)

$person.setAttributes( [“Strange�? “Weird�? “Excited”] )

前两个例�?customer.getAddress()�?purchase.getTotal()看�v来挺想上面的属�?customer.Address �?$purchase.Total。如果你觉得他们之间有某�U�联�pȝ��话，那你是正��的�?

VTL属性可以作为VTL�Ҏ��的羃写�?customer.Address属性和使用$customer.getAddress()�Ҏ��h��相同的效果。如果可能的话��用属性的方式是比较合理的。属性和�Ҏ��的不同点在于你能够给一个方法指定一个参数列表�?

正式reference标记

reference的正是格式如下：

${mudSlinger}变量

${customer.Address}属�?

${purchase.getTotal()}�Ҏ��

非正是格式更见常用，但是有时�q�是使用正是格式比较适合。例如：你希望通过一个变�?vice来动态的�l�织一个字�W�串�?

Jack is a $vicemaniac.

本来变量�?vice现在却变成了$vicemaniac�Q�这样Veloctiy��׃��知道您到底要什么了。所以，应该使用正是格式书写

Jack is a ${vice}maniac

现在Velocity知道变量�?vice而不�?vicemaniac�?

Quiet reference notation

例如�Q?

当页面的form被初始加载时�Q�变�?email�q�没有��|��q�时你肯定是希望它能够显�C�Z��个blank text来代替输出�?email”这��L��字段。那么��用quiet reference notation��比较合适�?

�q�样文本框的初始值就不会是email而是�I��g��?

正式和quiet格式的reference notation也可一同��用，像下面这��P��

Getting literal

Velocity使用�Ҏ��字符$�?来帮助它工作�Q�所以如果要在template里��用这些特�D�字�W�要格外��心。本节将讨论$字符�?

货币字符

在VTL中��?2.5�q�样的货币标识是没有问题得的�Q�VTL不会��它错认为是一个reference�Q�因为VTL中的reference��L��以一个大写或者小写的字母开始�?

Escaping valid VTL reference

VTL中��用“\\”作为逃逸符�?

例如�Q?

#set( $email = “foo�?)

$email

\\$email

\\\\$email

\\\\\\$email

��render为：

foo

$email

\\foo

\\\\$email

如果email变量没有被定义则

$email

\\$email

\\\\$email

\\\\\\$email

��被render为：

$email

\\$email

\\\\$email

\\\\\\$email

注意�Q�VTL中未被定义的变量��被认�ؓ是一个字�W�串�Q�所以以下例子：

#set( $foo = “gibbous�?)

$moon = $foo

的输出结果是�Q?

$moon = gibbous

Case substitution

现在你已�l�对reference比较熟悉了，你可以将他们高效的应用于你的template了。Velocity利用了很多java规范以方便了设计人员的��用。例如：

$foo

$foo.getBar()

## is the same as

$foo.Bar

$data.getUser(“jon�?

## is the same as

$data.User(“jon�?

$data.getRequest().getServerName()

# is the same as

$data.Request.ServerName

## is the same as

${data.Request.ServerName}

但是�Q�注意VTL中不会将reference解释为对象的实例变量。例如：$foo.Name��被解释为Foo对象的getName�Q�）�Ҏ��Q�而不是Foo对象的Name实例变量�?

Directives

Reference允许设计者��用动态的内容�Q�而directive使得你可以应用java代码来控制你的显�C�逻辑�Q�从而达��C��所期望的显�C�效果�?

#set

#set directive被用于设�|�一个reference的倹{��例如：

#set ( $primate = “monkey�?)

#set ( $customer.Behavior = $primate )

赋值左侧的�Q�LHS�Q�必��L��一个变量或者属性reference。右侧（RHS�Q�可以是以下�c�d��中一�U�：

l变量reference

lString literal

l属性reference

l�Ҏ��reference

lnumber literal

lArrayList

下面是应用各�U�类型的RHS的例子：

�Q�set ( $monkey = $bill ) ##变量reference

�Q�set ( $monkey.Friend = “monica�?) ##String literal

�Q�set ( $monkey.Blame = $whitehouse.Leak )##属性reference

�Q�set ( $monkey.Plan = $spindoctor.weave($web) )##�Ҏ��reference

�Q�set ( $monkey.Number = 123 )##Number literal

�Q�set ( $monkey.Say = [“Not�? $my, “fault”] )##ArrayList

注意�Q�最后一个例子的取值方法�ؓ�Q?monkey.Say.get(0)

RHS也可以是一个简单的��术表达式：

#set ( $value = $foo + 1 )

#set ( $value = $bar -1 )

#set ( $value = $foo * $bar )

#set ( $value = $foo / $bar )

如果你的RHS是一个null�Q�VTL的处理将比较�Ҏ��Q�它��指向一个已�l�存在的reference�Q�这对初学者来讲可能是比较费解的。例如：

#set ( $resut = $query.criteria(“name�? )

The result of the first query is $result

#set ( $resut = $query.criteria(“address�? )

The result of the second query is $result

如果$query.criteria(“name�?�q�回一个“bill”，�?query.criteria(“address�?�q�回的是null�Q�则昄��的结果如下：

The result of the first query is bill

The result of the first query is bill

看看下面的例子：

#set( $criteria = ["name", "address"] )

#foreach( $criterion in $criteria )

#set( $result = $query.criteria($criterion) )

#if( $result )

Query was successful

#end

#end

在上面的例子中，�E�序��不能智能的�Ҏ��$result的值决定查询是否成功。在$result�?set后（added to the context�Q�，它不能被讄��回null�Q�removed from the context�Q�。打印的�l�果��显�C�Z��ơ查询结果都成功了，但是实际上有一个查询是��p�|的�?

��Z��解决以上问题我们可以通过预先定义的方式：

#set( $criteria = [“name�? “address”] )

#foreach( $criterion in $criteria )

#set( $result = false )

#set( $result = $query.criteria( $criterion ) )

#if( $result )

Query was successful

#end

#end

String Literals

当你使用#set directive�Q�String literal��闭在一对双引号内�?

#set ( $directoryRoot = “www�?)

#set ( $templateName = “index.vm�?)

#set ( $template = �?directoryRoot/$tempateName�?)

$template

上面�q�段代码的输出结果�ؓ�Q�www/index.vm

但是�Q�当string literal被封装在单引号内�Ӟ��它将不被解析�Q?

#set ( $foo = “bar�?)

$foo

#set ( $blargh = �?foo' )

�l�果�Q?

bar

$foo

上面�q�个�Ҏ��可以通过修改velocity.properties文�g的stringliterals.interpolate = false的值来改变上面的特性是否有效�?

条�g语句

if/elseif/else

当一个web��面被生成时使用Velocity�?if directrive�Q�如果条件成立的话可以在��面内嵌入文字。例如：

#if ( $foo )

Velocity!

#end

上例中的条�g语句��在以下两种条�g下成立：

l$foo是一个boolean型的变量�Q�且它的��gؓtrue

l$foo变量的��g��为null

�q�里需要注意一点：Velocity context仅仅能够包含对象�Q�所以当我们说“boolean”时实际上代表的时一个Boolean对象。即便某个方法返回的是一个boolean��|��Velocity也会利用内省机制��它转换��Z��个Boolean的相同倹{�?

如果条�g成立�Q�那�?if�?end之间的内容将被显�C��?

#elseif�?else元素可以�?if一同��用。例如：

#if( $foo < 10 )

Go North

#elseif( $foo == 10 )

Go East

#elseif( $foo == 6 )

Go South

#else

Go West

#end

注意�q�里的Velocity的数字是作�ؓInteger来比较的――其他类型的对象��得条件�ؓfalse�Q�但是与java不同它��用“＝�Q�”来比较两个��|��而且velocity要求�{�号两边的值类型相同�?

关系、逻辑�q�算�W?

Velocity中��用等��h��作符判断两个变量的关�p�R��例如：

#set ( $foo = “deoxyribonucleic acid�?)

#set ( $bar = “ribonucleic acid�?)

#if ( $foo == $foo )

In this case it's clear they aren't equivalent.So�?

#else

They are not equivalent and this will be the output.

#end

Velocity有AND、OR和NOT逻辑�q�算�W�。下面是一些例子：

## logical AND

#if( $foo && $bar )

This AND that

#end

## logical OR

#if ( $foo || $bar )

This OR That

#end

##logical NOT

#if ( !$foo )

NOT that

#end

循环

Foreach循环

例子�Q?

#foreach ( $product in $allProducts )

$product

#end

每次循环$allProducts中的一个值都会赋�l?product变量�?

$allProducts可以是一个Vector、Hashtable或者Array。分配给$product的值是一个java对象�Q��ƈ且可以通过变量被引用。例如：如果$product是一个java的Product�c�，�q�且�q�个产品的名字可以通过调用他的getName�Q�）�Ҏ��得到�?

现在我们假设$allProducts是一个Hashtable�Q�如果你希望得到它的key应该像下面这��P��

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

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

#end

Velocity�q�特别提供了得到循环�ơ数的方法，以便你可以像下面�q�样作：

#foreach ( $customer in $customerList )
#end

$velocityCount $customer.Name

$velocityCount变量的名字是Velocity默认的名字，你也可以通过修改velocity.properties文�g来改变它。默认情况下�Q�计��C��?”开始，但是你可以在velocity.properties讄��它是从�?”还是从�?”开始。下面就是文件中的配�|�：

# Default name of loop counter

# variable reference

directive.foreach.counter.name = velocityCount

# Default starting value of the loop

# counter variable reference

directive.foreach.counter.initial.value = 1

include

#include script element允许模板设计者引入本地文件。被引入文�g的内容将不会通过模板引擎被render。�ؓ了安全的原因�Q�被引入的本地文件只能在TEMPLATE_ROOT目录下�?

#inclued ( “one.txt�?)

如果您需要引入多个文�Ӟ��可以用逗号分隔��p��Q?

#include ( “one.gif�? “two.txt�? “three.htm�?)

在括号内可以是文件名�Q�但是更多的时候是使用变量的：

#inclue ( “greetings.txt�? $seasonalstock )

parse

#parse script element允许模板设计者一个包含VTL的本地文件。Velocity��解析其中的VTL�q�render模板�?

#parse( “me.vm�?)

��像#include�Q?parse接受一个变量而不是一个模�ѝ��Q何由#parse指向的模杉K��必须包含在TEMPLATE_ROOT目录下。与#include不同的是�Q?parse只能指定单个对象�?

你可以通过修改velocity.properties文�g的parse_direcive.maxdepth的值来控制一个template可以包含的最�?parse的个数――默认值是10�?parse是可以递归调用的，例如�Q�如果dofoo.vm包含如下行：

Count down.

#set ( $count = 8 )

#parse ( “parsefoo.vm�?)

All done with dofoo.vm!

那么在parsefoo.vm模板中，你可以包含如下VTL�Q?

$count

#set ( $count = $count �?1 )

#if ( $count > 0 )

#parse( “parsefoo.vm�?)

#else

All done with parsefoo.vm!

#end

的显�C�结果�ؓ�Q?

Count down.

8

7

6

5

4

3

2

1

0

All done with parsefoo.vm!

All done with dofoo.vm!

Stop

#stop script element允许模板设计者停止执行模板引擎�ƈ�q�回。把它应用于debug是很有帮助的�?

#stop

Velocimacros

#macro script element允许模板设计者定义一�D�可重用的VTL template。例如：

#macro ( d )

#end

在上面的例子中Velocimacro被定义�ؓd�Q�然后你��可以在��M��VTL directive中以如下方式调用它：

#d()

当你的template被调用时�Q�Velocity��用替换�?d()�?

每个Velocimacro可以拥有��L��数量的参数――甚�?个参敎ͼ�虽然定义时可以随意设�|�参数数量，但是调用�q�个Velocimacro时必��L��定正��的参数。下面是一个拥有两个参数的Velocimacro�Q�一个参数是color另一个参数是array�Q?

#macro ( tablerows $color $somelist )

#foreach ( $something in $somelist )

$something

#end

#end

调用#tablerows Velocimacro�Q?

#set ( $greatlakes = [ “Superior�? “Michigan�? “Huron�? “Erie�? “Ontario�?] )

#set ( $color = “blue�?)

#tablerows( $color $greatlakes )

�l�过以上的调用将产生如下的显�C�结果：

Velocimacros可以在Velocity模板内实现行内定义（inline�Q�，也就意味着同一个web site内的其他Velocity模板不可以获得Velocimacros的定义。定义一个可以被所有模板共享的Velocimacro昄��是有很多好处的：它减��了在一大堆模板中重复定义的数量、节省了工作旉��、减��了出错的几率、保证了单点修改�?

上面定义�?tablerows( $color $list )Velocimacro被定义在一个Velocimacros模板�?在velocity.properties中定�?里，所以这个macro可以在�Q何规范的模板中被调用。它可以被多�ơ应用�ƈ且可以应用于不同的目的。例如下面的调用�Q?

#set ( $parts = [ “volva�? “stipe�? “annulus�? “gills�? “pileus�?] )

#set ( $cellbgcol = �?CC00FF�?)

#tablerows( $cellbgcol $parts )

上面VTL��生如下的输出�Q?

Velocimacro arguments

Velocimacro可以使用以下��M��元素作�ؓ参数�Q?

lReference�Q��Q何以$开头的reference

lString literal�Q?

lNumber literal�Q?

lIntegerRange�Q�[1�?3]或者[$foo�?$bar]

l对象数组�Q�[“a�?”b�?”c”]

lboolean��|��true、false

当将一个reference作�ؓ参数传递给Velocimacro�Ӟ��h��意reference作�ؓ参数时是以名字的形式传递的。这��意味着参数的值在每次Velocimacro内执行时才会被��生。这个特性��得你可以��一个方法调用作为参��C��递给Velocimacro�Q�而每�ơVelocimacro执行旉��是通过�q�个�Ҏ��调用产生不同的值来执行的。例如：

#macro ( callme $a )

$a $a $a

#end

#callme( $foo.bar() )

执行的结果是�Q�reference $foo的bar�Q�）�Ҏ��被执行了三次�?

如果你不需要这��L��Ҏ��可以通过以下�Ҏ��Q?

#set ( $myval = $foo.bar() )

#callme ( $myval )

Velocimacro properties

Velocity.properties文�g中的某几行能够��Velocimacros的实现更加灵�z�R��注意更多的内容可以看Developer Guide�?

Velocity.properties文�g中的velocimacro.libraary�Q�一个以逗号分隔的模板库列表。默认情况下�Q�velocity查找唯一的一个库�Q�VM_global_library.vm。你可以通过配置�q�个属性来指定自己的模板库�?

Velocity.properties文�g中的velocimacro.permissions.allow.inline属性：有两个可选的值true或者false�Q�通过它可以确定Velocimacros是否可以被定义在regular template内。默认值是ture――允许设计者在他们自己的模板中定义Velocimacros�?

Velocity.properties文�g中的

velocimacro.permissions.allow.inline.replace.global属性有两个可选值true和false�Q�这个属性允�怋�用者确定inline的Velocimacro定义是否可以替代全局Velocimacro定义�Q�比如在velocimacro.library属性中指定的文件内定义的Velocimacro�Q�。默认情况下�Q�此��gؓfalse。这样就��L��本地Velocimacro定义覆盖全局定义�?

Velocity.properties文�g中的

velocimacro.permissions.allow.inline.local.scale属性也是有true和false两个可选��|��默认是false。它的作用是用于��定你inline定义的Velocimacros是否仅仅在被定义的template内可见。换句话��_��如果�q�个属性设�|��ؓtrue�Q�一个inline定义的Velocimacros只能在定义它的template内��用。你可以使用此设�|�实��C��个奇妙的VM敲门�Q�a template can define a private implementation of the second VM that will be called by the first VM when invoked by that template. All other templates are unaffected�?

Velocity.properties文�g中的velocimacro.context.localscope属性有true和false两个可选��|��默认��gؓfalse。当讄��为true�Ӟ��M��在Velocimacro内通过#set()对context的修改被认�ؓ是针�Ҏ��velocimacro的本地设�|�，而不会永久的影响内容�?

Velocity.properties文�g中的velocimacro.library.autoreload属性控制Velocimacro库的自动加蝲。默认是false。当讄��为ture�Ӟ��对于一个Velocimacro的调用将自动��查原始库是否发生了变化，如果变化��重新加载它。这个属性��得你可以不用重新启动servlet容器而达到重新加载的效果�Q�就像你使用regular模板一栗��这个属性可以��用的前提��是resource loader�~�存是off状态（file.resource.loader.cache = false�Q�。注意这个属性实际上是针对开发而非产品的�?

Velocimacro Trivia

Velocimacro必须被定义在他们被��用之前。也��是��_��你的#macro()声明应该出现在��用Velocimacros之前�?

特别要注意的是，如果你试�?parse()一个包�?macro()的模�ѝ��因�?parse()发生在运行期�Q�但是解析器在parsetiem军_��一个看似VM元素的元素是否是一个VM元素�Q�这�?parse()-ing一�l�VM声明��不按照预期的样子工作。�ؓ了得到预期的�l�果�Q�只需要你��单的使用velocimacro.library使得Velocity在启动时加蝲你的VMs�?

Escaping VTL directives

VTL directives can be escaped with “\\”号�Q��用方式跟VTL的reference使用逃逸符的格式差不多�?

## #include( “a.txt�?) renders as (注释�?

#include( “a.txt�?)

## \\#include( “a.txt�?) renders as \\#include( “a.txt�?)

\\#include( “a.txt�?)

## \\\\#include ( “a.txt�?) renders as \\

\\\\#include( “a.txt�?)

在对在一个directive内包含多个script元素的VTL directives使用逃逸符时要特别��心�Q�比如在一个if-else-end statement内）。下面是VTL的if-statement的典型应用：

#if ( $jazz )

Vyacheslav Ganelin

#end

如果$jazz是ture�Q�输出将是：

Vyacheslav Ganelin

如果$jazz是false�Q�将没有输出。��用逃逸符��改变输出。考虑一下下面的情况�Q?

\\#if ( $jazz )

Vyacheslav Ganelin

\\#end

现在无论$jazz是true�q�是false�Q�输出结果都是：

#if ( $jazz )

Vyacheslav Ganelin

#end

事实上，�׃��你��用了逃逸符�Q?jazz�Ҏ��没有被解析为boolean型倹{��在逃逸符前��用逃逸符是合法的�Q�例如：

\\\\#if ( $jazz )

Vyacheslav Ganelin

\\\\#end

以上�E�序的显�C�结果�ؓ�Q?

\\ Vyacheslav Ganelin

\\

但是如果$jazz为false�Q�那么将没有输出。（书上说会没有输出�Q�但是我觉得应该�q�有有“\\”字�W�被输出。）

VTL�Q�Formatting issues

��管在此用户手册中VTL通常都开始一个新行，如下所�C�：

#set ( $imperial = [ “Munetaka�? “Koreyasu�? “Hisakira�? “Morikune�?] )

#foreach ( $shogun in $imperial )

$shogun

#end

但是像下面这�U�写法也是可以的�Q?

Send me #set($foo = [�?10 and�?”a cake”])#foreach($a in $foo)$a #end please.

上面的代码可以被改写为：

Send me

#set ( $foo = [�?10 and �?”a cake”] )

#foreach ( $a in $foo )

$a

#end

please.

或�?

Send me

#set($foo = [�?10 and �?”a cake”])

#foreach �Q?a in $foo �Q?a

#end please.

�q�两�U�的输出�l�构��一栗��?

其他�Ҏ��和杂项

math 在模板中可以使用Velocity内徏的算术函敎ͼ�如：加、减、乘、除

#set ( $foo = $bar + 3 )

#set ( $foo = $bar - 4 )

#set ( $foo = $bar * 6 )

#set ( $foo = $bar / 2 )

当执行除法时��返回一个Integer�c�d��的结果。而余��C��可以使用%来得刎ͼ�

#set ( $foo = $bar % 5 )

在Velocity内��用数学计��公式时�Q�只能��用像-n,-2,-1,0,1,2,n�q�样的整敎ͼ�而不能��用其它类型数据。当一个非整型的对象被使用时它��被logged�q�且��以null作�ؓ输出�l�果�?

Range Operator

Range operator可以被用于与#set�?foreach statement联合使用。对于处理一个整型数�l�它是很有用的，Range operator��h��以下构造�Ş式：

[n..m]

m和n都必��L��整型�Q�而m是否大于n则无关紧要。例子：

First example:

#foreach ( $foo in [1..5] )

$foo

#end

Second example:

#foreach ( $bar in [2..-2] )

$bar

#end

Third example:

#set ( $arr = [0..1] )

#foreach ( $i in $arr )

$i

#end

Fourth example:

[1..3]

上面四个例子的输出结果�ؓ�Q?

First example�Q?

1 2 3 4 5

Second example�Q?

2 1 0 -1 -2

Third example�Q?

0 1

Fourth example�Q?

[1..3]

注意�Q�range operator只在#set�?foreach中有效�?

Advanced Issue�Q�Escaping and�Q?

当一个reference被“！”分隔时�Q��ƈ且在它之前有逃逸符�Ӟ��reference��以�Ҏ��的方式处理。注意这�U�方式与标准的逃逸方式时不同的。对照如下：

#set ( $foo = “bar�?)

�Ҏ��形式标准格式

Render前Render后Render前Render�?

$\\!foo$!foo\\$foo\\$foo

$\\!{foo}$!{foo}\\$!foo\\$!foo

$\\\\!foo$\\!foo\\$!{foo}\\$!{foo}

$\\\\\\!foo$\\\\!foo\\\\$!{foo}\\bar

Velocimacro杂记

Can I user a directive or another VM as an argument to a VM?

例如�Q?center ( #bold( “hello�?) )

不可以。一个directive的参��C��用另外一个directive是不合法的�?

但是�Q�还是有些事情你可以作的。最��单的方式��是使用双引��P��

#set ( $stuff = �?bold( ‘hello' )�?)

#center ( $stuff )

上面的格式也可以�~�写��Z��行：

#center ( �?bold( ‘hello' ) )

��h��意在下面的例子中参数被evaluated在Velocimacro内部�Q�而不是在calling level。例子：

#macro ( inner $foo )

inner : $foo

#end

#macro ( outer $foo )

#set ( $bar = “outerlala�?)

outer : $foo

#end

#set ( $bar = ‘calltimelala' )

#outer( �?inner($bar)�?)

输出�l�果为：

outer : inner : outerlala

��C��Veloctiy的特性：参数的传递是By Name的。例如：

#macro ( foo $color )

Hi

There

#end

#foo ( $bar.rowColor() )

以上代码��导致rowColor()�Ҏ��两次调用�Q�而不是一�ơ。�ؓ了避免这�U�现象的出现�Q�我们可以按照下面的方式执行�Q?

#set ( $color = $bar.rowColor() )

#foo ( $color )

can I register velocimacros via #parse()?

目前�Q�Velocimacros必须在第一�ơ被模板调用前被定义。这��意味着你的#macro()声明应该出现在��用Velocimacros之前�?

如果你试�?parse()一个包�?macro() directive的模板，�q�一�Ҏ��需要牢记的。因�?parse()发生在运行期�Q�但是解析器在parsetiem军_��一个看似VM元素的元素是否是一个VM元素�Q�这�?parse()-ing一�l�VM声明��不按照预期的样子工作。�ؓ了得到预期的�l�果�Q�只需要你��单的使用velocimacro.library使得Velocity在启动时加蝲你的VMs�?

What is velocimacro autoreloading�Q?

velocimacro.library.autoreload是专门�ؓ开发而非产品使用的一个属性。此属性的默认值是false�?

String concatenation

开发�h员最帔R��的问题是我如何作字符拼接�Q�在java中是使用“＋”号来完成的�?

在VTL里要惛_��现同��L��功能你只需要将需要联合的reference攑ֈ�一起就行了。例如：

#set ( $size = “Big�?)

#set ( $name = “Ben�?)

The clock is $size$name.

输出�l�果��是�Q�The clock is BigBen.。更有趣的情冉|��Q?

#set ( $size = “Big�?)

#set ( $name = “Ben�?)

#set ( $clokc = �?size$name�?)

The clock is $clock.

上例也会得到同样的结果。最后一个例子，当你希望混合固定字段��C��的reference�Ӟ��你需要��用标准格式：

#set ( $size = “Big�?)

#set ( $name = “Ben�?)

#set ( $clock = �?{size}Tall$name�?)

The clock is $clock.

输出�l�果是：The clock is BigTallBen.。��用这�U�格式主要是��Z��使得$size不被解释�?sizeTall�?

TrampEagle 2006-04-07 16:57 发表评论

TrampEagle — Mon, 20 Feb 2006 06:31:00 GMT
引自�Q?a >http://www.gamvan.com/developer/java/opener/2005/12/846.html

对于lucene全文��索，可以��U�地看看它的7个主要类�Q�这7个类同时也表达了处理全文��索的7个意��c��因为数据库比较��Z�h所熟悉�Q�它又与全文��索某些理忉|��为相��|��所以在对下面的概念说明�Ӟ��会大量在渗入数据库和全文检索间的类比�?
1�Q�Document �Q�它的中文意思是文档�Q�对于一个文档，通常都包括它的标题、时间、作者、内宏V��如果让它的意思泛化，它也有文件的意思（�怿�Lucene的作者在取这个类名的时候也是经�q�再三斟酌的�Q�，对于文�g�Q�它可以指一个TXT文本、一个HTML�|�页、一个PDF文�g�{�等。总而言之，它是映射着某一个具体的文�g�Q�这��是它的单位�_�度。对应于数据�?/font>的概忉|��记录�Q�英文是Record�Q�weblucene在烦引源的xml中就原原本本地采用了�q�个概念�Q�可参照/dump/blog.xml �?

2�Q�Field �Q�中文意思是字段。汉语的��译��这个单词的意思表辑־�更恰如其分了�Q�意思是文字片段�Q�它可以是一个或多个字。字�D�|��文档�Q�Document�Q�的�ơ粒度单位，也是��索的最基本单位。注意这个概念跟在搜索引擎的输入框中随意输入的那几个字或几组字不是一��L��Q�在搜烦输入框中输入的那些文字首先需要经�q�一个QueryParser�Q�这也是7个类中的一个）��其分解成真正的Field�?�?a target="_blank">数据�?/font>中本来就有Field �q�个概念�Q�它��x��Record的次�U�单位。在数据�?/font>一条或多条记录怎么被找出来的，往往��q��由对Field的检索而得来。在全文��索中Document的最�l�取得也是差不多�Q�它是根据现在的某个Filed来决定的。即�Ҏ��文档中的某些�q�不完整的东西牵引出它的所需的全部�?
�C�Z��代码�Q?
代码内容
[com.chedong.weblucene.search.WebLuceneResultSetTest]
Document doc = new Document();
doc.add(Field.Keyword("keyword", "房地�?));
doc.add(Field.Keyword("keyword", "非典"));

3�Q�IndexWriter �Q�烦引书写�?
�C�Z��代码�Q?
[org.apache.lucene.index.TestIndexWriter]
代码内容
Document doc = new Document();
doc.add(Field.UnStored("content", "aaa"));
try {
IndexWriter writer = new IndexWriter(dir, new WhitespaceAnalyzer(), true);
writer.addDocument(doc);
}
catch (IOException e) {
e.printStackTrace();
}

它的构造器new IndexWriter(dir, new WhitespaceAnalyzer(), true) 有三个参敎ͼ�分别是Directory对象、分析器对象�Q�这是下一个要介绍的类�Q�和一个布��量�Q�是否要重写索引��是��p��个布��量标明的，如果取false则仅仅是��烦引附加上来�?

4�Q�Analyzer �Q?分析器，它将目录中的一�l�原始文件分析成�׃��l�Document和它相应的次�U�粒度Field�l�成的烦引。因��Z��同的文�g�c�d��Q�同��L��文本其内部文件流�l�织形式是不一��L��Q�所以需要不同的分析器处理不同的文�g�c�d��Q�如PDFAnalyzer、HtmlAnalyzer�Q�。又因�ؓ不同的文字语�a�处理Field拆分�Q�Token�Q�上是不一��L��Q�所以在语言角度上又有另一层分析器的类别区分，如下面这行代码是处理普通中文字�W�的
[com.chedong.weblucene.search.WebLuceneResultSetTest]
IndexWriter writer = new IndexWriter(dir, new CJKAnalyzer(), true);

5�Q�QueryParser �Q�这前面在区分Field和用戯��入的搜烦关键字时已经提及了。（它所用的词是Query�Q�跟数据�?/font>所用的是一个概�늚��Q�这个词同样的检索上让�h感觉没有像Search那么费尽心思去��q��。）QueryParser�q�没有实际地��d��查询工作�Q�它只是Parser�Q�剖析）用户输入的东西，�q�把剖析的结果以一�U�规则的形式送给Searcher��L��行一个真正的搜烦。作为剖析的�l�果�Q�不仅仅是Field�Q�还有Field们相互间的关�p?terms�Q�譬如逻辑和AND�Q�逻辑或OR�Q?逻辑非NOT)�?

6�Q�Searcher �Q?搜烦一个Query�Q�将�l�果�q�回�?
[org.apache.lucene.search..TestNot]
代码内容
RAMDirectory store = new RAMDirectory();
IndexWriter writer = new IndexWriter(store, new SimpleAnalyzer(), true);

Document d1 = new Document();
d1.add(Field.Text("field", "a b"));

writer.addDocument(d1);
writer.optimize();
writer.close();

Searcher searcher = new IndexSearcher(store);
Query query = QueryParser.parse("a NOT b", "field", new SimpleAnalyzer());
//System.out.println(query);
Hits hits = searcher.search(query);

对于每一个搜索器对象�Q�它都需要指定一个烦引文件�\径，然后由搜索器对Query对象执行查询�?上面的这个类袖珍地对7个主要类都均有涉及�?

7�Q�Hits �Q?Lucene的类注释是：A ranked list of documents, used to hold search results. 搜烦的结果不仅仅是一些文档，而且�q�些文档�q�是有��别的�Q�这个��别是对于先后�ơ序而言的。它对应�?a target="_blank">数据�?/font>中的RecordSet / ResultSet �?

TrampEagle 2006-02-20 14:31 发表评论

Lucene中文分词的高亮[highlight]昄��

TrampEagle — Mon, 20 Feb 2006 06:30:00 GMT
引自�Q?a >http://www.gamvan.com/developer/java/opener/2005/12/849.html

1、问题的来源增加分词以后�l�果的准��度提高了，但是用户反映�q�回�l�果的速度很慢。原因是�Q?Lucene 做每一��文档的相关关键词的高亮昄��Ӟ��在运行时执行了很多遍的分词操作。这样降低了性能�?br />2 、解��x��?
�?Lucene1.4.3 版本中的一个新功能可以解决�q�个问题�?Term Vector 现在支持保存 Token.getPositionIncrement() �?Token.startOffset() 以及 Token.endOffset() 信息。利�?Lucene 中新增加�?Token 信息的保存结果以后，��׃��需要�ؓ了高亮显�C��在�q�行时解析每��文档。通过 Field �Ҏ��控制是否保存该信息。修�?HighlighterTest.java 的代码如下：

代码内容
// 增加文档时保�?Term 位置信息�?
private void addDoc(IndexWriter writer, String text) throws IOException
{
Document d = new Document();
//Field f = new Field(FIELD_NAME, text, true, true, true);
Field f = new Field(FIELD_NAME, text ,
Field.Store.YES, Field.Index.TOKENIZED,
Field.TermVector.WITH_POSITIONS_OFFSETS);
d.add(f);
writer.addDocument(d);
}
// 利用 Term 位置信息节省 Highlight 旉��?
void doStandardHighlights() throws Exception
{
  �?Highlighter highlighter =new Highlighter(this,new QueryScorer(query));
highlighter.setTextFragmenter(new SimpleFragmenter(20));
for (int i = 0; i < hits.length(); i++)
{
String text = hits.doc(i).get(FIELD_NAME);
int maxNumFragmentsRequired = 2;
String fragmentSeparator = "...";
TermPositionVector tpv = (TermPositionVector)reader.getTermFreqVector(hits.id(i),FIELD_NAME);
�?/ 如果没有 stop words 去除�q�可以改�?TokenSources.getTokenStream(tpv,true); �q�一步提速�?
 �?TokenStream tokenStream=TokenSources.getTokenStream(tpv);
 �?//analyzer.tokenStream(FIELD_NAME,new StringReader(text));
 �?String result =
 �?highlighter.getBestFragments(
�? tokenStream,
 �?text,
 �?maxNumFragmentsRequired,
       fragmentSeparator);
 �?System.out.println(" " + result);
}
}

最后把 highlight 包中的一个额外的判断��L��。对于中文来说没有明昄��单词界限�Q�所以下面这个判断是错误的：

tokenGroup.isDistinct(token)

�q�样中文分词��׃��会媄响到查询速度了�?

TrampEagle 2006-02-20 14:30 发表评论

Prototype Meets Ruby: A Look at Enumerable, Array and Hash

TrampEagle — Sat, 11 Feb 2006 06:04:00 GMT
原文引自:http://encytemedia.com/blog/articles/2005/12/07/prototype-meets-ruby-a-look-at-enumerable-array-and-hash

Encytemedia

A LOOK AT SOFTWARE DEVELOPMENT, DESIGN, AND OTHER RANDOM BITS.

edit
Working With Events In Prototype

February 08, 2006

Events drive interaction for almost everything and the web is no exception. In the style of my last article on Prototype, lets take a code-heavy look at how Prototype lets us work with events.

NOTE: This article uses Prototype 1.5.0_pre0

Basic event handling

The syntax for working with events looks like the code below.

Event.observe(element, name, observer, [useCapture]);

Assuming for a moment that we want to observe when a link was clicked, we could do the following:

// <a id="clicker" href="http://foo.com">Click mea> Event.observe('clicker', 'click', function(event){ alert('clicked!');});

If we wanted to get the element that fired the event, we'd do this:

Event.observe('clicker', 'click', function(event){ alert(Event.element(event));});

Observing keystrokes

If we wanted to observe keystrokes for the entire document, we could do the following:

Event.observe(document, 'keypress', function(event){ if(event.keyCode == Event.KEY_TAB) alert('Tab Pressed');});

And lets say we wanted to keep track of what has been typed into your snazzy live-search box:

Event.observe('search', 'keypress', function(event) { Element.update('search-results', $F(Event.element(event)));});

Prototype defines properties inside the event object for some of the more common keys, so feel free to dig around in Prototype to see which ones those are.

A final note on keypress events; If you'd like to detect a left click you can use Event.isLeftClick(event).

Getting the coordinates of the mouse pointer

Drag and drop, dynamic element resizing, games, and much more all require the ability to track the X and Y location of the mouse. Prototype makes this fairly simple. The code below tracks the X and Y position of the mouse and spits out those values into an input box named mouse.

Event.observe(document, 'mousemove', function(event){$('mouse').value = "X: " + Event.pointerX(event) + "px Y: " + Event.pointerY(event) + "px";});

If we wanted to observe the mouse location when it was hovering over a certain element, we'd just change the document argument to the id or element that was relevant.

Stopping Propagation

Event.stop(event) will stop the propagation of an event but there is a bug in Safari 2.0.3 that causes this to behave unexpectedly. Ryan from Particletree has posted an in-depth article on Event.stop with a workaround for Safari.

The good news is that this bug is fixed in the Webkit version of Safari. You can check out this test in Safari 2.0.3 and Webkit to see the results of both.

Events, Binding, and Objects

Everything has been fairly straight forward so far, but things start getting a little tricker when you need to work with events in and object-oriented environment. You have to deal with binding and funky looking syntax that might take a moment to get your head around.

Lets look at some code so you can get a better understanding of what I'm talking about.

EventDispenser = Class.create(); EventDispenser.prototype = { initialize: function(list) { this.list = list; // Observe clicks on our list items $$(this.list + " li").each(function(item) { Event.observe(item, 'click', this.showTagName.bindAsEventListener(this)); }.bind(this)); // Observe when a key on the keyboard is pressed. In the observer, we check for // the tab key and alert a message if it is pressed. Event.observe(document, 'keypress', this.onKeyPress.bindAsEventListener(this)); // Observe our fake live search box. When a user types something into the box, // the observer will take that value(-1) and update our search-results div with it. Event.observe('search', 'keypress', this.onSearch.bindAsEventListener(this)); Event.observe(document, 'mousemove', this.onMouseMove.bindAsEventListener(this)); }, // Arbitrary functions to respond to events showTagName: function(event) { alert(Event.element(event).tagName); }, onKeyPress: function(event) { var code = event.keyCode; if(code == Event.KEY_TAB) alert('Tab key was pressed'); }, onSearch: function(event) { Element.update('search-results', $F(Event.element(event))); }, onMouseMove: function(event) { $('mouse').value = "X: " + Event.pointerX(event) + "px Y: " + Event.pointerY(event) + "px"; } }

Whoa! What's going on here? Well, we've defined our a custom class EventDispenser. We're going to be using this class to setup events for our document. Most of this code is a rewrite of the code we looked at earlier except this time, we are working from inside an object.

View a live example of our document ��

Looking at the initialize method, we can really see how things are different now. Take a look at the code below:

// Observe clicks on our list items $$(this.list + " li").each(function(item) { Event.observe(item, 'click', this.showTagName.bindAsEventListener(this)); }.bind(this));

We've got iterators, binding and all sorts of stuff going on. Lets break down what this chunk of code is doing.

First we are hunting for a collection of elements based on it's css selector. This uses the new Prototype selector function $$. After we've found the list items we are dealing with we send those into an each iteration where we will add our observers.

Event.observe(item, 'click', this.showTagName.bindAsEventListener(this));

Now looking at the code above, you'll notice the bindAsEventListener function. This takes the method before it showTagName and treats it as the method that will be triggered when, in this case, someone clicks one of our list items.

You'll also notice we pass this as an argument to the bindAsEventListener function. This simply allows us to reference the object in context EventDispenser inside our function showTagName.

NOTE: If you prefer the jargon packed explanation of bindAsEventListener, see the Script.aculo.us wiki.

Moving on, you'll see bind(this) attached to our iterator function. This really has nothing to do with events, it is only here to allow me to use this inside the iterator. If we didn't use bind(this), I couldn't reference the method showTagName inside the iterator.

Ok, so we'll move on to looking at our methods that actually get called when an event occurs. Since we've been dealing with showTagName, lets look at it.

showTagName: function(event) { alert(Event.element(event).tagName); }

As you can see, this function accepts one argument--the event. In order for us to get the element which fired the event we need to pass that argument to Event.element. Now we can manipulate it at will.

This covers the most confusing parts of our code. The text above is also relevant to the remaining parts of our code. If there is anything about this you don't understand, feel free to say so.

Removing Event Listeners

This one threw me for a loop the first time I tried to use it. I tried something similar to what I did in the Event.observe call with the exception of using stopObserving, but nothing seemed to change. In other words, the code below does NOT work.

$$(this.list + " li").each(function(item) { Event.stopObserving(item, 'click', this.showTagName); }.bind(this));

What's the deal here? The reason this doesn't work is because there is no pointer to the observer. This means that when we passed this.showTagName in the Event.observe method before hand, we passed it as an anonymous function. We can't reference an anonymous function because it simply doesn't have a pointer.

So how do we get the job done? All we need to do is give the observing function a pointer, or the jargon free version: Set a variable that points to this.showTagName. Ok, lets change our code a bit.

this.showTagObserver = this.showTagName.bindAsEventListener(this); // Observe clicks on our list items $$(this.list + " li").each(function(item) { Event.observe(item, 'click', this.showTagObserver); }.bind(this));

Now we can remove the event listeners from our list like this:

$$(this.list + " li").each(function(item) { Event.stopObserving(item, 'click', this.showTagObserver); }.bind(this));

One final note on removing event listeners. If you have an instance where you want to simply remove all observes in one big swoop, you can use unloadCache.

Event.unloadCache();

Summing Up

That pretty much sums up events in Prototype. If you find any errors, please let me know. The great thing about writing articles such as this is that I also learn so much in the process and develop a deeper understanding of what I'm writing about. For instance, I found out the removing event listeners bit while I was writing this article. If you've got anything you'd like to contribute, feel free to chime in. Until next time, Happy Prototyping!

Related Reading

Prototype Meets Ruby: A Look at Enumerable, Array and Hash
Listible Prototype Resources
Script.aculo.us Wiki
Using Prototype.js 1.4
Prototype and the this keyword
Quick Guide To Prototype
Event.stop

TrampEagle 2006-02-11 14:04 发表评论

TrampEagle — Thu, 09 Feb 2006 06:52:00 GMT
引自�Q?a >http://www-128.ibm.com/developerworks/cn/java/j-maven/

��目��理: Maven 让事情变得简�?/h1>
�l�您的下一�?Java 构徏��d��目��理�Ҏ�?/p>
文档选项
��此��作为电子邮件发�?/font>

�Ҏ��늚�评�h
帮助我们改进�q�些内容

�U�别: 初��
Charles Chan, 高��软�g开发�h�? Finetix LLC
2003 �q?7 �?30 �?/p>
��管 Ant 对于构徏 Java �E�序而言是事实上的标准工��P��但这个工具在许多斚w��都不胜�Q��目��理��d��。相反，Ant 提供的东西，Maven�Q�出�?Apache Jakarta ��目的高�U�项目管理工��P��都能提供�Q�而且更多。Java 开发�h�?Charles Chan ��介�l?Maven 的特性，�q��@序渐�q�地指导您进行一�ơ完整的 Maven ��目讄��?/blockquote>
目前�Q�绝大多数开发�h员都�?Ant 当作 Java �~�程��目的标准构建工兗��遗憄��是，Ant 的项目管理工��P��作�ؓ make 的替代工��P��不能满��l�大多数开发�h员的需要。通过��?Ant 构徏文�g�Q�很隑֏�现项目的相关性信息和其它元信息（如开发�h员／拥有者、版本或站点主页�Q��?
Maven 除了以程序构��力�ؓ特色之外�Q�还提供 Ant 所�~�少的高�U�项目管理工兗��由�?Maven 的缺省构��则有较高的可重用性，所以常常用两三�?Maven 构徏脚本��可以构建简单的��目�Q�而��?Ant 则需要十几行。事实上�Q�由�?Maven 的面向项目的�Ҏ��Q�许�?Apache Jakarta ��目现在使用 Maven�Q�而且公司��目采用 Maven 的比例在持箋增长�?/p>
Maven vs Ant
那么�Q�Maven �?Ant 有什么不同呢�Q�在回答�q�个问题以前�Q�我要强调一点：Maven �?Ant 针对构徏问题的两个不同方面。Ant �?Java 技术开发项目提供跨�q�_��构徏��d��。Maven 本��n描述��目的高�U�方面，它从 Ant 借用了绝大多数构��Z�Q务。因此，�׃�� Maven �?Ant 代表两个差异很大的工��P��所以我��只说明�q�两个工��L��{�同�l��g之间的区别，如表 1 所�C��?/p>
�?1. Maven vs Ant
Maven Ant
标准构徏文�g project.xml �?maven.xml build.xml
�Ҏ��处理顺�?/td>
${maven.home}/bin/driver.properties
${project.home}/project.properties
${project.home}/build.properties
${user.home}/build.properties
通过 -D 命��o行选项定义的系�l�特�?
最后一�?/b>定义起决定作用�?
通过 -D 命��o行选项定义的系�l�特�?
�? ��d��装入的特�?
�W�一�?/b>定义最先被处理�?
构徏规则构徏规则更�ؓ动态（�c�M��于编�E�语�a��Q�；它们是基�?Jelly 的可执行 XML�?/td> 构徏规则或多或少是静态的�Q�除非��?

名称	地址	�q�龄
$Customer.Name()	$Customer.Address()	$Customer.Age()

	Maven	Ant
标准构徏文�g	project.xml �?maven.xml	build.xml
�Ҏ��处理顺�?/td>	${maven.home}/bin/driver.properties ${project.home}/project.properties ${project.home}/build.properties ${user.home}/build.properties 通过 -D 命��o行选项定义的系�l�特�? 最后一�?/b>定义起决定作用�?	通过 -D 命��o行选项定义的系�l�特�? �? ��d��装入的特�? �W�一�?/b>定义最先被处理�?
构徏规则	构徏规则更�ؓ动态（�c�M��于编�E�语�a��Q�；它们是基�?Jelly 的可执行 XML�?/td>	构徏规则或多或少是静态的�Q�除非��?

国产亚洲一区二区三区在线,在线观看午夜亚洲一区,国产精品亚洲A∨天堂不卡

DisplayTag应用

EasyJWeb�Q�Velocity脚本教程

Lucene中文分词的高亮[highlight]昄���

Prototype Meets Ruby: A Look at Enumerable, Array and Hash

Encytemedia

Working With Events In Prototype

Basic event handling

Observing keystrokes

Getting the coordinates of the mouse pointer

Stopping Propagation

Events, Binding, and Objects

Removing Event Listeners

Summing Up

Related Reading

��目���理: Maven 让事情变得简�?/h1>�l�您的下一�?Java 构徏��d����目���理�Ҏ�?/p>

Lucene中文分词的高亮[highlight]昄��

��目��理: Maven 让事情变得简�?/h1>
�l�您的下一�?Java 构徏��d��目��理�Ҏ�?/p>