spring-velocity

spring velocity 2.2 版本支持。由于 spring 4.3 版本后不再支持 velocity，所以开发了这个项目。

该项目基于 spring 旧版的 velocity 代码开发。相对原版的代码，主要做了 velocity 版本的升级，并无较大改动。

使用

引入依赖

<dependency>
    <groupId>org.yg.spring</groupId>
    <artifactId>spring-velocity</artifactId>
    <version>1.0.1</version>
</dependency>

Spring Config 配置

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.ui.velocity.SpringResourceLoader;
import org.springframework.web.servlet.config.annotation.ViewResolverRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import org.springframework.web.servlet.view.velocity.VelocityConfigurer;
import org.springframework.web.servlet.view.velocity.VelocityLayoutViewResolver;

import java.util.Properties;

@Configuration
public class WebmvcConfig implements WebMvcConfigurer {

    @Bean
    public VelocityConfigurer velocityConfigurer() {
        VelocityConfigurer velocityConfigurer = new VelocityConfigurer();
        // 模板加载路径
        velocityConfigurer.setResourceLoaderPath("classpath:templates");

        // 自定义 velocity 属性
        Properties properties = new Properties();
        // 关闭 velocity 层面的缓存（注意线上开启）
        properties.setProperty(SpringResourceLoader.SPRING_RESOURCE_LOADER_CACHE, "false");
        velocityConfigurer.setVelocityProperties(properties);

        return velocityConfigurer;
    }

    @Override
    public void configureViewResolvers(ViewResolverRegistry registry) {
        // 创建 velocity 视图解析器
        VelocityLayoutViewResolver velocityLayoutViewResolver = new VelocityLayoutViewResolver();
        // 模板文件后缀
        velocityLayoutViewResolver.setSuffix(".vm");
        // 模板文件前缀
        velocityLayoutViewResolver.setPrefix("");
        // 布局模板文件的 key
        velocityLayoutViewResolver.setLayoutKey("layout");
        // 关闭 spring 层的视图缓存（注意线上开启）
        velocityLayoutViewResolver.setCache(false);
        // 默认布局模板文件
        velocityLayoutViewResolver.setLayoutUrl("layout.vm");
        // 工具集合配置
        velocityLayoutViewResolver.setToolboxConfigLocation("toolbox.xml");
        // 设置 Content-Type
        velocityLayoutViewResolver.setContentType("text/html;charset=UTF-8");

        // 注册 velocity 视图解析器
         registry.viewResolver(velocityLayoutViewResolver);
    }
}

示例

layout 文件

布局文件：/templates/layout/layout.vm，内容如下：

<h1>布局文件</h1>
<p>
    $!screen_content
</p>

视图文件

布局文件：/templates/test/index.vm，内容如下：

#set($layout = 'layout/layout.vm')

hello velocity

License

The Spring Framework is released under version 2.0 of the Apache License.