SpringMVC基础解析

最新推荐文章于 2024-11-04 11:27:22 发布

瑟瑟发抖的萌新学徒

最新推荐文章于 2024-11-04 11:27:22 发布

阅读量711

点赞数

文章标签： spring java mybatis

本文链接：https://blog.csdn.net/m0_56420338/article/details/130115593

版权

文章介绍了SpringMVC的概述、优点，详细步骤演示了一个基本的SpringMVC项目搭建，包括创建Maven工程、配置pom.xml、web.xml，以及编写Controller和配置SpringMVC.xml。还讲解了@RequestMapping注解的用途、路径占位符、请求参数的获取方法，并提到了处理中文乱码的过滤器和视图技术。

摘要由CSDN通过智能技术生成

1.SpringMVC概念

是Spring的一个产品，是Spring的一个子项目，是为表述层开发提供了一套完备的解决方案

2.SpringMVC的优点

   1.spring家族的原生产品，与IOC容器等基础设施无缝对接
    2.基于原生的Servlet，通过了功能强大的前端控制器DispatcherServlet，对请求和响应进行同一的处理
    3.表述层各细节分领域需要解决的问题全方位覆盖，提供全面解决方案
    4.代码简洁，大幅度的提高开发效率
    5.内部组件化程度高，可插拔式组件即插即用，想使用什么功能配置相应组件即可
    6.性能卓越，适合大型项目的开发

第一个SpringMVC项目搭建

1.创建MAVEN工程
2.添加web模块
3.配置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.dltt</groupId>
    <artifactId>springMVC_01_HelloWorld</artifactId>
    <version>1.0-SNAPSHOT</version>
    <!--打包方式war-->
    <packaging>war</packaging>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <!--引入依赖-->
    <dependencies>

        <!-- https://mvnrepository.com/artifact/org.springframework/spring-webmvc -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.3.24</version>
        </dependency>


        <!--日志-->
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>1.2.9</version>
            <scope>test</scope>
        </dependency>
        <!--ServletAPI-->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <scope>provided</scope>
        </dependency>
        <!--spring5和Thymeleaf的整合包-->
        <dependency>
            <groupId>org.thymeleaf</groupId>
            <artifactId>thymeleaf-spring5</artifactId>
            <version>3.0.13.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.24</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>
</project>

3.配置web.xml文件

  <servlet>
        <servlet-name>springMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!--   通过初始化参数指定springMVC配置文件的位置和名称-->
        <init-param>
            <!--            contextConfigLocation固定值-->
            <param-name>contextConfigLocation</param-name>
            <!--            classpath:表示类路径查找配置文件：例如项目中src/mian/resoures-->
            <param-value>classpath:springMVC.xml</param-value>
        </init-param>
        <!--        作为框架的核心组件，在启动时有大量的初始化操作需要进行，如果在访问时才加载，会严重影响访问速度
        隐藏需要将该组件在容器启动时加载-->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>springMVC</servlet-name>
        <!--
          设置springMVC核心控制器所能处理的请求的请求路径
          /所匹配的请求可以是/login、.html、.js、.css方式的请求路径
          但是/不能匹配.jsp请求路径的请求

          当配置/*时就可以匹配所有的请求
       -->
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

4.创建请求控制器Controller

  @Controller
        public class HelloController {
            
        }

5.创建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"
       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">
    <context:component-scan base-package="com.dltt.controller"/>
    <!--    配置Thymeleaf视图解析器-->
    <bean id="veiwResoler" class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
        <property name="order" value="1"/>
        <property name="characterEncoding" value="UTF-8"/>
        <property name="templateEngine">
            <bean class="org.thymeleaf.spring5.SpringTemplateEngine">
                <property name="templateResolver">
                    <bean class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver">
                        <!--                    视图前缀-->
                        <property name="prefix" value="/WEB-INF/templates/"/>
                        <!--                        视图后缀-->
                        <property name="suffix" value=".html"/>
                        <property name="templateMode" value="HTML5"/>
                        <property name="characterEncoding" value="UTF-8"/>
                    </bean>

                </property>
            </bean>
        </property>
    </bean>
    <!--    处理静态资源，例如html。css。jpg
    若只设置改标签，则只能访问静态资源，其他请求则无法访问
    此时必须设置<mvc:annotation-driven/>解决问题-->
    <mvc:default-servlet-handler/>
    <!--    开启注解驱动-->
    <mvc:annotation-driven>
        <!--        文字转换-->
        <mvc:message-converters>
            <!--            处理相应中文乱码问题-->
            <bean class="org.springframework.http.converter.StringHttpMessageConverter">
                <property name="defaultCharset" value="UTF-8"/>
                <property name="supportedMediaTypes">
                    <list>
                        <value>text/html</value>
                        <value>application/json</value>
                    </list>
                </property>
            </bean>
        </mvc:message-converters>
    </mvc:annotation-driven>
</beans>

6.编写控制器首页方法

  @RequestMapping("/")
        public String index(){
            return "index";
        }

7.创建页面视图

        <!DOCTYPE html>
        <html lang="en" xmlns:th="http://www.thymeleaf.org">
        <head>
            <meta charset="UTF-8">
            <title>Title</title>
        </head>
        <body>
            <h1>首页</h1>
            <a th:href="@{/hello}">HelloWorld</a>
        </body>
        </html>

8.在请求控制器创建处理方法

      @RequestMapping("/hello")
        public String hello(){
            return "hello";
        }

总结：

浏览器发送请求，若请求地址符合前端控制器的url-pattern，该请求就会被前端控制器DispatcherServlet处理。

前端控制器会读取SpringMVC的核心配置文件，通过扫描组件找到控制器，将请求地址和控制器中@RequestMapping注解的value属性值进行匹配，若匹配成功，该注解所标识的控制器方法就是处理请求的方法。

处理请求的方法需要返回一个字符串类型的视图名称，该视图名称会被视图解析器解析，加上前缀和后缀组成视图的路径，通过Thymeleaf对视图进行渲染，最终转发到视图所对应页面

@RequestMapping的功能

@RequestMapping注解的作用就是将请求和处理请求的控制器方法关联起来，建立映射关系
SpringMVC接收到指定的请求，就会来找到在映射关系中对应的控制器方法来处理这个请求

@RequestMapping的使用位置

1.标识一个类：设置映射请求的请求路径初始信息
2.标识一个方法：设置映射请求的请求路径的具体信息

@RequestMapping的value属性

1.作用：通过请求的请求地址匹配请求映射
2.是一个字符串类型的数组，表示该请求映射能够匹配对各请求地址对应的请求
3.@RequestMapping的value属性必须设置，至少通过请求地址匹配请求映射

@RequestMapping的method属性

1.设置通过请求的请求方式(get或post)
2.method属性是一个RequestMethod类型的数组，表示该请求映射能够匹配多种请求方式的请求
3.若当前请求的请求地址满足请求映射的value属性，但不满足于method属性，浏览器将会报错405

SpringMVC支持路径中的占位符

原始方式：/deleteUser?id=1
    rest方式：/deleteUser/1
    SpringMVC路径中的占位符常用于Restful风格中，当请求路径中将某些数据通过路径的方式传输到
    服务器中，就可以在相应的@RequestMapping注解的value属性中通过占位符{xxx}表示传输的数据
    再通过@PathVariable注解，将占位符所表示的数据赋值给控制器方法的形参

    @RequestMapping("/testRest/{id}/{username}")
    public  String testRest(@PathVariable("id") int id,@PathVariable("username")String username){
        System.out.println("id"+id+"   username"+username);
        return "success";
    }

springMVC如何获取请求参数

可以将HttpServletRequest作为控制器方法的形参，此时该参数就封装了当前请求中的报文中的对象

   @RequestMapping("/")
        public  String index(HttpServletRequest request){
            HttpSession session=request.getSession(true);
//    设置视图名称
            return  "index";
        }

SpringMVC通过控制器方法的形参获取请求参数

在控制器方法中设置形参，将形参名称与请求参数名称设为同名，当浏览器发送请求，匹配的相应的请求映射时
在DispatcherServlet中就会将请求参数赋给相应的形参

注意：如果请求所传的请求参数中有多个同名的请求参数，此时可以在控制器方法的形参中设置字符串数组，
        或字符串类型的形参接受此请求参数
        如果使用的字符串数组类型的参数，此参数的数组中包含了每一个请求参数数据
        如果使用的字符串类型的参数，此参数的值为每个数据中间使用逗号拼接的结果

@RequestParam

是将请求参数和控制器方法的形参创建映射关系
    三个属性
        1.value:指定为形参赋值的请求参数的参数名
        2.required：设置是否必须传递此请求参数，默认值true
            true时：则当前请求必须传递value所指定的请求参数，若没有传递，且没有设置defaultValue属性
                    则页面报错400 Required String paramter 'xxx' is not present;
                    若设置为false，则当前请求不是必须传递value所指定的请求参数，若没有传递，则注解
                    所标识的形参值就为null
        3.defaultValue：不管required属性为true还是false，当value所指定的请求参数没有传递或
        传递的值为""时，则使用默认值为形参赋值

    @RequestMapping("/testRequestParam")
    public  String testRequestParam(@RequestParam(value="uname",required = true,defaultValue = "张三")String username
            ,@RequestParam(value="pwd") String password
   , @CookieValue(value = "JSESSIONID",defaultValue = "123") String JSESSIONID){
        System.out.println("uname:"+username+
                "  pwd:"+password);
        System.out.println(JSESSIONID);
        return "success";
    }

@CookieValue

将cookie数据和控制器方法的形参创建映射关系
三个属性：1.value 2.required 3.defaultValue用法与@RequestParam一致

@CookieValue(value = "JSESSIONID",defaultValue = "123")

通过vo获取请求参数

可以在控制器方法的形参位置设置一个实体类类型的形参，此时若浏览器传输的请求参数的参数名和实体类
中的属性名一致，那么请求参数就会为此属性赋值

SpringMVC中文乱码过滤器

使用SpringMVC提供的编码过滤器CharacterEncodingFilter，需要在web.xml文件中配置
web.xml配置

 <!--配置springMVC的编码过滤器-->
        <filter>
            <filter-name>CharacterEncodingFilter</filter-name>
            <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
            <!--配置初始化参数-->
            <!--1.编码格式(默认设置请求)-->
            <init-param>
                <param-name>encoding</param-name>
                <param-value>UTF-8</param-value>
            </init-param>
            <!--2.设置是否设置响应编码-->
            <init-param>
                <param-name>forceResponseEncoding</param-name>
                <param-value>true</param-value>
            </init-param>
        </filter>
        <filter-mapping>
            <filter-name>CharacterEncodingFilter</filter-name>
            <url-pattern>/*</url-pattern>
        </filter-mapping>

域对象共享数据

1.使用ServletAPI向request域对象共享数据
request.setAttribute("name",value)

  @RequestMapping("/testServletAPI")
        public String testServletAPI(HttpServletRequest request){
            request.setAttribute("msg","测试ServletAPI向请求传递数据");
            return "success";
        }

2.使用ModelAndView向request域对象共享数据

ModelAndView 包含了Model和View的功能
* Model主要是用于向请求域共享数据
* View主要是用于设置视图，实现页面跳转

 @RequestMapping("/testModelAndView")
    public ModelAndView testModelAndView(){
       
        ModelAndView mav = new ModelAndView();
        //new ModelAndView(String viewName)通过构造方法设置视图

        //向请求域共享数据 addObject("name",value)
        mav.addObject("testScope","hello,ModelAndView");
        //设置视图
        mav.setViewName("success");
        return mav;
    }

3.使用Model向request域对象共享数据

    @RequestMapping("/testModel")
    public String testModel(Model model){
        //addAttribute("name",value)
        model.addAttribute("testScope","hello,Model");
        return "success";
    }

4.使用map向request域对象共享数据

    @RequestMapping("/testMap")
    public String testMap(Map<String,Object> map){
        map.put("testScope","hello,Map");
        return "success";
    }

5.使用ModelMap向request域对象共享数据

    @RequestMapping("/testModelMap")
    public String testModelMap(ModelMap modelMap){
        modelMap.addAttribute("testScope","hello,Model Map");
        return "success";
    }

6.Model,Map,ModelMap的关系

    1.Model是操作数据模型最顶层的接口
    2.Map就是JDK中的Map
    3.ModelMap继承了LinkedHashMap
    4.LinkedHashMap又实现了Map接口
    5.所以ModelMap是Map接口的实现类
    6.LinkedHashMap有一个子类ExtendedModelMap
    7.ExtendedModelMap继承了ModelMap实现了Model

Model使用的是addAttribute(),Map使用的是put()方法，ModelMap使用的是addAttribute()

7.向session域共享数据

     @RequestMapping("/testSession")
        public String testSession(HttpSession session){
            session.setAttribute("testSessionScope","hello，session");
            return "success";
        }

8.向application域共享数据

        @RequestMapping("/testApplication")
        public String testApplication(HttpSession session){
            ServletContext application = session.getServletContext();
            application.setAttribute("testApplicationScope","hello,application");
            return "success";
        }

SpringMVC的视图

View是一个接口，作用渲染数据，将模型Model中的数据展示给用户
    种类很多，默认种类有转发视图和重定向视图
    当引入jstl的依赖，转发视图会自动转换为JstlView
    如果使用的视图技术为Thymeleaf，在SrpingMVC的配置文件中配置了Thymeleaf的视图解析器，由
    此视图解析器解析之后所得到的是ThymeleafView


<mvc:annotation-driven/>

    <context:component-scan base-package="com.dltt.controller"/>
    <!--    配置Thymeleaf视图解析器-->
    <bean id="veiwResoler" class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
        <property name="order" value="1"/>
        <property name="characterEncoding" value="UTF-8"/>
        <property name="templateEngine">
            <bean class="org.thymeleaf.spring5.SpringTemplateEngine">
                <property name="templateResolver">
                    <bean class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver">
                        <!--                    视图前缀-->
                        <property name="prefix" value="/WEB-INF/templates/"/>
                        <!--                        视图后缀-->
                        <property name="suffix" value=".html"/>
                        <property name="templateMode" value="HTML5"/>
                        <property name="characterEncoding" value="UTF-8"/>
                    </bean>

                </property>
            </bean>
        </property>
    </bean>

1.ThymeleafView

如果控制器方法返回的视图名称没有任何前缀(例如：forward:)时，此时视图名称会被SpringMVC
配置文件中的所配置的视图解析器解析，视图名称拼接前缀后缀所得到的最终路径，会通过转发的方式

实现跳转

2.转发视图

SpringMVC中默认的转发视图是InternalResourceView
        当控制器方法所设置的视图名称以"forward:"为前缀时，创建InternalResourceView视图，
        此时的视图名称不会被SpringMVC配置文件中所配置的视图解析器解析，而是会将前缀"forward:"去掉，
        剩余部分作为最终路径通过转发的方式实现跳转

    @RequestMapping("/testForward")
    public String testForward(){

        return "forward:/testThymeleafView";
    }

3.重定向视图

   SpringMVC中默认的重定向视图是RedirectView
        当控制器方法所设置的视图名称以"redirect:"为前缀时，创建RedirectView视图，
        此时的视图名称不会被SpringMVC配置文件中所配置的视图解析器解析，而是会将前缀"redirect:"去掉，
        剩余部分作为最终路径通过重定向的方式实现跳转

   @RequestMapping("/testRedirect")
    public String testRedirect(){return "redirect:/testThymeleafView";}
}

视图控制器view-controller

当控制器方法中，仅仅用来实现页面跳转，即只需要设置视图名称时，可以将处理器方法使用view-Controller
标签来进行表示

        注意：当SpringMVC中设置任何一个view-controller时，其他控制器的请求映射将全部失效，此时需要
        在SpringMVC的核心配置文件中开启mvc注解驱动的标签
        <mvc:annotation-drivern/>

<!--   view-controller
path：设置处理的请求地址
view-name：设置请求地址所对应的视图名称-->
   <mvc:view-controller path="testViewController" view-name="success"/>
  <mvc:annotation-drivern/>