什么是VelocityViewServlet
使用org.apache.velocity.tools.view.VelocityViewServlet可以将Velocity集成到基于Servlet的web应用中,以Servlet+Velocity的方式实现web应用
Servlet + Velocity的一般步骤
1.自定义Servlet,实现VelocityViewServlet的handleRequest方法,不要覆写VelocityViewServlet的doGet或者doPost方法,它的默认实现是将请求转发到handleRequest方法中,在实现handleRequest时,需要返回一个vm的模版对象Template
2.在web.xml中,配置自定义的Servet,同时需要指定,Velocity配置文件velocity.properties的位置
3.在指定的目录下,创建velocity.properties配置文件,用于存放Velocity的配置信息,比如vm文件的加载位置
4.定义vm文件,根据需要,在第一步Servlet的handleRequest方法实现中,将vm需要的参数由Context参数对象传入
定义Servlet
package com.tom.servlets;
import org.apache.velocity.Template;
import org.apache.velocity.context.Context;
import org.apache.velocity.tools.view.VelocityViewServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class TestVelocityViewServlet extends VelocityViewServlet {
@Override
protected Template handleRequest(HttpServletRequest request, HttpServletResponse response, Context ctx) {
ctx.put("key", "This is value for the key");
ctx.put("favoriteFruit","All");
ctx.put("elements", new String[]{"One", "Two", "Three"});
return getTemplate("abc.vm");
}
}
配置web.xml
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" version="3.1"> <servlet> <servlet-name>Velocity</servlet-name> <servlet-class>com.tom.servlets.TestVelocityViewServlet</servlet-class> <!--定义Velocity配置文件velocity.properties的位置,相对于web应用根的路径--> <init-param> <param-name>org.apache.velocity.properties</param-name> <param-value>/WEB-INF/velocity.properties</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>Velocity</servlet-name> <url-pattern>/servlets/velocity</url-pattern> </servlet-mapping> </web-app>
Velocity配置文件velocity.properties的配置
resource.loader=webapp
webapp.resource.loader.class=org.apache.velocity.tools.view.WebappResourceLoader
#relative to the web context, has the same parent directory with WEB-INF
#that is, vm and WEB-INF are sibling folders
webapp.resource.loader.path=/vm
上面指定了vm文件的加载路径,因为是WebappResourceLoader,因此是相对于web应用根开始算起,也就是vm和WEB-INF同级目录
vm文件定义
<!--abc.vm-->
<html>
<body>
<p>$key</p>
#foreach($elem in $elements)
<li>$elem</li>
#end
<div>
#include("def.vm")
</div>
</body>
</html>
<!--def.vm-->
What's your favorite fruit? $favoriteFruit
结果
访问velocity这个servlet,得到的结果是:
This is value for the key
- One
- Two
- Three
What's your favorite fruit? $favoriteFruit
总结
基于Servlet+Velocity的web应用目录结构:
|-web
|- WEB-INF
|- web.xml
|- velocity.properties
|- vm
|- abc.vm
|- def.vm
问题
在上面的显示结果中,需要关注的是favoriteFruit没有被替换,可见,Context定义的值没有传递!那么如何做变量传递呢?