本指南是VTL(Velocity Template Language)的参考文档。至于更多信息，请查阅Velocity用户手册(Velocity User Guide)

2语法参考

2.1变量

符号：

$[!][{][a..z,A..Z][a..z,A..Z,0-9,-,_][]]

大家对上面的表示不知道清楚不清楚，我这儿给大家描述一边，以后类似的表述都是这样。“[]”表示可选项，意为可有可无。通过上面的表述可以看出变量一个必写项和若干个可选项组成。其中$是必写项，其余的都是可选项。

例如：

•一般符号：$mud-slinger_9

•静态符号：$!mud_slinger_9

•正式符号：${mud_slinger_9}

2.2属性

符号：

$[{][a..z,A..Z][a..z,A..z,0..9,-,_]*.[a..z,A..Z][a..z,A..Z,0..9,-,_]*[}]

例如：

•一般符号：$customer.Address

•正式符号：${purchase.Total}

2.3方法

符号：

$[{][a..z,A..Z][a..z,A..Z,0..9,-,_]*.[a..z,a..Z][a..z,A..Z,0..9,-,_]*([可选参数列表…])[}]

例如：

•一般符号：$customer.getAddress()

•正式符号：${puchase.getTotal()}

•带有参数列表的一般符号：$page.setTile(“My Home Paget”)

VTL属性值表示的简短使用代替了VTL方法表示中的get和set方法。例如,$object.getMethod()或者$object.setMethod()使用VTL属性值表示可将其简化为$object.Method。在使用时这样表示方法通常更加便捷的。属性值表示和方法表示最主要的区别在于是否有传递的参数，如果有参数则需要是用方法表示，如果没有参数就可以直接使用属性值表示。

3指令

3.1#set-确立变量、属性、方法的值

格式：

#[{] set[}]($ref=[“,’]arg[”,’])

用法：

•$ref-等号左边必须是一个变量或者属性值

•$arg-等号右边的arg可以用双引号或者单引号组成的字符串或者字符。如果等号右边是NULL，那等号左边将无法被赋值。

例如：

•变量：#set($monkey=$bill)

•字符串：#set($monkey.Friend=’monica’)

•属性值：#set($monkey.Blame=$whitehouse.Leak)

•方法：#set($monkey.Plan=$spindoctor.weave($web))

•一般：#set($monkey.Number=123)

•列表：#set($monkey.Numbers=[1..3])

•数组：#set($monkey.Say=[“Not”,$my,”fault”])

等式右边也可以是一个简单的算术表达式，例如：

•加法：#set($value=$foo+1)

•减法：#set($value=$bar-1)

•乘法：#set($value=$foo*$bar)

•除法：#set($value=$foo/$bar)

•求余：#set($value=$foo%$bar)

3.2#if/#elseif/#else-条件判断

格式：

#[{]if[}]([判断条件])[输出内容][#[{ ]elseif[ }]([判断条件])[输出内容]]*[# [{ ]else[ }]([判断条件])[输出内容]]# [{ ]end[ }]

例如：

注意：

1．“== “操作可以用来比较数字，字符串，或同一个类的不同对象或不同类型的对象. 当是不同类的对象时，会调用它们的toString()命令结果来做比较看是否相等.

2．你也可以用括弧来限定指令。当书写时紧跟一个#else，这是就需要将该else指令限定。

         #if( $foo == $bar)it's true!#{else}it's not!#end</li>

3.3#foreach-对象循环

格式：

#[{] foreach[}]($ref in arg)statement#[{] end[}]

用法：

•$ref-用于循环的变量

•arg-可能是一个列表引用(i.e.object.array,collection,or map),或者一个array list,或者其他列表。

•statement-当velocity发现下一个有效对像在列表中,输出可以是一个合法的VTL.

例如下面省略statement的#foreach():

•引用：#foreach($item in $items)

•数组：#foreach($item in [“Not”,$my,”fault”])

•列表：#foreach($item in[1...3])

Velocity提供一个简单的方式实现循环计数器，这样你可以根据一下来做：

<table>

#foreach( $customer in $customerList )

    <tr><td>$velocityCount</td><td>$customer.Name</td></tr>

#end

</table>

循环计数器引用中有一个默认的名字-$velocityCount，它是在velocity.properties中定义。计数器默认设置从1开始计数，同样你也可以在velocity.properties中进行设定成0或者1。计数器的部分属性参数可以在velocity.properties文件里找到：

# 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

在Velocity1.5中加入了对计数器最大值的限制，默认值是-1，表示没有限制。

# The maximum allowed number of loops.

directive.foreach.maxloops = -1

3.4#include-加载不用被Velocity解析的本地文件

格式：

#[{]include[}](arg[arg2…argn])

        •arg-在TEMPLATE_ROOT下引用一个有效的文件

    例如：

        •字符串：#include( "disclaimer.txt" "opinion.txt" )

        •变量：#include( $foo $bar )

    3.5#parse-加载一个需要被Velocity解析的本地模板

    格式：

        #[{]parse[}](arg)

        •arg-在TEMPLATE_ROOT下引用一个模板

    例如：

        •字符串：#parse( "lecorbusier.vm" )

        •变量：#parse( $foo )

    通过设置配置中的解析层次深度的最大值velocity.properties中项 parse_directive.maxdepth in可以防止死循环. (The default parse depth is 10.)

    3.6#stop-停止模板引擎

    格式：

        #[{]stop[}]

    用法：

        它将停止执行流动中的模板。这对调试模板来说很不错。

    3.7#evaluate-动态的估计一个字符串或者引用

    格式：

        #[{] evaluate[}](arg)

        •arg-被动态估计的字符串或者

    例如：

        c字符串：#evaluate( 'string with VTL #if(true)will be displayed#end' )

        •变量：#include( $foo )

    3.8#macro-让用户可以定义宏操作(Velocimacro (VM):一组实现特定功能的VTL

    格式：

        #[{]macro[}](vmname $arg1[$arg2 $arg3 … $argn])[VM VTL code…]# [{]end[}]

•vmname – 宏名字 VM (#vmname)

        •$arg1 $arg2 [ ... ] – 要传给宏的参数VM

        •[ VM VTL code... ] –宏代码，有效的VTL

    一旦定义，VM就像是模板中任何别的VTL指令。

         #vmname( $arg1 $arg2 )

    VMs可以被定义在两个地方：

1．Template library:可以配置用户定义的库，以便全站使用。

2．Inline:放入到一般的模板文件中，仅当配置参数velocimacro.permissions.allowInline=true时生效。

4注解

4.1单行注解

例如:

        ##This is a comment.

4.2多行注解

例如：

#*

This is a multiline comment.

*#

        MVC设计模式中，事件一般是指客户端Web浏览器提交的各种不同请求，这些请求由控制器进行处理，控制器根据事件的类型来改变模型或各个视图，视图可以接受模型发出的数据更新通知，依据数据根型的结果调整视图效果，呈现在用户面前。而模型也可以通过视图所获得的用户提交的数据进行具体业务逻辑的处理。
随着JSP与Servlet技术的日益成熟，开发人员开始尝试在JAVA　Web应用开发中采用MVC设计模式，以实现软件代码更好的可维护性和可重用性。随后出现两种典型的JSP设计模式：１、modle1(JSP设计模式1)；２、model2( JSP设计模式2)；
1.2JSP设计模式１
        在JSP技术的发展初期，由于其便于快速开发的优点，很快就成为了创建Web的应用的热门技术之一。在JSP页面中可以很容易实现内容的显示，业务逻辑的编写以及流程的控制，从而快速地完成应用开发。最初很多的Java Web应用甚至全部由JSP页面构成，这种以JSP为中心的开发模型称为Mode1(设计模式１)。具体实现方式如下图：

        在设计模式１中，JSP页面负责接收处理客户端的Web浏览器发送的请求，并在处理后直接进行响应。其间一般会借助Java Bean处理复杂的业务逻辑。
1.3JSP设计模式2
        Model2则是MVC设计模式的一种具体实现方式。在Model2中采用Servlet作为控制器,负责接收客户端Web浏览器发送的所有请求，并依据处理的不同结果，转发到对应的JSP页面实现在浏览器客户端的显示。具体实现方式如下图：

2 Struts 2 介绍
        目前，Struts已经分化成两个框架：第一个框架是传统的Struts1和WebWork结合后的Struts2。Struts2虽然是在Struts1的基础上发展起来的，但实质上是以WebWork为核心，Struts2为传统的Struts1注入了WebWork的设计理念，统一Struts1和WebWork两个框架，允许Struts1和WebWork开发者同时使用Struts2框架。
        Struts分化出来的另一个框架是Shale,这个框架远远超出了Struts1原有的设计思想，它与原有的Struts1的关联很少，它使用全新的设计思想。Shale更像一个新的框架，而不是Struts的升级。而Shale则是建立在JSF之上。
2.1 Struts2框架结构

        通过上面的我们看出来，浏览器发出请求后，核心控制器FilterDispatcher根据请求决定调用合适的Action；控制器将用户请求参数用SetXxx()方法写入Action，并且回调execute()方法，然后控制器通过execute()的返回参数决定jsp的显示页面，而显示内容则通过getXxx()方法从Action里获取。并最终通过JSP显示给浏览器。
2.2 Struts2的配置文件
        当Struts2创建系统的Action代理时，需要使用Struts2的配置文件。
        Struts2的配置文件有两份：
        •配置Action的struts.xml文件。
        •配置Struts2全局属性的struts.properties文件。
        Struts.xml文件内定义了Struts2的系列Action,定义Action时，指定该Action的实现类，并定义该Action处理结果与视图资源之间的映射关系。代码如下：
--------------------------------------------------------struts.xml---------------------------------------------------------
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
        <package name="blog" extends="struts-deault">
                <action name="Login" class="com.5d6d.benfox0520.Login">
                        <result name="success">/welcome.jsp</result>
                        <result name="error">/error.jsp</result>
                        <result name="input">/index.jsp</result>
                </action>
        </package>
</struts>
------------------------------------------------------------------------------------------------------------------------------
        Struts.properties文件形式是系列的key,value对，它指定了Struts2应用的全局属性。
-----------------------------------------------------------struts.properties---------------------------------------------
#struts.devMode=false
------------------------------------------------------------------------------------------------------------------------------
2.3 Struts2的标签库
        Struts2标签库也是Struts2的重要组成部分，Struts2的标签库提供了非常丰富的功能，这些标签库不仅提供了表现层数据处理，而且提供了基本的流程控制功能，还提供了国际化、Ajax支持等功能。
2.4 Struts2的控制器组件
        Struts2的控制器组件是Struts2的核心，事实上，所有MVC框架都是以控制器组件为核心的。Struts2的控制器由两部分组成：FilterDispatcher和业务控制器Action.

PDF下载地址:http://benfox0520.5d6d.com/thread-5-1-1.html