智慧燃气：智慧燃气推进设备全面感知及协同运营

前言

在我们的日常工作和学习中，Web 开发是一个无法回避的重要环节。而在 Java Web 开发领域，SpringMVC 无疑是一个重量级选手。它以其灵活性、强大功能和清晰的 MVC 结构，赢得了大量开发者的青睐。但是，对于初学者来说，SpringMVC 的学习曲线可能会比较陡峭。因此，我决定写这篇博客，希望通过一个简单的入门案例，帮助大家快速理解和掌握 SpringMVC。

在这篇博客中，我将会以一个简单的 "Hello, SpringMVC!" 为例，逐步引导大家了解 SpringMVC 的基本概念和使用方法。我们将从环境配置开始，然后逐步介绍如何定义 Controller、如何配置视图解析器、如何处理请求等基本操作。我将尽可能地解释每一步的原理和目的，希望能帮助大家更好地理解 SpringMVC。

无论你是刚接触 Web 开发，还是已经有一定经验的开发者，我都希望这篇博客能对你有所帮助。如果在阅读过程中有任何问题，欢迎在评论区留言，我会尽力回答。

那么，让我们开始吧！

一、开始学习

1、新建 Maven 项目，结构如下

2、导入依赖

    <dependencies>
    
        <!-- springmvc 依赖，会将spring的核心包一并添加进来 -->
        <!-- https://mvnrepository.com/artifact/org.springframework/spring-webmvc -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.3.23</version>
        </dependency>
     

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.30</version>
        </dependency>

        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>1.4.5</version>
        </dependency>



    </dependencies>

 这些 Maven 依赖项主要包括：

这些依赖项可以满足开发基于 Spring 的 Web 应用程序的需求，其中 lombok 和 logback-classic 是可选的，可以根据实际需求选择是否使用。

3、在 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:mvc="http://www.springframework.org/schema/mvc"
       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 http://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <!-- 启用注解扫描 -->
   <context:component-scan base-package="edu.nf.ch01"/>
    <!-- 启用 mvc 注解处理器
         这个注解驱动注册了 RequestMappingHandlerMapping （请求映射处理器）
         和一个 RequestMappingHandlerAdapter (请求处理适配器)，同时
         提供了 @RequestBody 、@ResponseBody注解支持，数据绑定等支持
    -->
    <mvc:annotation-driven/>
    <!-- 配置视图解析器，springmvc 支持多种试图，不同的视图由不同的
         视图解析器来解析，
         例如：想要使用 jsp 作为视图，那么就需要配置
         InternalResourceViewResolver 这个视图解析器，
         用于解析内部的 JSP 资源
         -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!-- 设置 jsp 资源的前缀，用于指定 JSP 存放的目录 -->
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <!-- 设置 jsp 资源的后缀名,以 “.jsp” 结尾 -->
        <property name="suffix" value=".jsp"/>
    </bean>

</beans>

这段 Spring 配置主要用于配置 Spring MVC 视图解析器。

这段 Spring 配置主要用于配置 Spring MVC 的视图解析器，它会将 JSP 文件的存放路径和后缀名配置成固定值，以便于在控制器中返回视图名称时可以直接使用逻辑视图名，而无需显式指定 JSP 文件的路径和后缀名。

注意：以后这个文件都写在 web-inf 里面和web.xml 放在一起。

4、完成配置 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_4_0.xsd"
         version="4.0">
    <!-- 核心请求总控制器，负责接受的所有的请求，并根据映射的 url
         地址将请求分发给具体控制器的方法来处理 -->
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- springmvc 默认会从 webapp-info 目录下查找名为
             [servletName]-servlet.xml的配置文件、这里是
             spring 官方默认的约定命名、如果想要自定义文件名并且想存放在其他目录下
             则需要通过 contextConfigLocation 初始化参数来配置
             例如自定义一个 springmvc.xml 配置文件放在 resources 目录下
        -->
                <init-param>
                    <param-name>contextConfigLocation</param-name>
                    <param-value>classpath:springmvc.xml</param-value>
                </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

</web-app>

这是一个 Java Web 应用程序的 web.xml 配置文件，其中主要配置了一个名为 dispatcher 的 Servlet，并将它映射到根路径 / 上。

具体来说，这个 web.xml 文件的作用如下：

这个 web.xml 文件是一个 Java Web 应用程序的核心配置文件，它定义了 Servlet、Servlet 映射和初始化参数等信息，使得应用程序能够正确地处理 HTTP 请求并返回响应。

5、在 controller 包下新建一个 HelloController 控制器

/**
 * @Date 2023-10-19
 * @Author qiu
 * 控制层使用 @controller 注解标识
 */
@Controller
@Slf4j
public class HelloController {

    @RequestMapping("/hello")
    public ModelAndView hello() {
        log.info("Hello word");
        // 响应视图,JSP 视图解析器都是基于转发的机制
        ModelAndView index = new ModelAndView("index");
        return index;
    }

}

这是一个使用 Spring MVC 编写的 Controller 类，它使用了 @Controller 注解将该类标记为 Spring MVC 的控制器，使用 @RequestMapping 注解将该方法映射到 /hello 路径上，当用户访问 /hello 路径时，该方法会被调用。

具体来说，这个 Controller 类的作用如下：

这个 Controller 类的作用是处理 /hello 路径的 HTTP 请求，将请求转发到 index.jsp 视图进行渲染，并在控制台输出一条日志。

我们具体来说一下 ModelAndView :

ModelAndView 是 Spring MVC 框架中的一个类，它用于封装控制器处理请求后需要返回的视图名称和模型数据。

具体来说，ModelAndView 类中包含了两部分信息：

在控制器中，通过创建 ModelAndView 对象并设置视图名称和模型数据，就可以将控制器处理请求后的结果返回给 Spring MVC 框架，然后由框架将其转发到对应的视图进行渲染。

 6、新建 index.jsp 页面

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
<h1>welcome to SpringMVC!</h1>
</body>
</html>

7、打包项目

 1）、配置 jetty 服务器

点击 ＋ artifact

 二、运行项目

 到这里我们的第一个入门案例“welcome to SpringMVC”就完成了。

三、使用 Springmvc 和使用 javaweb 的区别

Spring MVC 是一种基于 Spring 框架的 Web 应用程序开发框架，而 JavaWeb 是指使用 Java 技术开发 Web 应用程序的一种方式。它们之间的区别主要在以下几个方面：

Spring MVC 框架相对于传统的 JavaWeb 开发，提供了更加灵活、高效、可扩展的开发方式，并且具有更好的代码重用性和可维护性。

四、gitee 案例

案例地址：ch01 · qiuqiu/SpringMVC - 码云 - 开源中国 (gitee.com)