使用过freemarker的肯定其见过如下情况:
java.io.FileNotFoundException: Template xxx.ftl not found.
模板找不到。可能你会认为我明明指定了文件,并且文件存在,但是为什么就是说找不到呢?
经过研究官方的API,原来freemarker在加载模板时,建议使用TemplateLoader,通过TemplateLoader指定从哪个目录开始加载模板,并且把模板加载在缓存中。
API的TemplateLoader是一个接口,他有如下几个实现类:
ClassTemplateLoader, FileTemplateLoader, MultiTemplateLoader, StringTemplateLoader, URLTemplateLoader, WebappTemplateLoader
顾名思义,我们能从类名中猜想到freemarker的模板加载机制,举例说明两个:
1、FileTemplateLoader
此是文件模板加载器,此即可以通过文件的绝对路径加载模板,如:
TemplateLoader templateLoader=null; String path=""; //使用FileTemplateLoader templateLoader=new FileTemplateLoader(new File("项目根路径")); path="/WEB-INF/classes/com/xxx/tag/templates/page/xxx.ftl"; cfg.setTemplateLoader(templateLoader); Template t=cfg.getTemplate(path,"UTF-8");
2、ClassTemplateLoader
此是通过指定类所在的目录来指定模板所在根路径,即指定类在哪个目录,那么这个目录就是加载模板文件的根目录,如下:
Configuration cfg = new Configuration(); TemplateLoader templateLoader=null; String path=""; templateLoader=new ClassTemplateLoader(PageTag.class,"templates/page/"); path="standardd.ftl"; cfg.setTemplateLoader(templateLoader); Template t=cfg.getTemplate(path,"UTF-8");
此即表示比PageTag类所在的目录开始找,找这个目录下的templates/page/目录
其它的加载器原理同上。
如果你是web项目,并且使用了spring,那么。你还可以通过spring来配置你模板文件的根目录,如下:
<bean id="freemarkerConfig" class="org.springframework.ui.freemarker.FreeMarkerConfigurationFactoryBean"> <property name="templateLoaderPath" value="/WEB-INF" /> <property name="freemarkerSettings"> <props> <prop key="defaultEncoding">UTF-8</prop> </props> </property> </bean>
此即表示从WEB-INF目录下开始找。