手动创建Spring MVC应用并部署到Tomcat

SpringBoot让很多和我一样的小伙伴,不知道怎么使用SpringMVC,也不知道SpringBoot帮我们做了哪些事.

最近重新学习SpringMvc,遇到不少问题,下面记录使用IDEA搭建SpringMvc工程并部署到tomcat的过程.

PS:本文基于创建一个前后端分离的应用,不会涉及前端相关内容.

1. 创建一个空的maven项目

使用maven创建一个空的项目,会的可跳过,不会的最后有详细的图示过程:

1. IDEA new Project.
2. 左侧选择maven,中间除jdk外,不选择其他任何依赖;
3. 填写groupId/ArtifactId/version
4. 填写project name /projec location,然后点完成. 至此,一个空的maven项目创建完成.

2.添加Spring及SpringMVC相关依赖

在pom.xml文件中,添加spring和springmvc所需依赖:

spring-core、spring-context、spring-expression、spring-beans、commons-logging、spring-web、spring-webmvc.下文将会给出完整的pom配置文件.

3.创建web应用所需目录及web.xml文件

1. 在src目录下新建webapp目录,然后再webapp下新建WEB-INF目录.
2. 在WEB-INF下新建web.xml文件,并填写以下内容:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
                      http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
</web-app>

4. 创建SpringMVC所需配置文件

在src/main/resource目录下,创建context-spring.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:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd 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">

    <!--开启注解,注意看下是不是mvc这个明明空间下的-->
    <mvc:annotation-driven/>
    <!--扫描包:base-package填写你的根包名即可-->
    <!--如果扫描到有@Component、@Controller、@Service等这些注解类，则把这些类注册为bean-->
    <context:component-scan base-package="com.begank"/>
</beans>

5. 在web.xml文件中添加servlet相关配置

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
                      http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
    <!--监听器-->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:context-spring.xml</param-value>
    </context-param>

    <!--配置servlet相关信息-->
    <servlet>
        <servlet-name>helloServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:context-spring.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>helloServlet</servlet-name>
        <url-pattern>/*</url-pattern>
    </servlet-mapping>
</web-app>

6. 修改打包相关配置

1. 修改pom中的打包模式为war
2. 增加build标签,使用finalName标签定义打包的war名.
3. 基于tomcat的标准web应用目录结构,我们需要把WEB-INF包打包到war包中.

修改后,完整的pom.xml配置文件如下:

<?xml version="1.0" encoding="UTF-8"?>
<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>com.begank</groupId>
    <artifactId>revival</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>war</packaging>

    <dependencies>
        <!--Spring framework所需依赖-->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>5.0.4.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>5.0.4.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-expression</artifactId>
            <version>5.0.4.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-beans</artifactId>
            <version>5.0.4.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>commons-logging</groupId>
            <artifactId>commons-logging</artifactId>
            <version>1.2</version>
        </dependency>

        <!--以下为Spring MVC 依赖的jar包-->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
            <version>5.0.4.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.0.4.RELEASE</version>
        </dependency>
    </dependencies>

    <build>
        <!--打包成war包的文件名,也是请求的上下文路径-->
        <finalName>revival</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.2.2</version>
                <configuration>
                    <webResources>
                        <resource>
                            <directory>src/webapp/WEB-INF</directory>
                            <targetPath>/WEB-INF</targetPath>
                        </resource>
                    </webResources>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

至此,SpringMVC的工厂搭建完成,下面我们来写一个接口试试.

7.新建HelloController接口

这个比较简单,不再赘述.直接贴代码

package com.begank;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
/**
 * @Author : begank
 * @Date: 2021-06-02 21:28
 */
@RestController
public class HelloController {
    @GetMapping("/hello")
    public String hello(){
        return "hello Spring MVC";
    }
}

8.打包并部署到tomcat

1. 可选择使用idea先clean,后install.或者在pom.xml文件下,执行mvn clean install命令打包,打包完后在target目录下得到项目war包.
2. 将项目的war包放到tomcat的webapp目录下,重启tomcat,访问我们的接口:http://localhost:8080/revival/hello

至此,一个springmvc项目搭建完成.关于项目中Springmvc相关的配置,如:contextConfigLocation,后面再专门撰文讲述,这里只做实践流程说明;

附:项目搭建过程截图