Java - FreeMarker + Spring MVC 如何設定

2015-07-10 11:31 AM

使用 Java 撰寫網頁最基本的是使用 JSP 產生的動態格式文件

但有使用過的都知道其實 JSP 與 HTML 語法混雜的可讀性非常之差

就我本身的立場而言 template 能有多單純就多單純

最好只用到輸出變數, 迴圈以及為數不多的判斷式就好

當然最重要的就是可以不用重啟伺服器就能讀取修改後的 template 這個功能

而 FreeMarker 剛好符合我的需求

是一個設定方便, 反應迅速並且保持 HTML 一致性的輕量級模板引擎

之前雖也有考慮過 Thymeleaf 這個模板引擎

他搭配 HTML 的一致性可以說是在 FreeMarker 之上

但似乎不能用來產生非 XML 格式的動態文件

因此就放棄使用 Thymeleaf 了

那麼以下我們就來看看 FreeMarker 搭配 Spring 的設定檔該如何使用

程式碼範例

<!-- 使用FreeMarker Templates -->
<bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
    <property name="templateLoaderPath" value="/WEB-INF/views/freemarker"/>
    <property name="defaultEncoding" value="UTF-8" /> 
    <property name="freemarkerSettings">  
        <props>
            <prop key="template_update_delay">10</prop>  
            <prop key="locale">zh_TW</prop>  
            <prop key="datetime_format">yyyy-MM-dd HH:mm:ss</prop>  
            <prop key="date_format">yyyy-MM-dd</prop>
            <prop key="time_format">HH:mm:ss</prop>
            <prop key="number_format">#.##</prop>
            <prop key="boolean_format">true,false</prop>
            <prop key="object_wrapper">beans</prop>
            <prop key="template_exception_handler">mvc.controller.exception.resolver.FreeMarkerExceptionHandler</prop>
        </props>
    </property>
</bean>

<!-- 設定預設view路徑與副檔名 -->
<bean id="viewResolver" class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
 <property name="viewClass" value="org.springframework.web.servlet.view.freemarker.FreeMarkerView"/>
   <property name="cache" value="true" />
   <property name="suffix" value=".ftl" />
   <property name="contentType" value="text/html;charset=UTF-8" />
   <property name="requestContextAttribute" value="request" />
   <property name="exposeRequestAttributes" value="true" />
    <property name="exposeSessionAttributes" value="false" /> 
    <property name="exposeSpringMacroHelpers" value="true" /> 
</bean>