springboot1.5.x 版本后使用 velocity 模板

由于springboot在1.5.x版本開始不支持velocity(https://jira.spring.io/browse/SPR-13235)重父,之后的版本若想使用要自己配置铲咨。

image.png

但是由于客觀因素需要族沃,在此簡要記錄我的配置方法辩恼,springboot版本以 2.1.4.RELEASE 為例。
說白了就是缺啥補啥感凤。

1. 指定 spring-boot-starter-velocity 的 maven 配置版本

由于1.5.x后默認不支持鳍寂,所以要手動指定苍在。如下圖:


image.png

2. 添加類庫中刪除的文件

由于有關velocity配置以及渲染的類都來源于spring-context-support.jar以及spring-webmvc.jar這兩個包中塘辅。而在這兩個包最新的版本中晃虫,所有有關velocity的類全都刪除了,所以要手動添加相關的類文件扣墩。我這里使用4.3.x的包版本哲银,要添加的包括

  1. https://github.com/spring-projects/spring-framework/tree/4.3.x/spring-context-support/src/main/java/org/springframework/ui/velocity
  2. https://github.com/spring-projects/spring-framework/tree/4.3.x/spring-webmvc/src/main/java/org/springframework/web/servlet/view/velocity
    以上兩個路徑下的文件,添加后工程目錄結構如圖:
    image.png

    然后各種依賴關系以及package的路徑梳理清楚

3. 添加spring.vm并更改路徑

https://github.com/spring-projects/spring-framework/tree/4.3.x/spring-webmvc/src/main/resources/org/springframework/web/servlet/view/velocity
路徑下有一個 spring.vm 的模板文件呻惕,由于我們加入的類中啟動用到了這個盘榨,所以需要添加到工程中(其實改一下類文件不要用到也行,但是懶得改了蟆融,加進來就好了)。我添加到了 /resources/templates/ 目錄下守呜。
添加后要注意修改 VelocityConfigurer 類中的 SPRING_MACRO_LIBRARY 常量配置型酥,改為自己添加該文件的路徑山憨。如下圖:

image.png

4. 添加自己的 velocity 相關配置

自定義 VelocityConfigurer 和 VelocityViewResolver 并添加為 bean。具體的配置代碼如下:

@Configuration
public class MyVelocityConfig extends WebMvcConfigurerAdapter {
    //配置 velocity bean
    @SuppressWarnings("deprecation")
    @Bean
    public VelocityConfigurer velocityConfigurer(ApplicationContext context) {
        VelocityConfigurer config = new VelocityConfigurer();
        Properties properties = new Properties();
        properties.put("input.encoding", "UTF-8");
        properties.put("output.encoding", "UTF-8");
        config.setVelocityProperties(properties);
        return config;
    }

    //配置 velocity 視圖解析器
    @SuppressWarnings("deprecation")
    @Bean
    public VelocityViewResolver velocityResolver() {
        VelocityViewResolver resolver = new VelocityViewResolver();
        resolver.setCache(false);
        resolver.setPrefix("/templates/");
        resolver.setSuffix(".vm");
        resolver.setContentType("text/html;charset=UTF-8");
        resolver.setExposeSpringMacroHelpers(true);
        resolver.setExposeRequestAttributes(true);
        //設置RequestContext在視圖頁面中的變量名,以便使用${request}獲取
        resolver.setRequestContextAttribute("request");
        return resolver;
    }
}

也可以將配置寫在專門的配置文件中弥喉,用 setConfigLocation 的方式引入郁竟。

5. 配置完成,寫測試類由境,進行測試棚亩。

結果如圖:


image.png

極簡版(只為了velocity測試)的demo已經(jīng)上傳 https://github.com/LiangliangW/velocity
,可以自行取需虏杰。

提醒:這樣強行適配可能產(chǎn)生一定性能問題讥蟆,如并發(fā)量較低,請結合自身業(yè)務取用纺阔,生產(chǎn)環(huán)境一定提前壓測瘸彤。最佳建議還是使用其他更新的模板。

最后編輯于
?著作權歸作者所有,轉載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末笛钝,一起剝皮案震驚了整個濱河市质况,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌玻靡,老刑警劉巖结榄,帶你破解...
    沈念sama閱讀 218,204評論 6 506
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異囤捻,居然都是意外死亡臼朗,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,091評論 3 395
  • 文/潘曉璐 我一進店門最蕾,熙熙樓的掌柜王于貴愁眉苦臉地迎上來依溯,“玉大人,你說我怎么就攤上這事瘟则±杪” “怎么了?”我有些...
    開封第一講書人閱讀 164,548評論 0 354
  • 文/不壞的土叔 我叫張陵醋拧,是天一觀的道長慷嗜。 經(jīng)常有香客問我,道長丹壕,這世上最難降的妖魔是什么庆械? 我笑而不...
    開封第一講書人閱讀 58,657評論 1 293
  • 正文 為了忘掉前任,我火速辦了婚禮菌赖,結果婚禮上缭乘,老公的妹妹穿的比我還像新娘。我一直安慰自己琉用,他們只是感情好堕绩,可當我...
    茶點故事閱讀 67,689評論 6 392
  • 文/花漫 我一把揭開白布策幼。 她就那樣靜靜地躺著,像睡著了一般奴紧。 火紅的嫁衣襯著肌膚如雪特姐。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,554評論 1 305
  • 那天黍氮,我揣著相機與錄音唐含,去河邊找鬼。 笑死沫浆,一個胖子當著我的面吹牛捷枯,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播件缸,決...
    沈念sama閱讀 40,302評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼铜靶,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了他炊?” 一聲冷哼從身側響起争剿,我...
    開封第一講書人閱讀 39,216評論 0 276
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎痊末,沒想到半個月后蚕苇,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,661評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡凿叠,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,851評論 3 336
  • 正文 我和宋清朗相戀三年涩笤,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片盒件。...
    茶點故事閱讀 39,977評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡蹬碧,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出炒刁,到底是詐尸還是另有隱情恩沽,我是刑警寧澤,帶...
    沈念sama閱讀 35,697評論 5 347
  • 正文 年R本政府宣布翔始,位于F島的核電站罗心,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏城瞎。R本人自食惡果不足惜渤闷,卻給世界環(huán)境...
    茶點故事閱讀 41,306評論 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望脖镀。 院中可真熱鬧飒箭,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,898評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至盈匾,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間毕骡,已是汗流浹背削饵。 一陣腳步聲響...
    開封第一講書人閱讀 33,019評論 1 270
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留未巫,地道東北人窿撬。 一個月前我還...
    沈念sama閱讀 48,138評論 3 370
  • 正文 我出身青樓,卻偏偏與公主長得像叙凡,于是被迫代替她去往敵國和親劈伴。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 44,927評論 2 355

推薦閱讀更多精彩內(nèi)容