> 文章列表 > SpringMVC基础解析

SpringMVC基础解析

SpringMVC基础解析

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

  @Controllerpublic 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/>