使用maven一步一步构建spring mvc项目（图文详解）

使用 maven 一步一步构建 Spring MVC 项目是一个非常常用的开发方式。下面我们来详细讲解这个步骤：

步骤一：新建maven项目

1. 打开 Eclipse 或者 IntelliJ IDEA ，点击 File -> New -> Maven Project；
2. 在弹出的对话框中，选择 Create a simple project ，并勾选上 Create a 'Maven Project' 模板文件；
3. 点击 Next，填入 Group ID、Artifact ID 和 version等项目信息，然后点击 Next；
4. 选择默认的 Archetype （ quickstart ），然后点击 Next；
5. 最后确认信息，点击超链接 create a simple project to finish。

步骤二：添加 Spring MVC 相关的依赖

在 pom.xml 中添加以下的依赖：

<dependencies>
  <!-- Spring MVC 相关依赖 -->
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>5.1.6.RELEASE</version>
  </dependency>
  <!-- Jackson 依赖 -->
  <dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.9.9.1</version>
  </dependency>
  <!-- JSTL 相关的依赖 -->
  <dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
  </dependency>
</dependencies>

其中，Spring MVC 依赖为 org.springframework:spring-webmvc 。注意：版本号为当前最新的 5.1.6.RELEASE。

步骤三：配置 web.xml 文件

在 web.xml 文件中添加以下内容：

<!DOCTYPE web-app PUBLIC
        "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
        "http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
    <display-name>Spring MVC Application</display-name>
    <!-- 配置 Spring MVC 的前端控制器 -->
    <servlet>
        <servlet-name>springmvc-dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/springmvc-config.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <!-- 将 Spring MVC 的前端控制器映射到 /，也就是拦截所有的请求 -->
    <servlet-mapping>
        <servlet-name>springmvc-dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

其中，servlet 的 name 为 springmvc-dispatcher，class 为 org.springframework.web.servlet.DispatcherServlet。init-param 参数指定了 Spring MVC 配置文件的路径（/WEB-INF/springmvc-config.xml）。

步骤四：配置 Spring MVC 配置文件

在 src/main/resources 下新建文件 springmvc-config.xml，写入以下内容：

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="
            http://www.springframework.org/schema/context
            http://www.springframework.org/schema/context/spring-context.xsd
            http://www.springframework.org/schema/mvc
            http://www.springframework.org/schema/mvc/spring-mvc.xsd
            http://www.springframework.org/schema/beans
            http://www.springframework.org/schema/beans/spring-beans.xsd">

    <!-- 开启注解扫描 -->
    <context:component-scan base-package="com.example.controller"/>

    <!-- 静态资源映射 -->
    <mvc:resources mapping="/static/**" location="/static/"/>

    <!-- 配置视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

</beans>

其中，component-scan 是指定 Spring MVC 按照注解来扫描需要跳转的 Controller 的位置，mvc:resources 是指定静态资源，suffix 是指定 JSP 的后缀名。

步骤五：编写 Controller

在 src/main/java 下新建包 com.example.controller，再新建 UserController 类，写入以下内容：

@Controller
public class UserController {

    @RequestMapping(value = "/users", method = RequestMethod.GET)
    public ModelAndView getUsers(){
        ModelAndView modelAndView = new ModelAndView("users");
        List<User> users = new ArrayList<>();
        User user1 = new User("1", "Alice");
        User user2 = new User("2", "Bob");
        User user3 = new User("3", "Charlie");
        users.add(user1);
        users.add(user2);
        users.add(user3);
        modelAndView.addObject("users", users);
        return modelAndView;
    }
}

这是一个简单的 Spring MVC Controller，其中，@Controller 表示这是一个 Controller 类，在类中使用 @RequestMapping 注解映射请求的 URL，请求的方法为 GET，方法名为 getUsers()。

步骤六：编写 JSP 页面

在 src/main/webapp/WEB-INF/views 下新建 users.jsp 页面，写入以下内容：

<!DOCTYPE html>
<html>
<head>
    <title>Users</title>
</head>
<body>
<table>
    <thead>
        <tr>
            <th>Id</th>
            <th>Name</th>
        </tr>
    </thead>
    <tbody>
        <c:forEach items="${users}" var="user">
            <tr>
                <td>${user.id}</td>
                <td>${user.name}</td>
            </tr>
        </c:forEach>
    </tbody>
</table>
</body>
</html>

这是一个简单的 JSP 页面，使用了 JSTL 标签库，<c:forEach> 用来循环显示用户信息。

步骤七：启动应用程序

将应用程序部署在 Tomcat 或者 Jetty 服务器中，然后启动应用程序。在浏览器中输入 http://localhost:8080/users，可以看到页面显示了三个用户：

Id  Name
1   Alice
2   Bob
3   Charlie

以上是使用 maven 一步一步构建 Spring MVC 项目的完整攻略，其中，步骤三、四、五、六需要更改的部分依据不同的开发需求有所不同，用户需要根据自己的实际情况进行修改。