Freemarker自定义方法

在项目中有一个需求,每个物品有一个guid,存在数据库中,而在页面上需要显示一个对应的业务数据值,暂且叫做serverId,serverId是通过guid移位计算得来。serverId只需要显示,后台并不需要使用。

因为serverId在后台用不到,所以就没有使用VO字段来 存储,项目使用了Freemarker作为view层的模板引擎。了解到Freemarker的一个特点是具有很多内置的功能强大的方法,例如 substring、upper_case等。最重要的是Freemarker支持自定义方法。所以就考虑到了通过自定义Freemarker方法来解 决。具体步骤如下:

Freemarker实现自定义方法很简单,只需要实现freemarker.template.TemplateMethodModel接口就行了。具体代码如下所示:

Java代码

import java.util.List;

import freemarker.template.TemplateMethodModel;
import freemarker.template.TemplateModelException;

/**
 * ClassName:GuidToServerIdUtil <br/>
 * Function: Freemarker自定义方法,通过guid位移48位计算serverId. <br/>
 * Date:     2012-12-26 下午09:09:35 <br/>
 * @author   chenzhou
 * @version  
 * @since    JDK 1.6
 */
public class GuidToServerIdUtil implements TemplateMethodModel {

	@Override
	public Object exec(List args) throws TemplateModelException{
		//参数列表的第一位为guid
		long guid = Long.parseLong(args.get(0).toString());
		//通过guid位移48位计算serverId
		int serverId = (int) (guid >>> 48);
		return serverId;
	}

}

如上面代码所示 ,GuidToServerIdUtil类定义了一个exec方法,此方法内的逻辑就是自定义Freemarker方法的执行逻辑。代码很简单,把guid当做第1个参数传递进来,然后执行移位计算后返回计算后的结果。

定义了GuidToServerIdUtil类之后我们如果需要在ftl页面中使用还需要在项目的xxx-servlet.xml中进行配置,具体配置如下:

Xml代码

<!--配置视图解析器,使用FreeMarker视图 -->
<bean id="viewResolver"
	class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
	<property name="viewClass"
		value="org.springframework.web.servlet.view.freemarker.FreeMarkerView"></property>
	<property name="exposeSessionAttributes" value="true"></property>
	<property name="exposeRequestAttributes" value="true"></property>
	<property name="suffix" value=".ftl"></property>
	<property name="contentType" value="text/html;charset=utf-8"></property>
	<property name="attributesMap">
		<map>
			<!-- 定义Freemarker方法的名称 -->
			<entry key="guid2sid">
				<!-- 关联到我们之前定义的工具类 -->
				<bean class="com.chenzhou.examples.erm.util.GuidToServerIdUtil" />
			</entry>
		</map>
	</property>
</bean>

上面配置文件中,我们定义了方法的名称为guid2sid,然后关联到了GuidToServerIdUtil类。配置完后,我们就可以在ftl页面中使用了:

Freemarker自定义方法

页面显示结果如下:

Freemarker自定义方法

说明guid2sid方法已经生效了。

除了在配置文件中定义后使用之外,我们也可以直接把方法对象放入到Freemarker的数据模型中,然后在ftl文件中使用。具体示例如下(注意我把方法命名为guid2serverId):

//在Controller方法中把方法对象存入数据模型中  
model.put("guid2serverId", new GuidToServerIdUtil());  

 然后在ftl使用方法还是一样:

Freemarker自定义方法

结果如下:

Freemarker自定义方法

相关推荐