Spring MVC学习随笔-第一个Spring MVC程序（父子项目结构、Tomcat配置、ViewResolver）

合集 - Spring MVC(8)
1.Spring MVC学习随笔-Spring MVC介绍
2.Spring MVC学习随笔-第一个Spring MVC程序（父子项目结构、Tomcat配置、ViewResolver）
3.Spring MVC学习随笔-控制器(Controller)开发详解：接受客户端(Client)请求参数4.Spring MVC学习随笔-控制器(Controller)开发详解：调用业务对象、父子工厂拆分（applicationContext.xml、dispatcher.xml）5.Spring MVC学习随笔-控制器(Controller)开发详解：控制器跳转与作用域（一）6.Spring MVC学习随笔-控制器(Controller)开发详解：控制器跳转与作用域（二）视图模板、静态资源访问7.Spring MVC学习随笔-文件下载和上传（配置文件上传解析器multipartResolver）8.Spring MVC学习随笔-Ajax集成（JSON格式返回数据）、拦截器（MyInterceptor）、全局异常处理（GlobalExceptionResolver）
收起

学习视频：孙哥说SpringMVC：结合Thymeleaf，重塑你的MVC世界！｜前所未有的Web开发探索之旅

第二章、第一个SpringMVC程序的开发

2.1开发版本

  1. JDK1.8+
  2. Maven3.6+
  3. IDEA2021+
  4. SpringFramework 5.1.4
  5. Tomcat8.5.29
  6. MySQL5.7.18

按照父子项目的结构，管理和创建项目，创建一个空Project作为父项目，pom文件如下

<?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.baizhi</groupId>
    <artifactId>baizhi-mvc-parent</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>
    <modules>
        <module>baizhi-mvc-01</module>
    </modules>
 
    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
    </properties>
 
</project>

创建子项目Module：

子项目pom文件：

<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">
    <parent>
        <artifactId>baizhi-mvc-parent</artifactId>
        <groupId>com.baizhi</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
 
    <artifactId>baizhi-mvc-01</artifactId>
    <packaging>war</packaging>

注意:初次创建web项目时,WEB-INF包下的web.xml引入的servlet规范的版本还是2.3,而我们使用的tomcat8至少需要3.0以上的规范,所以需要修复,删除此文件后在Project Settings设置,如图:

Tomcat配置

2.2 环境搭建

2.2.1 引入相关jar

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.3.27</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.1.0</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>jstl</artifactId>
        <version>1.2</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet.jsp</groupId>
        <artifactId>javax.servlet.jsp-api</artifactId>
        <version>2.3.1</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>5.3.27</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>5.3.27</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-beans</artifactId>
        <version>5.3.27</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-test</artifactId>
        <version>5.3.27</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-tx</artifactId>
        <version>5.3.27</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-jdbc</artifactId>
        <version>5.3.27</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis-spring</artifactId>
        <version>2.1.1</version>
    </dependency>
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid</artifactId>
        <version>1.1.19</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.47</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.13</version>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.11</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>5.3.27</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-aop</artifactId>
        <version>5.3.27</version>
    </dependency>
    <dependency>
        <groupId>org.aspectj</groupId>
        <artifactId>aspectjrt</artifactId>
        <version>1.8.8</version>
    </dependency>
    <dependency>
        <groupId>org.aspectj</groupId>
        <artifactId>aspectjweaver</artifactId>
        <version>1.8.3</version>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-api</artifactId>
        <version>1.7.36</version>
    </dependency>
    <dependency>
        <groupId>ch.qos.logback</groupId>
        <artifactId>logback-classic</artifactId>
        <version>1.2.12</version>
    </dependency>
    <dependency>
        <groupId>ch.qos.logback</groupId>
        <artifactId>logback-core</artifactId>
        <version>1.2.12</version>
    </dependency>
    <dependency>
        <groupId>org.logback-extensions</groupId>
        <artifactId>logback-ext-spring</artifactId>
        <version>0.1.5</version>
    </dependency>
    <dependency>
        <groupId>org.yaml</groupId>
        <artifactId>snakeyaml</artifactId>
        <version>1.30</version>
    </dependency>
</dependencies>

注意：SpringMVC比前面所学习的Spring，就多引入了一个jar包，叫做spring-webmvc.jar

2.2.2 配置文件

SpringMVC的配置文件,就是Spring的配置文件

注意事项:

  1. 名字可以随便命名,本次课程取名dispatcher.xml
  2. 放置路径可以根据需要,随意放置,本次课程放置在资源文件夹的根下.

2.2.3 初始化配置

  • web.xml
<!--
 alt+insert快捷键引入Spring提供的dispatcherServlet-->
<servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <!-- 整个SpringMVC的核心-->
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!--指定SpringMVC配置文件的路径-->
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:dispatcher.xml</param-value>
    </init-param>
    <!--本Servlet会在tomcat启动时创建-->
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>
  1. DispatcherServlet称为前端控制器(中央控制器)
  2. DispatcherServlet的核心作用:

    1. 用于创建Spring的工厂(容器)

      等效于:ApplicationContext ctx = new ClassPathXmlApplicationContext(”dispatcher.xml”);
      因为DispatcherServlet封装的Spring工厂只能读取xml,所以无法迁移到纯注解编程

    2. 控制SpringMVC内部的运行流程

SpringMVC的配置文件dispatcher.xml

<!--设置注解扫描的路径-->
    <context:component-scan base-package="com.baizhi"/>
 
    <!--引入SpringMVC的核心功能-->
    <mvc:annotation-driven/>

mvc:annotaion-driven这段配置的主要作用:引入SpringMVC的核心功能

主要引入了2个核心类型:1.RequestMappingHandlerMapping 2.RequestMappingHandlerAdapter

  1. RequestMappingHandlerMapping实现了HandlerMapping接口

    它会处理@RequestMapping注解,并将其注册到请求映射表中

  2. RequestMappingHandlerAdapter实现了 HandlerAdapter接口

    它是处理请求的适配器,确定调用某个符合要求的控制器类中具体服务的方法

SpringMVC对mvc:annotaion-driven的封装

context:component-scan

  1. 进行注解扫描

  2. DispatcherServlet所创建的工厂需要读取XML的配置文件,不能使用纯注解的开发。所以目前使用Spring配置文件+基础注解的形式,进行开发

    基础注解可以用:@Component @Service @Repository,@Controller,@Scope,@Transsactional等

    高级注解无效：@Configuration,@Bean,@ComponentScan

2.3编程思路

2.3.1 思路分析

基本流程

  1. 开发一个类在上面加入@Controller注解
  2. 提供一个控制器方法：参数是HttpServletRequest，HttpServletResponse，返回值是String的，同时加入@RequestMapping注解定义请求路径
  3. 在控制方法中，完成核心开发功能，把对应JSP页面的路径，作为方法的返回值返回

2.3.2 编码

@Controller
public class FirstController {
 
    @RequestMapping("/first")
    public String first(HttpServletRequest request, HttpServletResponse response) {
        System.out.println("FirstController.first");
        return "/result.jsp";
    }
}
必须要进行@Controller注解的扫描，配置文件中：<context:component-scan base-package="com.baizhi"/>

2.3.3 一个控制器中，提供多个服务方法

  • Servlet作为控制器，一个类中只能提供一个服务方法

    在原来的Servlet开发中，明确控制器的方法必须实现接口规定的service(HttpServletRequest request, HttpServletResponse response)方法，一个类中只能实现一次，所以一个类中只能有一个服务方法

  • SpringMVC的控制器，一个类中可以提供多个对外服务的方法

    1. SpringMVC控制器，没有对于方法名的限制，所以可以提供多个服务方法
      		http://localhost:8989/basic/first
      		http://localhost:8989/basic/second
      		@Controller
      		public class FirstController {
      		 
      		    @RequestMapping("/first")
      		    public String first(HttpServletRequest request, HttpServletResponse response) {
      		        System.out.println("FirstController.first");
      		        return "/result.jsp";
      		    }
      		    @RequestMapping(value="/second")
      		    public String second(HttpServletRequest request, HttpServletResponse response) {
      		        System.out.println("FirstController.second");
      		        return "/result.jsp";
      		    }
      		}

2.3.4 注意

SpringMVC中我们开发的Controller，也称之为Handler（SpringMVC内部的叫法）

2.4 第一个程序的细节分析

2.4.1 一种类型的SpringMVC控制器被创建几次？

  1. 回顾：Servlet控制器被创建的次数

    一种类型的Servlet，只会被Tomcat创建一次，所以Servlet是单实例。

  2. Servlet是单实例并不是单例设计模式

  3. SpringMVC的控制器被Spring创建的次数

    控制器创建的次数，是由@Scope注解决定的，可以是一次也可以是多次

  4. 默认情况下SpringMVC的控制器只会被创建一次，会存在线程安全的问题

2.4.2@RequestMapping注解

核心作用：为控制器方法提供外部访问的url路径

http://localhost:8989/basic/first

@RequestMappring(”/first”)
public String first(HttpServletRequest request, HttpServletResponse response)

  • 路径分隔符 /可以省略

    		@RequestMapping(value="suns/second")
    		public String second(HttpServletRequest request, HttpServletResponse response) {
    		    System.out.println("FirstController.second");
    		    return "/result.jsp";
    		}
    		# 注意 多级目录开头可以不写/

  • 在一个控制器方法上映射多个路径

    		@Controller
    		public class FirstController {
    		    @RequestMapping(**value={"first","third"}**)
    		    public String first(HttpServletRequest request, HttpServletResponse response) {
    		        System.out.println("FirstController.first");
    		        return "/result.jsp";
    		    }
    		}

  • Controller类上加入@RequestMapping注解

    		http://localhost:8989/basic/user/first
    		http://localhost:8989/basic/user/second
    		@Controller
    		@RequestMapping("/user")
    		public class FirstController {
    		 
    		    @RequestMapping("/addUser")
    		    public String addUser(HttpServletRequest request, HttpServletResponse response) {
    		        System.out.println("FirstController.addUser");
    		        return "/result.jsp";
    		    }
    		    @RequestMapping(value="/deleteUser")
    		    public String deleteUser(HttpServletRequest request, HttpServletResponse response) {
    			        System.out.println("FirstController.deleteUser");
    		        return "/result.jsp";
    		    }
    		}

设计目的

满足单一职能原则，可以更好的按照功能，进行不同模块的区分，有利于项目的管理。

  • @RequestMapping限定用户的请求方式

    • 请求方式

      1. 所谓请求方式指的就是Web开发中的 POST请求与GET请求

        回顾：Web开发中的POST请求与GET请求的区别

      两种请求提交数据的区别

      1. GET请求：通过请求行（地址栏）提交数据（QueryString），明文数据提交，不安全，提交的数据量小（不超过2048字节）
      2. POST请求：通过请求体提交数据，密文提交（不是加密，指的是一般用户不可见），相对安全，提交数据量大（理论上没有限制）

两种请求发起方式的区别

  • RequestMapping如何限定用户的请求方式

    1. 默认情况下：@RequestMapping注解接受所有请求方式的访问（Post、Get、…

    2. 通过@RequestMapping的参数可以限定某个控制器方法只接受特定的请求方式

      @RequestMapping(value = "/m1",method = {RequestMethod.POST})

    3. 可以同时限定多种请求方式的访问

      @RequestMapping(value = "/m1",method = {RequestMethod.POST,RequestMethod.GET})

    4. 当用户发起了@RequestMapping不支持的请求操作

      SrpingMVC在服务器端抛出一个405错误 Method Not Allowed

  • Http协议中其他的请求方式【了解】

    1. 除常规的POST、GET请求外，Http协议还提供了其他的请求方式：PUT、DELETE、OPTIONS….
    2. @RequestMapping注解，默认情况也支持其他请求方式的访问，同时也可以根据需要进行限定
    3. 除POST、GET这2种请求方式外，其他的请求方式在浏览器支持的不好，所以可以使用专属工具(PostMan)或者库进行测试
    4. 其他的请求方式，大多数不支持响应视图技术（JSP，Thymeleaf），只能返回简单字符串或者JSON数据

2.4.3 控制器方法参数

SpringMVC在控制器方法参数设计的过程中，非常灵活，可以支持多种参数的设置方式，非常强大，它也把这种设计，叫做数据绑定。可以设置无参，也可以设置多个参数

  • 代码

    		 
    		@RequestMapping("first")
    		public String first(HttpServletRequest request, HttpServletResponse response)
    		 
    		@RequestMapping("first")
    		public String first(HttpServletRequest request)
    		 
    		@RequestMapping("first")
    		public String first(HttpServletResponse response)
    		 
    		@RequestMapping("first")
    		public String first(HttpServletRequest request, HttpServletResponse response, HttpSession session)
    		 
    		@RequestMapping("first")
    		public String first()
    		 
    		注意：HttpSession也可以单独使用 或者 组合使用
    					ServletContext(application) 不能应用在控制器方法中 做形参
    		获取方法：session.getServletContext();
    							request.getSession().getServletContext();

    思考：上述五种代码形式，在后续开发中最常用哪种？

    		    前四种不推荐的原因：与Servlet API存在耦合

    第五种不推荐的原因：无法接受client的请求参数

2.4.4 视图解析器（页面跳转）

  • 目前页面跳转存在的问题

    控制器中的跳转路径与实际视图路径存在耦合

  • 视图解析器ViewResolver

    通过视图解析器可以解决跳转路径的耦合

    视图解析器将前缀（路径）和后缀（文件类型）进行封装，跟返回的页面Name进行拼接，因此能访问，并解耦合

    		@Controller
    		@RequestMapping("/view")
    		public class ViewController {
    		    @RequestMapping("m1")
    		    public String m1(HttpSession session) {
    		        System.out.println("session = " + session);
    		        return "result";
    		    }
    		}

    配置文件：

    注解开发

    		@Configuration
    		public class AppConfig {
    		 
    		    @Bean
    		    public InternalResourceViewResolver viewResolver() {
    		        InternalResourceViewResolver viewResolver = new InternalResourceViewResolver();
    		        viewResolver.setPrefix("/");
    		        viewResolver.setSuffix(".jsp");
    		        return viewResolver;
    		    }
    		}
    		 
    		**注意：
    				1. AppConfig配置Bean应该放置到<context:component-scan/>扫描的路径下
    				2.结合前面所讲，目前因为DispatcherServlet封装的Spring工厂(容器)只能读取xml，所以无法进行纯注解替换。**

    2.4.5 SpringMVC配置文件的默认设置【了解】

下一章:Spring MVC学习随笔-控制器(Controller)开发详解：接受客户端(Client)请求参数

posted @   扬眉剑出鞘  阅读(108)  评论(0)  编辑  收藏  举报
相关博文：
· Spring MVC学习随笔-Spring MVC介绍
· Spring MVC学习随笔-控制器(Controller)开发详解：调用业务对象、父子工厂拆分（applicationContext.xml、dispatcher.xml）
· 【狂神说】SpringMVC笔记
· SpringMVC的原理及第一个程序
· SpringMVC
阅读排行：
· 开源Multi-agent AI智能体框架aevatar.ai，欢迎大家贡献代码
· Manus重磅发布：全球首款通用AI代理技术深度解析与实战指南
· 被坑几百块钱后，我竟然真的恢复了删除的微信聊天记录！
· 没有Manus邀请码？试试免邀请码的MGX或者开源的OpenManus吧
· 园子的第一款AI主题卫衣上架——"HELLO! HOW CAN I ASSIST YOU TODAY
点击右上角即可分享
微信分享提示