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 站点基本已经配置完成。

启动调试运行后，如图：