超详细使用Maven 搭建 Spring MVC 本地部署Tom

2017-07-21 本文已影响538人强出头

在很多其它教程中关于Spring的介绍已经很多了，在这里就不赘述了。关于SpringMVC的启动流程图网络上也很多，我就现在使用IntelliJ IDEA创建Maven来搭建一个Spring MVC的环境来实现HelloWorld。

在接下来的步骤中我会按照Spring MVC的启动流程来搭建环境，废话不多说，开始搭建。
关于Maven的使用是比较简单的，其实和手动创建Maven一样，可以用IntelliJ IDEA导入手动创建的Maven目录，我这里就默认使用IntelliJ IDEA来直接创建Maven。

1、创建Maven

创建Maven项目

然后是填写项目名称

项目名称

然后下一步、下一步、完成就可以了。

2、Maven目录介绍与pom.xml的设置

Maven的Web项目的目录和页面

这个时候我们看到的只是Maven的Web项目的目录和页面，并没有Spring MVC的东西。接下来我们要做的就是来到pom.xml,编写pom.xml导入Spring MVC所使用的包。注意，我们这里没有选择使用框架支持来导入Spring MVC的包，因为使用Maven来导入更能方便管理包的使用，这也是使用Maven的一个重要原因。同时我们也能清楚Spring MVC包的依赖。

下面是我的pom.xml文件，里面注释了有哪些引用包，可以根据自己的需求更改Spring MVC的版本。

<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/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>springmvc</groupId>
  <artifactId>springmvc</artifactId>
  <packaging>war</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>springmvc Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>

    <!-- Web Dependencies -->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>${servlet.version}</version>
    </dependency>

    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>${jsp.version}</version>
    </dependency>

    <dependency>
      <groupId>org.apache.taglibs</groupId>
      <artifactId>taglibs-standard-compat</artifactId>
      <version>${jstl.version}</version>
    </dependency>

    <dependency>
      <groupId>org.apache.taglibs</groupId>
      <artifactId>taglibs-standard-impl</artifactId>
      <version>${jstl.version}</version>
    </dependency>

    <dependency>
      <groupId>org.apache.taglibs</groupId>
      <artifactId>taglibs-standard-jstlel</artifactId>
      <version>${jstl.version}</version>
    </dependency>

    <dependency>
      <groupId>org.apache.taglibs</groupId>
      <artifactId>taglibs-standard-spec</artifactId>
      <version>${jstl.version}</version>
    </dependency>

    <!-- spring start -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aop</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aspects</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-beans</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context-support</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-core</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-expression</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-jdbc</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-orm</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-test</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-tx</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>${spring.version}</version>
    </dependency>

    <!-- spring end -->
  </dependencies>
  <!--版本信息-->
  <properties>
    <spring.version>4.3.9.RELEASE</spring.version>
    <!-- <mysql-connector-java.version>5.1.34</mysql-connector-java.version> -->

    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.compile.version>1.8</project.compile.version>

    <servlet.version>3.1.0</servlet.version>
    <jsp.version>2.2</jsp.version>
    <jstl.version>1.2.5</jstl.version>

  </properties>

  <build>
    <finalName>springmvc</finalName>
  </build>
</project>

其中是一个Tomcat里面的一个包，需要依赖的，里面是Spring MVC所需要的包，版本信息主要是整体控制Spring MVC依赖包的版本。

3、Spring MVC目录的设置

首先要将我们配置的pom.xml文件里面的包导入

使用Maven添加包

使用右上角的Maven控件下载并添加pom.xml里面我们所依赖的库，下载并添加完后我们会在外部库里面看到左下角那些库。

Spring MVC目录结构

1.添加的有一个java目录并标记为Sources Root(就是蓝色)
2.建包com.test.out,然后在里面建一个类HelloWorldController
3.接下来是WEB-INF里面的建立spring-config.xml和spring-servlet.xml。
4.最后在webapp文件夹中建立success.jsp。

注意：我们只添加这几个，其它的不管。

4、web.xml和spring-servlet.xml配置

首先注意的是我们在这里可以不用配置spring-config.xml，严格意义上这spring-servlet.xml能实现spring-config.xml的所有配置，但是我们通常不那么做，毕竟我们使用框架就是为了使开发更便捷，spring-config.xml是配置一些类似Spring MVC的拦截器之类的东西的。spring-servlet.xml更多的是一个中央处理器。

我们先配置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>Archetype Created Web Application</display-name>
  <!-- 配置spring-servlet  开始  -->
  <servlet>
    <servlet-name>spring</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 配置spring-servlet的一个初始化参数：配置spring-mvc配置文件的位置和参数-->

    <!--
          实际上也可以不通过contextConfigLocation来配置springmvc的配置文件
          默认的配置文件为:/WEB-INF/<servlet-name>-servlet.xml
     -->
    <!--<init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>/WEB-INF/spring-servlet.xml</param-value>
    </init-param>-->

    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>spring</servlet-name>
    <!--  所有请求  -->
    <url-pattern>/</url-pattern>

  </servlet-mapping>

</web-app>

主要是配置servlet，其中主要配置spring-servlet.xml文件的位置和参数，其中提供了两种方法，注释掉的方法主要是通过路径来配置。而没有注释掉的则是Spring框架自带的识别<servlet-name>-servlet.xml文件，只有在<servlet-name>spring</servlet-name>与<servlet-name>-servlet.xml文件中的<servlet-name>相同才会识别。好，到此web.xml就配置完成了。

我们来看看spring-servlet.xml的配置，下面是spring-servlet.xml的代码。

<?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"
       xmlns:util="http://www.springframework.org/schema/util"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="
        http://www.springframework.org/schema/util
        http://www.springframework.org/schema/util/spring-util-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" >

    <!--  配置自动扫描的包-->

    <context:component-scan base-package="com.test.out"></context:component-scan>

    <!-- 配置视图解析器：如何把handler 方法返回值解析为实际的物理视图 -->
    <bean id="defaultViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver" p:order="3">
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
        <property name="contentType" value="text/html"/>
        <property name="prefix" value="/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

spring-servlet.xml的就只是两个，和。自动扫描包是使我们的包内的类控制器能被识别，在我们的HelloWorldController加上@Controller注解后会被识别（后面会看到）。配置视图解析器是对我们目录中inde.jsp的识别，是物理视图能够识别。

5、配置类HelloWorldController

下面是类HelloWorldController的代码。

package com.test.out;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * Created by Martin.Wang on 2017/7/21.
 */
@Controller
public class HelloWorldController {

    /*
    * 1、@RequestMapping除了可以修饰方法还可以修饰类
    * 2、类定义处相对于根目录，方法定义处相对于类
    * */
    @RequestMapping("/helloWorld")
    public String helloWorld(){
        System.out.println("helloWorld");
        return "success";
    }


}

HelloWorldController类中的@Controller是为了注册类控制器的，@RequestMapping("/helloWorld")通俗点说就是注册方法地址，helloWorld就是我们访问时候根目录下的地址。return "success";是直指向success.jsp。在spring-servlet.xml中的配置视图解析器中就配置了<property name="suffix" value=".jsp"/>，即识别.jsp的文件。访问地址，根目录 + /helloWorld 就可以触发helloWorld方法，并返回success.jsp页面。

注意：Spring MVC访问根目录默认访问的是index.jsp文件，要改变需要在web.xml中配置，这里我们就默认使用Spring MVC 的index.jsp。

6、index.jsp和success.jsp

下面是index.jsp的代码。

<html>
<head>
    <title>Hello World!</title>
</head>
<body>
<a href="/helloWorld">Hello World!</a>
</body>
</html>

下面是success.jsp的代码。

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>success</title>
</head>
<body>
<h1>success</h1>
</body>
</html>

这个没有什么太多可以说的，主要就是<a href="/helloWorld">Hello World!</a>这一句中href="/helloWorld"的设置，就是对应了之前@RequestMapping("/helloWorld")。