IDEA2023创建SpringMVC项目

✅作者简介：大家好，我是Leo，热爱Java后端开发者，一个想要与大家共同进步的男人😉😉
🍎个人主页：Leo的博客
💞当前专栏：开发环境篇
✨特色专栏： MySQL学习
🥭本文内容： IIDEA2023创建SpringMVC项目
📚个人知识库： Leo知识库，欢迎大家访问

1. 前言

大家好，我是Leo哥🫣🫣🫣，有朋友问我关于新版本的IDEA如何创建SpringMVC项目或者是SSM项目，并配置Web支持呢。这个问题在我刚升级新版本也是琢磨了很久，现在整理分享给大家。

2. 创建项目

我们这里以创建SpringMVC项目为例，SSM项目同理。不过我们以原生Maven的方式创建，当然也可以通过快捷的 Archetype org.apache.maven.archetypes:maven-archetype-webapp 进行创建，但是这不是我们今天的主题。不多废话，直接开始吧。

创建项目

3. 导入依赖

<dependencies><!-- Spring MVC依赖 --><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>6.1.4</version></dependency><!--日志框架Logback依赖--><dependency><groupId>ch.qos.logback</groupId><artifactId>logback-classic</artifactId><version>1.5.3</version></dependency><!--Servlet依赖--><dependency><groupId>jakarta.servlet</groupId><artifactId>jakarta.servlet-api</artifactId><version>6.0.0</version><scope>provided</scope></dependency><!--Spring6和Thymeleaf整合依赖--><dependency><groupId>org.thymeleaf</groupId><artifactId>thymeleaf-spring6</artifactId><version>3.1.2.RELEASE</version></dependency></dependencies>

4. 添加Web支持

首先需要先在main 目录下面创建一个文件夹，webapp。

然后打开Project Structure ，添加Web依赖，如果有的话可以胜率这一步。

然后点击Web，添加一个Deploymentt Descriptors

这里注意要和自己的路径保持一致，如果不一致按照我这个格式进行改！然后就是 Deployment 版本选择6即可。

然后点击apply，OK即可，看到xml说明我们配置成功了。

5. 其他配置

5. 1 配置Web.xml

Spring MVC是一个web框架，在javaweb中谁来负责接收请求，处理请求，以及响应呢？当然是Servlet。在SpringMVC框架中已经为我们写好了一个Servlet，它的名字叫做：DispatcherServlet，我们称其为前端控制器。既然是Servlet，那么它就需要在web.xml文件中进行配置：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_6_0.xsd"version="6.0"><!--配置前端控制器--><servlet><servlet-name>springmvc</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><!--手动设置springmvc配置文件的路径及名字--><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:springmvc.xml</param-value></init-param><!--为了提高用户的第一次访问效率，建议在web服务器启动时初始化前端控制器--><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>springmvc</servlet-name><url-pattern>/</url-pattern></servlet-mapping>
</web-app>

DispatcherServlet是SpringMVC框架为我们提供的最核心的类，它是整个SpringMVC框架的前端控制器，负责接收HTTP请求、将请求路由到处理程序、处理响应信息，最终将响应返回给客户端。DispatcherServlet是Web应用程序的主要入口点之一，它的职责包括：

接收客户端的HTTP请求： DispatcherServlet监听来自Web浏览器的HTTP请求，然后根据请求的URL将请求数据解析为Request对象。
处理请求的URL： DispatcherServlet将请求的URL（Uniform Resource Locator）与处理程序进行匹配，确定要调用哪个控制器（Controller）来处理此请求。
调用相应的控制器： DispatcherServlet将请求发送给找到的控制器处理，控制器将执行业务逻辑，然后返回一个模型对象（Model）。
渲染视图： DispatcherServlet将调用视图引擎，将模型对象呈现为用户可以查看的HTML页面。
返回响应给客户端： DispatcherServlet将为用户生成的响应发送回浏览器，响应可以包括表单、JSON、XML、HTML以及其它类型的数据

5.2 编写springmvc.xml

SpringMVC框架有它自己的配置文件，该配置文件的名字默认为：-servlet.xml，默认存放的位置是WEB-INF 目录下：

但是我们正常我们的配置文件都是放在resources文件夹下面的，所以我们这里需要做出一点改动。

手动配置我们的springmvc的路径。

<!--手动设置springmvc配置文件的路径及名字-->
<init-param><param-name>contextConfigLocation</param-name><param-value>classpath:springmvc.xml</param-value>
</init-param>

然后我们就可以直接在resources添加一个springmvc.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"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"><context:component-scan base-package="org.javatop.springmvc.controller"/><!--视图解析器--><bean id="thymeleafViewResolver" class="org.thymeleaf.spring6.view.ThymeleafViewResolver"><!--作用于视图渲染的过程中，可以设置视图渲染后输出时采用的编码字符集--><property name="characterEncoding" value="UTF-8"/><!--如果配置多个视图解析器，它来决定优先使用哪个视图解析器，它的值越小优先级越高--><property name="order" value="1"/><!--当 ThymeleafViewResolver 渲染模板时，会使用该模板引擎来解析、编译和渲染模板--><property name="templateEngine"><bean class="org.thymeleaf.spring6.SpringTemplateEngine"><!--用于指定 Thymeleaf 模板引擎使用的模板解析器。模板解析器负责根据模板位置、模板资源名称、文件编码等信息，加载模板并对其进行解析--><property name="templateResolver"><bean class="org.thymeleaf.spring6.templateresolver.SpringResourceTemplateResolver"><!--设置模板文件的位置（前缀）--><property name="prefix" value="/WEB-INF/templates/"/><!--设置模板文件后缀（后缀），Thymeleaf文件扩展名不一定是html，也可以是其他，例如txt，大部分都是html--><property name="suffix" value=".html"/><!--设置模板类型，例如：HTML,TEXT,JAVASCRIPT,CSS等--><property name="templateMode" value="HTML"/><!--用于模板文件在读取和解析过程中采用的编码字符集--><property name="characterEncoding" value="UTF-8"/></bean></property></bean></property></bean>
</beans>

以上配置主要两项：

第一项：组件扫描。spring扫描这个包中的类，将这个包中的类实例化并纳入IoC容器的管理。
第二项：视图解析器。视图解析器（View Resolver)的作用主要是将Controller方法返回的逻辑视图名称解析成实际的视图对象。视图解析器将解析出的视图对象返回给DispatcherServlet，并最终由DispatcherServlet将该视图对象转化为响应结果，呈现给用户。

注意：如果采用了其它视图，请配置对应的视图解析器，例如：

JSP的视图解析器：InternalResourceViewResolver
FreeMarker视图解析器：FreeMarkerViewResolver
Velocity视图解析器：VelocityViewResolver

5.3 提供视图

在WEB-INF目录下新建templates目录，在templates目录中新建html文件，例如：test.html，并提供以下代码：

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head><meta charset="UTF-8"><title>Test</title>
</head>
<body>
<H1>TEST OK!!! Hello SpringMVC</H1>
</body>
</html>

5.4 编写Controller

返回逻辑视图名称（决定跳转到哪个页面）

@Controller
public class HelloController {@RequestMapping("/test")public String test(){return "test";}
}

6. 配置Tomcat

第一步：配置Tomcat服务器

第二步：部署web模块到Tomcat服务器

注意：我们这里 /springmvc 就是我们的Web应用的根目录。

7. 测试

开浏览器，在浏览器地址栏上输入地址：http://localhost:8080/springmvc/haha

大功告成!!!

8. 执行流程总结

浏览器发送请求：http://localhost:8080/springmvc/test
SpringMVC的前端控制器DispatcherServlet接收到请求，
DispatcherServlet根据请求路径 /test 映射到 HelloController#名字随意()，调用该方法。
HelloController#名字随意() 处理请求。
HellController#名字随意() 返回逻辑视图名称 test给视图解析器.
视图解析器找到 /WEB-INF/templates/test.html 文件，并进行解析，生成视图解析对象返回给前端控制器DispatcherServlet。
前端控制器DispatcherServlet响应结果到浏览器。