巧用Freemarker的自定义方法

　　今天想要在Freemarker模版文件里使用HttpServletResponse对象的encodeURL方法，对页面链接的URL进行 Encode。据我所知，在Freemarker模版文件里是可以使用scriptlet和其他第三方标签的，可是当我直接在<%%>里书写 scriptlet时，却被原封不动地输了出来，于是就尝试引入JSTL，以便使用其中的<c:url value=""/>标签来达到同样目的：

Freemarker代码  

<#assing c=JspTaglibs["http://java.sun.com/jsp/jstl/core"]>
<@c.out value="url"/>

同时将JSTL所需.jar文件都放置在/WEB-INF/lib目录下以及将c.tld文件放置在/WEB-INF目录下，结果却一直报错。在网 上到处搜索，包括国外的论坛，发现这个问题一直普遍存在，用了许多别人给出的方法都依然无法解决。正当我苦恼不己时，突然想到上次曾经使用过 Freemarker的自定义方法，而我这次只不过是需要使用一个简单的方法而已，自己封装一下使之成为Freemarker支持的方法不就行了，何必大 费周折呢？

　　要想使用Freemarker支持的自定义方法，需要实现freemarker.template.TemplateMethodModel接 口，然后将方法对象放入到Freemarker的数据模型中，这样在ftl文件中便可以像使用Freemarker内置方法一样使用该方法了。

import java.util.List;
import javax.servlet.http.HttpServletResponse;
import freemarker.template.TemplateMethodModel;
import freemarker.template.TemplateModelException;

/**
 * Freemarker自定义方法
 * 实现response.encodeURL(url)功能
 */
public class EncodeURLMethod implements TemplateMethodModel {
	
	private HttpServletResponse response;
	
	/**
	 * 带参数的构造函数
	 * @param response HttpServletResponse对象
	 */
	public EncodeURLMethod(HttpServletResponse response)
	{
		this.response=response;
	}

	/**
	 * 执行方法
	 * @param argList 方法参数列表
	 * @return Object 方法返回值
	 * @throws TemplateModelException
	 */
	public Object exec(List argList) throws TemplateModelException {
		if(argList.size()!=1)   //限定方法中必须且只能传递一个参数
		{
			throw new TemplateModelException("Wrong arguments!");
		}
		//返回response.encodeURL执行结果
		return response.encodeURL((String)argList.get(0));
	}
}

 

 　　输出模版数据模型时，将EncodeURLMethod的实例对象放入模型中：

Java代码  

1. dataMap.put("encodeURL", new EncodeURLMethod(context.getResponse()));  

 

　　在Freemarker模版文件中这样使用：

Freemarker代码  

1. ${encodeURL("/news/showNews.sf?id=123456")}  

 

　　输出结果实际就是使用response.encodeURL输出的结果。