freemarker认识一

1、freemarker分离模板和数据

2、freemarker通过插值和调用指令来完成数据和模板的合并

插值通过${xxx}

通过标签tag <#调用预定义指令,如<#include "header.tpl"/>

或者<@调用用户自定义指令,如<@myTag  />

3、freemarker对象缺失值(null)的挑剔特性

freemarker对null值尤其挑剔,出现null后马上会终止后续的模板解释,官方解释是说为了避免程序员出现马虎大意的问题。

插值使用!给初始值,或使用<#if指令进行判断

如 ${xxx!}、${xxx!""}、<#if xxx?exists && xxx!=null ><#else></#if>、<#if xxx!=null></#if>

!号对key值是否存在和空值都有判断

4、s2中使用freemarker实现表现层模板

1)尽量保持原型,模板所见即所得原则。

2)不用s2标签。

3)少用freemarker的标签指令

4)将ccs,js,image等网站静态资源和jee web应用分离,在webapp中使用绝对路径的引入。

5)页面传参尽量使用String,传到后台自己格式化。

6)模板尽量不使用<#assign指令,保持模板的被动特性。将数据封装到java中去。

5、s2中使用自定义模板方法

可使用自定义函数进行插值打印或使用自定义指令

UrlMethod.java

 

package app.web.struts2.views.freemarker;

import java.util.List;

import freemarker.template.TemplateMethodModel;

import freemarker.template.TemplateModelException;

public class UrlMethod implements TemplateMethodModel {

@SuppressWarnings("unchecked")

public Object exec(List arg0) throws TemplateModelException {

if(arg0==null) return null;

if(arg0.size()==0) return null;

if(arg0.size()>=1){

String l = arg0.get(0).toString()+".do";

if(arg0.size()>=2){

l= l+"?"+arg0.get(1);

}

return l;

}

return null;

}

}

 

 

FreemarkerManagerEx.java

 

package app.web.struts2.views.freemarker;

import javax.servlet.ServletContext;

import org.apache.struts2.views.freemarker.FreemarkerManager;

import freemarker.template.Configuration;

import freemarker.template.TemplateException;

public class FreemarkerManagerEx extends FreemarkerManager {

@Override

protected Configuration createConfiguration(ServletContext servletContext) throws TemplateException {

Configuration configuration = super.createConfiguration(servletContext);

configuration.setSharedVariable("url",new UrlMethod());

return configuration;

}

}

 

 

struts.properties

struts.freemarker.manager.classname=app.web.struts2.views.freemarker.FreemarkerManagerEx

demo.ftl

<a href="${url(base+'/Home')}">Home</a>

产出html<a href="/Home.do">Home</a>

<a href="${url(base+'/Home','action=doIndex&pageNo=1')}">Home</a>

产出html<a href="/Home.do?action=doIndex&pageNo=1">Home</a>

5、s2中使用自定义指令

 

package app.web.struts2.views.freemarker;

import java.io.IOException;

import java.io.Writer;

import java.util.Map;

import freemarker.core.Environment;

import freemarker.template.TemplateDirectiveBody;

import freemarker.template.TemplateDirectiveModel;

import freemarker.template.TemplateException;

import freemarker.template.TemplateModel;




public class UrlDirectiveModel implements  TemplateDirectiveModel{




public void execute(Environment env, Map arg1, TemplateModel[] arg2,TemplateDirectiveBody arg3) throws TemplateException, IOException {

freemarker.template.SimpleScalar urlx = (freemarker.template.SimpleScalar)arg1.get("action");

String pa=null;

if(arg1.containsKey("parameters")){

freemarker.template.SimpleScalar parameters = (freemarker.template.SimpleScalar)arg1.get("parameters");

pa = parameters.getAsString();

}

        String url = urlx.getAsString();;

        Writer writer = env.getOut();

        writer.write("<a href=\""+url+".do"+(pa!=null?"?"+pa:"" )+"\">");

        if(arg3!=null){

        arg3.render(writer);

        }

        writer.write("</a>");

writer.flush();

}

}

 
 

 

FreemarkerManagerEx.java

package app.web.struts2.views.freemarker;

import javax.servlet.ServletContext;

import org.apache.struts2.views.freemarker.FreemarkerManager;

import freemarker.template.Configuration;

import freemarker.template.TemplateException;

public class FreemarkerManagerEx extends FreemarkerManager {

@Override

protected Configuration createConfiguration(ServletContext servletContext) throws TemplateException {

Configuration configuration = super.createConfiguration(servletContext);

configuration.setSharedVariable("urlTag",new UrlDirectiveModel());

return configuration;

}

}

 

demo.ftl

<@urlTag action="${base+'/Home'}" parameters="action=doIndex">Home</@urlTag>

产出html<a href="/Home.do?action=doIndex">Home</a>

6、宏macro的使用

macro可以在模板中预定义模板,感觉跟自定义指令类似

如

demo.tpl

<#macro myTag arg0 arg1>

helloworld ${arg0!}

<#nested>

</#macro>

<@myTag arg0="xxx" arg1="">

ok,bye~

</@myTag>

7、<#include和<#import

<#import 可以以别名的形式引入宏库

<#import "/libs/mylib.ftl" as my>

<@my.copyright date="1999-2002"/>

include插入另外一个模板

<#include "/common/navbar.html" parse=false encoding="UTF-8">

8、Expecting a string, date or number here, Expression xxxBean.yyyBean.initialPageSize is instead a freemarker.ext.beans.SimpleMethodModel

在tpl中 ${xxxBean.yyyBean.initialPageSize}

可以确认xxxBean.yyyBean.initialPageSize不等于空，就是无法显示。几经调试终于发现问题，yyyBean中的initialPageSize属性不能和方法名重复，即

yyyBean{

private String initialPageSize; //(1)

public void setInitialPageSize(String s){this.initialPageSize=s;}

public String getInitialPageSize(){return this.initialPageSize;}

public void initialPageSize(String xxx){}//(2)此方法不能存在,方法名和类成员(1)重复了。

}