点我吧工作总结（技术篇） Velocity

1. 什么是velocity

　　Velocity[vəˈlɑ:səti]，名称字面翻译为：速度、速率、迅速。该项目的开源地址：http://velocity.apache.org/，它是一个基于Java的模板引擎，什么叫基于Java的模板引擎，就是说，在velocity中可以直接引用Java定义的对象。Velocity将java代码从web页面中分离出来，这样为web站点的长期维护提供了便利，同时也为我们在JSP和PHP之外又提供了一种可选的方案。

2. Velocity是怎么被解析的

　　我们知道使用jsp技术，让Java代码出现在view层，不易于维护，增加了前端代码量。而velocity则正是jsp技术的替代者。velocity是一种template引擎，利用先编辑完的格式来作为大纲，把一些需要变化的地方作为参数传入，显示时将模板和参数合并，达到最终输出的样子。

3. Velocity渲染过程 

1. 首先初始化启动Velocity引擎，可以通过 Velocity.init()或者新建VelocityEngine类，并调用其中的init()方法； 
2. 创建一个 VelocityContext对象，将变量名与值关联起来，与HashMap对象相类似。可以直接将值传递给页面进行引用；
3. 获取一个模板，利用Velocity.getTemplate()获取一个渲染模板，即要将数据最终渲染在哪个页面上去。
4. 创建一个输出流，将上述创建的数据最终渲染到模板上，采用的方法template.merge()。

try {
            Velocity.init("velocity.properties");
            VelocityContext context = new VelocityContext();
            String templateFile = "template.vm";
            context.put("paramObject", "onlyone");
            Template template = null;
            template = Velocity.getTemplate(templateFile);
            BufferedWriter writer = new BufferedWriter(new FileWriter("velocity.data"));
            if (template != null) template.merge(context, writer);
            writer.flush();
            writer.close();
        } catch (Exception e) {
            e.printStackTrace();
        }

4. Velocity与SpringMVC的整合

<dependency>
    <groupId>org.apache.velocity</groupId>
    <artifactId>velocity</artifactId>
    <version>1.7</version>
</dependency>

<dependency>
    <groupId>org.apache.velocity</groupId>
    <artifactId>velocity-tools</artifactId>
    <version>2.0</version>
</dependency>

　　首先，需要在Maven项目中的pom.xml中引入velocity-1.7.jar包和velocity-tools-generic-2.0.jar包，为SpringMVC配置多视图，并添加velocity的视图配置(由于Velocity是用来连接Model和View层的)，既然，Velocity是要依赖于SpringMVC的，那么我们先看看在Web.xml中对于SpringMVC的相关配置，

<!--Spring 服务层的配置文件 -->
    <context-param>                   
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:applicationContext.xml</param-value>
    </context-param>
    
    <!--Spring 容器启动监听器 -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <!--  Spring MVC 的Servlet，它将加载WEB-INF/springDispatcher-servlet.xml 的配置文件，以启动Spring MVC模块-->
    <servlet>
    <servlet-name>springDispatcher</servlet-name>
    <servlet-class>
      org.springframework.web.servlet.DispatcherServlet
    </servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>
        /WEB-INF/springDispatcher-servlet.xml
      </param-value>
    </init-param>
    </servlet>

    <servlet-mapping>
        <servlet-name>springDispatcher</servlet-name>
        <url-pattern>*.do</url-pattern>
    </servlet-mapping>

Spring MVC是基于DispatcherServlet来拦截请求，并找到相应的控制器进行业务逻辑处理。从web.xml中，我们可以看到web容器在启动的时候，它会加载

WEB-INF/springDispatcher-servlet.xml的配置文件，来启动MVC模块，所以我们的Velocity相关信息要配置在springDispatcher-servlet.xml中

<--1、对模型视图名称的解析，即在模型视图名称添加前后缀 -->
<bean id="viewResolver" class="org.springframework.web.servlet.view.velocity.VelocityViewResolver">
<property   name="allowSessionOverride" value="true"/>
<property   name="exposeSessionAttributes" value="true"/>
<property name="cache" value="true"/>
<property name=”prefix” value=”/WEB-INF/templates/”/>
<property name="suffix" value=".vm"/>
<property name="contentType">
    <value>text/html;charset=UTF-8</value>
</property>
</bean>

<--2、velocity的一些设置 -->
<bean id="velocityConfig" class="org.springframework.web.servlet.view.velocity.VelocityConfigurer">   
<property   name="resourceLoaderPath">  
        <value>velocity/</value>                          
</property>
<property   name="velocityProperties">  
       <props>  
         <prop   key="input.encoding">UTF-8</prop>  
         <prop   key="output.encoding">UTF-8</prop>
         <prop key="contentType">text/html;charset=UTF-8</prop>    
       </props>  
</property> 
</bean>

这部分配置文件中，主要配置两个部分：velocityViewResolver( 配置Velocity视图解析器)和velocityConfigurer(配置Velocity引擎)在配置的第一部分，我们定义了模型视图名称的解析规则，即使用了velocity模板视图解析器：VelocityViewResolver，因为在SpringMVC中有视图解析器viewResolver，通过这段配置文件，我们可以寻找采用模板的视图配置。于此同时，还定义了*.vm模板在后端的存放路径，这样Spring就与velocity模板技术整合起来了。在配置的第二部分，则定义了velocity的一些属性配置，包括定义前端显示页面的存放路径和页面的编码格式等。

此外，我们参考一下SpringMVC中解析jsp的视图解析器的配置，参考配置如下：

<!-- SpringMVC默认的视图解析器ViewResolver,负责解析jsp文件 -->   
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">  
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView" />  
        <property name="prefix" value="/WEB-INF/" />  
        <property name="suffix" value=".jsp" />  
    </bean>  

5. Velocity与WebX的整合

6. Velocity源码分析及性能优化

　　http://agapple.iteye.com/blog/1051724

7. Velocity常用语法回顾

　　http://www.cnblogs.com/yjmyzz/p/4146699.html