由于IDEA并不直接提供创建Spring MVC项目的入口,因为仅仅使用Spring MVC并不能构成完整的项目,它只是一种MVC框架,所以为了学习MVC模式,我们需要手动创建项目

创建空项目

打开IDEA,选择新建项目,名称和位置自己设置,语言选择Java,构建系统选择Maven,JDK版本选择自己使用的即可

创建完成后的项目结构如下图所示

引入所需依赖

由于我们使用了maven来构建,所以可以很方便的导入我们所需要的jar包,在pom.xml文件中</project>之前插入如下代码即可

需要注意的是,这里使用的Spring Framework 6版本,需要使用JDK17和Jakarta 9以上的版本作为基线版本,并且Tomcat为10版本以上,如果使用低版本请自行修改version部分,并将jakarta.命名空间更改为javax.

<dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>6.0.9</version>
        </dependency>
        <dependency>
            <groupId>org.aspectj</groupId>
            <artifactId>aspectjweaver</artifactId>
            <version>1.9.19</version>
        </dependency>
        <dependency>
            <groupId>jakarta.annotation</groupId>
            <artifactId>jakarta.annotation-api</artifactId>
            <version>2.1.1</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-aspects</artifactId>
            <version>6.0.9</version>
        </dependency>
        <dependency>
            <groupId>jakarta.servlet</groupId>
            <artifactId>jakarta.servlet-api</artifactId>
            <version>6.0.0</version>
        </dependency>
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-annotations</artifactId>
            <version>2.15.2</version>
        </dependency>
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-core</artifactId>
            <version>2.15.2</version>
        </dependency>
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>2.15.2</version>
        </dependency>
</dependencies>

如果使用使用Tomcat 10以下和JDK 17以下版本,可以使用如下的配置文件

低版本配置文件

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.3.29</version>
    </dependency>
    <dependency>
        <groupId>org.aspectj</groupId>
        <artifactId>aspectjweaver</artifactId>
        <version>1.9.19</version>
    </dependency>
    <dependency>
        <groupId>javax.annotation</groupId>
        <artifactId>javax.annotation-api</artifactId>
        <version>1.3.2</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-aspects</artifactId>
        <version>5.3.29</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>4.0.1</version>
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-annotations</artifactId>
        <version>2.15.2</version>
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-core</artifactId>
        <version>2.15.2</version>
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.15.2</version>
    </dependency>
</dependencies>

添加代码后ide会提示加载maven项目变更,首次需要下载jar包,可能需要一定时间,下载完成后在外部库中会有以下jar包

配置tomcat服务

这里以tomcat为例,使用其他的服务也是可以的,配置过程相同

引入web模块

打开项目结构(快捷键:Ctrl+Shift+Alt+S),选择模块,添加一个web模块

添加后项目目录中会多出一个web文件夹

配置web.xml

在文件末尾</web-app>前添加如下代码

<servlet>
    <servlet-name>springMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:servlet.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>springMVC</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

这里的servlet.xml会报错,暂时先不管它

如果报错'org.springframework.web.servlet.DispatcherServlet' 未分配到 'javax.servlet.Servlet,jakarta.servlet.Servlet',那么就是版本的问题,使用JDK17+和Tomcat10+

添加tomcat

再次打开刚才的项目结构,找到左边的工件,添加一个Web应用程序:展开型,选择基于模块,点击确定

在顶部运行菜单中找到编辑配置,添加一个本地tomcat服务器(假设tomcat已经安装好,没有安装好可以参考其他教程)

在部署菜单添加我们刚刚创建的工件

底部的应用程序上下文可以自行修改(决定了访问时的路径)

配置Spring

刚刚提到有一个报错的servlet.xml,是Spring的配置文件,现在我们开始创建

在main文件夹下的resources文件夹右键,新建一个xml配置文件,选择spring配置,命名为servlet.xml,此时ide会弹出提示配置spring应用程序上下文,根据提示配置即可,如果没有弹出,打开项目结构,在模块中找到Spring,点击加号,勾选模块即可

编辑servlet.xml

打开文件,在</beans>前加入所需要的代码,即可完成配置

如果没有现成的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: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
       https://www.springframework.org/schema/context/spring-context.xsd
       http://www.springframework.org/schema/mvc
       http://www.springframework.org/schema/mvc/spring-mvc.xsd ">
    <context:component-scan base-package="test"/>
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

这里的包名为test,根据自己需要修改

注意事项

Tomcat控制台乱码

如果你的tomcat输出日志是乱码

可以尝试修改位于tomcat安装目录下路径为\conf\logging.properties的文件,文件中共有五个为UTF-8的编码,将红框框起来的三个改为GBK,重启tomcat服务即可

正常日志如下,红色并不一定是报错,可能仅仅是警告或者提醒