Maven 工程下 Spring MVC 站点配置 (一)

最近，查找一些具体资料时，虽然会有很多，但是系统的却很少，尤其是对maven 下 spring mvc 站点搭建的配置，总是说的很多但让新手一目了然的步骤却少之又少.

对此闲暇时整理了一下，做了一套较为完整的图文配置系列流程，供新手参考；

Maven 工程下 Spring MVC 站点配置 (一)

Maven 工程下 Spring MVC 站点配置 (二) Mybatis数据操作

Eclipse IDE 工具版本：

Eclipse Java EE IDE for Web Developers.

Version: Luna Service Release 1 (4.4.1)

Build id: 20140925-1800 

首先创建一个Maven工程：

File --> New --> Other，然后选择Maven目录下的Maven Project，如下图：

然后在弹出的面板中选择选择配置后，下一步即可，如图：

Create a simple project (skip archetype selection) ：此选项表示跳过后续的配置选项框。

Use default Workspace location：表示将项目放置到默认的工作区域下。

配置好后，Next下一步，再进行如下图的配置：

点击Finish后，便完成了Maven工程的创建。

此时在你开发工具的Workspace工作区的树桩菜单中出现了McqueenXingSpring这个项目工程.如图：

接下来我们进行详细的项目搭建，首先配置maven 工程文件 pom.xml，

因为我们要搭建Spring MVC这个工程，所以就要将相关的jar包配置到Maven工程中进行引用管理；

pom.xml文件配置如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>McqueenXingSpring</groupId>
  <artifactId>McqueenXingSpring</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>war</packaging>
      <dependencies>
          <!-- 支持servlet的jar包 -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
            <version>2.5</version>
            <scope>provided</scope>
        </dependency>
        <!-- Spring MVC 依赖配置 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>4.1.2.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
            <version>4.1.2.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>4.1.2.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-beans</artifactId>
            <version>4.1.2.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>4.1.2.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context-support</artifactId>
            <version>4.1.2.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context-support</artifactId>
            <version>4.1.2.RELEASE</version>
        </dependency>
    </dependencies>

</project>

Maven配置好后，我们就需要在项目中进行WEB站点搭建了；

因为一开始创建Maven工程时，选择的是 Create a simple project 属性，

所以在webapp项目下可能会没有任何文件，如图：

这个时候就需要我们自己去创建它们。

首先在 webapp 下增加一个 WEB-INF 文件夹；

然后在 WEB-INF 文件夹中增加一个 web.xml(部署描述符文件);

接下来我们就要在这个文件中进行一些配置工作；

我们先解决编码问题， 这个是经常会遇到并且让人头疼的问题，内容如下：

<filter>
    <filter-name>Set Character Encoding</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>
    <init-param>
        <param-name>Set Character Encoding</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>Set Character Encoding</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

然后在WEB-INF中增加一个 mcqueenxing-servlet.xml 文件；

这个文件的作用是配置Spring和servlet容器的，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"   
       xmlns:aop="http://www.springframework.org/schema/aop"   
       xmlns:context="http://www.springframework.org/schema/context"  
       xmlns:mvc="http://www.springframework.org/schema/mvc"   
       xmlns:tx="http://www.springframework.org/schema/tx"   
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
       xsi:schemaLocation="http://www.springframework.org/schema/aop   
        http://www.springframework.org/schema/aop/spring-aop-3.0.xsd   
        http://www.springframework.org/schema/beans   
        http://www.springframework.org/schema/beans/spring-beans-3.0.xsd   
        http://www.springframework.org/schema/context   
        http://www.springframework.org/schema/context/spring-context-3.0.xsd   
        http://www.springframework.org/schema/mvc   
        http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd   
        http://www.springframework.org/schema/tx   
        http://www.springframework.org/schema/tx/spring-tx-3.0.xsd">  
  
    <!-- 激活@Controller -->
    <mvc:annotation-driven />
    <!-- 自动扫描工程包. -->
    <context:component-scan base-package="mcqueen.controller" />
        <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/" />  
        <property name="suffix" value=".jsp" />  
    </bean>
</beans>

在上面这个配置文件中我们看到这样一个节点中的内容，base-package="mcqueen.controller"；

这个mcqueen.controller就是你架构网站时的包结构；

那么我们把它创建出来，如图：

在这个包下面增加一个IndexController.java文件，内容如下：

 1 package mcqueen.controller;
 2 
 3 import org.springframework.stereotype.Controller;
 4 import org.springframework.ui.Model;
 5 import org.springframework.web.bind.annotation.RequestMapping;
 6 
 7 @Controller
 8 public class IndexController {
 9     
     @RequestMapping(value="index.html")
     public void index(Model m){
         m.addAttribute("result", "Yor are welcome to use Spring MVC, My name is Mcqueen Xing.");
     }
 }

然后我们再从网站 WEB-INF 目录下增加一个 views 目录，并增加一个index.jsp文件，如图：

在jsp页面body中增加以下html代码：

<h1>${ result }</h1>

这段代码适用于将后台Controller 传递过来的参数输出到页面上；

接下来回头找到/WEB-INF/web.xml文件，我们在里面增加一组Spring MVC的拦截配置，代码如下：

 1 <servlet> 2     <servlet-name>mcqueenxing</servlet-name>
 3     <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
 4     <init-param>
 5         <param-name>contextConfigLocation</param-name>
 7         <param-value>/WEB-INF/mcqueenxing-servlet.xml</param-value>
 8     </init-param>
 9     <load-on-startup>1</load-on-startup>
 </servlet>
 <servlet-mapping>
     <servlet-name>mcqueenxing</servlet-name>
     <url-pattern>*.html</url-pattern>
 </servlet-mapping>

配置到此时，Spring MVC 站点基本已经配置完成。

启动调试运行后，如图：