Board logo

标题: freemarker认识一 [打印本页]

作者: wangliang_gz    时间: 2010-4-12 12:50     标题: 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">

[ 本帖最后由 wangliang_gz 于 2010-4-12 16:29 编辑 ]




欢迎光临 Java2Class (http://www.java2class.net/bbs/) Powered by Discuz! 6.1.0