Freemarker无法使用Session和Taglib

Freemarker中取Session中对象出现Expression Session is undefined异常，

还有在模板中无法使用jsp标签，出现Expression JspTaglibs is undefined异常。

 

其实两个原因是相同的，都是在ftl模板中没有找到对应的对象Session或 JspTaglibs ，通常我们使用freemarker有三种手段。

其一，是通过使用freemarker.ext.servlet.FreemarkerServlet。在web.xml中配置freemarkerServlet就可以通过*.ftl直接访问指定路径的freemarker模板，并生成对应的文件/流进行输出。我认为这种方式最简便的一种，然而其中生成的文件被限定为html或xml文件，编码之类都被统一处理，对于不同输出要进行多次配置。

第二种方式是使用页面框架，这些页面框架都是调用freemarker配置使用模板进行输出，最大好处是与现有框架集成，可以使用页面框架的一些特性，并且可以进行一定程序定制，如指定文件类型和编码等。

第三种方式是手动进行封装，直接调用配置使用模板生成指定的内容。其有个好处，是可以进行定制，如文件类型和编码都可以进行指定的配置，并且更多人是使用模板生成指定文件进行页面静态化，程序员通过将后台信息使用freemarker生成静态文件，再由用户进行调用。

 

通常前两种方式对一些数据对象封装使得使用模板时能进行调用，可以满足用户需求。而开始列出的两个错误通常出现在手工进行封装的时候。举代码为例：

    public static void crateHTML(ServletContext context,Map<String,Object> data,String templatePath,String targetHtmlPath){
        Configuration freemarkerCfg = new Configuration();
        //加载模版
        freemarkerCfg.setServletContextForTemplateLoading(context, "/");
        freemarkerCfg.setEncoding(Locale.getDefault(), "UTF-8");
        try {
            //指定模版路径
            Template template = freemarkerCfg.getTemplate(templatePath,"UTF-8");
            template.setEncoding("UTF-8");
            //静态页面路径
            String htmlPath = context.getRealPath("/html")+"/"+targetHtmlPath;
            File htmlFile = new File(htmlPath);
            Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(htmlFile), "UTF-8"));
            //处理模版  
            template.process(data, out);
            out.flush();
            out.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

 在以上代码中，就会出现问题，直接调用template进行输出时，并没有封装Session，JspTaglibs等对象，所以会报找不到对应对象的错误，也就不能使用Jsp标签了。

可以改为：

	public static void crateHTML(HttpServletRequest request, Map data,
			String templatePath, String targetHtmlPath) {
		Configuration freemarkerCfg = new Configuration();
		// 加载模版
		freemarkerCfg.setServletContextForTemplateLoading(request.getSession()
				.getServletContext(), "/");
		freemarkerCfg.setEncoding(Locale.getDefault(), "UTF-8");
		try {
			// 指定模版路径
			Template template = freemarkerCfg
					.getTemplate(templatePath, "UTF-8");
			template.setEncoding("UTF-8");
			// 静态页面路径
			String htmlPath = request.getSession().getServletContext()
					.getRealPath("/html")
					+ "/" + targetHtmlPath;
			File htmlFile = new File(htmlPath);
			Writer out = new BufferedWriter(new OutputStreamWriter(
					new FileOutputStream(htmlFile), "UTF-8"));
			// 处理模版

			data.put("Request", request);
			data.put("Session", request.getSession());
			data.put("JspTaglibs", new TaglibFactory(request.getSession()
					.getServletContext()));
			
			template.process(data, out);
			out.flush();
			out.close();
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

 这时，在ftl模板中就可以调用Request,Session,JspTaglibs等对象了。

 

注：在Struts2中封装的Freemarker视图也不能在ftl模板中使用JspTaglibs对象，可能通过在web.xml文件中配置：

	<servlet>
		<servlet-name>JSPSupportServlet</servlet-name>
		<servlet-class>
			org.apache.struts2.views.JspSupportServlet
		</servlet-class>
		<load-on-startup>1</load-on-startup>
	</servlet>

 这时，在ftl模板中可以使用Jsp标签了。

评论

4 楼 Seanman 2015-03-09  

cuiyan3327 写道

你好，看了您的帖子，非常好！
我也正在使用freemarker，并且按你文章的方法进行了配置，JspTaglibs不报：Expression JspTaglibs is undefined这个错误了，但是还是报了以下异常
异常信息：
Could not find an instance of freemarker.ext.servlet.ServletContextHashModel in the data model under either the name __FreeMarkerServlet.Application__ or Application
能否帮我看看是什么原因么？

解决了么

3 楼 Seanman 2015-03-09  

Could not find an instance of freemarker.ext.servlet.ServletContextHashModel in the data model under either the name __FreeMarkerServlet.Application__ or Application

2 楼 zhfally520 2013-04-03  

感谢楼主啊，解决了Expression JspTaglibs is undefined的错误

1 楼 cuiyan3327 2010-04-30  

你好，看了您的帖子，非常好！
我也正在使用freemarker，并且按你文章的方法进行了配置，JspTaglibs不报：Expression JspTaglibs is undefined这个错误了，但是还是报了以下异常
异常信息：
Could not find an instance of freemarker.ext.servlet.ServletContextHashModel in the data model under either the name __FreeMarkerServlet.Application__ or Application
能否帮我看看是什么原因么？