web项目环境搭建（2）：整合SpringMVC+velocity

velocity是一个基于java的模板引擎。velocity应用于web开发时，前端设计人员可以只关注页面的显示效果，而java程序人员只关注业务逻辑代码。velocity将java代码从web页面中分离出来。

当然velocity还有其他用途，例如，它可以从模板中产生SQL和POSTScript、xml，它也可以被当做一个独立工具产生源码和报告。

我们公司就是用velocity来产生ibatis所有的sql-mapper配置文件，dao文件，避免做重复工作，为我们节省了很多开发时间。

好，下面开始。

• 首先在eclipse中建立一个maven工程，在骨架选择中选择maven-archetype-webapp新建一个web骨架的简单项目

• 然后在pom文件中引入相关的依赖

<properties>
        <!-- velocity -->
        <velocity.version>1.7</velocity.version>
        <velocityTools.version>2.0</velocityTools.version>
</properties>
<dependency>
    <groupId>org.apache.velocity</groupId>
    <artifactId>velocity-tools</artifactId>
    <version>${velocityTools.version}</version>
</dependency>

<dependency>
    <groupId>org.apache.velocity</groupId>
    <artifactId>velocity</artifactId>
    <version>${velocity.version}</version>
</dependency>

• spring-mvc配置文件，
  
  在src/main/resources下建立一个spring目录，新建一个文件：spring-mvc.xml
  
  这个文件放在这个目录下。
  
  配置文件里内容是：配置一个注解扫描的包，一个velocity解析器，一个velocity配置
  
  直接上了：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"
    xmlns:context="http://www.springframework.org/schema/context"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd">

    <!-- 使用注解的包，包括子集 -->
    <context:component-scan base-package="com.bench.app.ebuy" />

    <!-- velocity视图解析器 -->
    <bean id="viewResolver"
        class="org.springframework.web.servlet.view.velocity.VelocityViewResolver">
        <property name="contentType" value="text/html;charset=UTF-8" />
        <property name="suffix" value=".vm" />
    </bean>

    <!-- velocity配置 -->
    <bean id="velocityConfigurer"
        class="org.springframework.web.servlet.view.velocity.VelocityConfigurer">
        <property name="resourceLoaderPath">
            <value>WEB-INF/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>
                <prop key="velocimacro.library">macro/macros.vm</prop>
            </props>
        </property>
    </bean>
</beans>

注意：注解扫描里面，需要配置你自己建的包

velocity配置里面，有一个配置是resourceLoaderPath，所有的vm文件都是放在这个目录下，所有你需要在WEB-INF下，建立一个velocity目录。

还有一个配置是velocimacro.library这里是velocity宏配置

• 配置web.xml
  
  这里是一个DispatchServlet分发器配置和一个filter，用来解决乱码的

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
    id="WebApp_ID" version="2.5">
    <display-name>ebuy</display-name>

    <welcome-file-list>
        <welcome-file>index.html</welcome-file>
    </welcome-file-list>

    <servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring/spring-mvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>*.do</url-pattern>
    </servlet-mapping>

    <filter>
        <filter-name>characterEncodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>utf-8</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>characterEncodingFilter</filter-name>
        <url-pattern>*.do</url-pattern>
    </filter-mapping>
</web-app>

• 然后建立四个包
  
  controller,dao,model,service
  
  在controller下写一个类DemoControler，

/**
 * 测试控制器
 * @author
 *
 */
@Controller
public class DemoController {

    @RequestMapping("/toNewPage.do")
    public String doGet() {
        return "newPage";
    }
}

并且在velocity目录下新建一个文件，newPage.vm。运行在tomcat里，访问

http://localhost:8080/ebuy/toNewPage.do 如果跳到相应的页面，说明成功了。