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

最新推荐文章于 2025-09-10 18:00:18 发布

转载最新推荐文章于 2025-09-10 18:00:18 发布 · 68 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：http://www.cnblogs.com/mcqueen/p/5294855.html

文章标签：

#测试 #web.xml #开发工具

本文详细介绍了如何使用Maven构建工具搭建SpringMVC站点的过程，包括创建Maven项目、配置pom.xml文件引入依赖、设置编码过滤器、配置SpringMVC拦截器等关键步骤。

最近，查找一些具体资料时，虽然会有很多，但是系统的却很少，尤其是对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 >
           
         < dependency >
             < groupId >javax.servlet </ groupId >
             < artifactId >servlet-api </ artifactId >
             < version >2.5 </ version >
             < scope >provided </ scope >
         </ dependency >
         
         < 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" >

     
     < 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
10     @RequestMapping(value="index.html")
11      public void index(Model m){
12         m.addAttribute("result", "Yor are welcome to use Spring MVC, My name is Mcqueen Xing.");
13     }
14 }

然后我们再从网站 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>
10 </servlet>
11 <servlet-mapping>
12     <servlet-name>mcqueenxing</servlet-name>
13     <url-pattern>*.html</url-pattern>
14 </servlet-mapping>