Installing FreeMarker

无需实际安装。只需确保freemarker.jar在 Java 应用程序的类加载器可以找到的位置即可。在 Web 应用程序中,这通常意味着将freemarker.jar放入 Web 应用程序的WEB-INF/lib目录中。 (如果要以 JSP Model-2 样式使用 FreeMarker(这也意味着您可以在模板中使用自定义 JSP taglib),则需要一些额外的步骤。有关更多信息,请参见关于 servlet 的章节。)

FreeMarker 没有必需的依赖项。但是要使用某些可选 FreeMarker 功能,相关方库必须可用于类加载器:

  • XML XPath 支持需要 Jaxen(推荐为download here)或 Apache Xalan。请至少使用 Jaxen 1.1-beta-8,而不是旧版本! Apache Xalan 类包含在 Sun/Oracle J2SE 1.4-1.8 的程序包重定位形式中(可能还会在以后发布),如果 FreeMarker 在其他地方找不到 Jaxen 或 Xalan,则会使用那些类。但是由于 Oracle 可以随时更改这些内部软件包,因此仍然建议使用外部 Jaxen 或 Xalan。

  • 显然,FreemarkerServlet需要javax.servlet个类。需要 Servlet 2.2 或更高版本。

  • 为了获得自定义的 JSP taglib 支持,您将需要 JSP 2.0 API 或更高版本。不需要 JSP 实现,仅需要 API。这几乎已经存在于每个 servlet 容器中。有关更多信息,请参见关于 servlet 的章节

  • Jython 包装器需要 Jython 2.0 或更高版本。

  • 久已弃用的freemarker.ext.jdom软件包需要 1.0 版之前的 JDOM。 (创建它时,还没有 JDOM 1.0. )