springmvc组件配置简介与使用

    科技2025-07-17  12

    SpringMVC的执行流程

    ①用户发送请求至前端控制器DispatcherServlet。 ②DispatcherServlet收到请求调用HandlerMapping处理器映射器。 ③处理器映射器找到具体的处理器(可以根据xml配置、注解进行查找),生成处理器对象及处理器拦截器(如果有则生成)一并返回给DispatcherServlet。 ④DispatcherServlet调用HandlerAdapter处理器适配器。 ⑤HandlerAdapter经过适配调用具体的处理器(Controller,也叫后端控制器)。 ⑥Controller执行完成返回ModelAndView。 ⑦HandlerAdapter将controller执行结果ModelAndView返回给DispatcherServlet。 ⑧DispatcherServlet将ModelAndView传给ViewReslover视图解析器。 ⑨ViewReslover解析后返回具体View。 ⑩DispatcherServlet根据View进行渲染视图(即将模型数据填充至视图中)。DispatcherServlet响应用户。

    SpringMVC组件解析

    前端控制器:DispatcherServlet ​ 用户请求到达前端控制器,它就相当于 MVC 模式中的 C,DispatcherServlet 是整个流程控制的中心,由它调用其它组件处理用户的请求,DispatcherServlet 的存在降低了组件之间的耦合性。

    处理器映射器:HandlerMapping ​ HandlerMapping 负责根据用户请求找到 Handler 即处理器,SpringMVC 提供了不同的映射器实现不同的映射方式,例如:配置文件方式,实现接口方式,注解方式等。

    处理器适配器:HandlerAdapter

    ​ 通过 HandlerAdapter 对处理器进行执行,这是适配器模式的应用,通过扩展适配器可以对更多类型的处理器进行执行。

    处理器:Handler ​ 它就是我们开发中要编写的具体业务控制器。由 DispatcherServlet 把用户请求转发到 Handler。由Handler 对具体的用户请求进行处理。

    视图解析器:View Resolver ​ View Resolver 负责将处理结果生成 View 视图,View Resolver 首先根据逻辑视图名解析成物理视图名,即具体的页面地址,再生成 View 视图对象,最后对 View 进行渲染将处理结果通过页面展示给用户。

    视图:View ​ SpringMVC 框架提供了很多的 View 视图类型的支持,包括:jstlView、freemarkerView、pdfView等。最常用的视图就是 jsp。一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户,需要由程序员根据业务需求开发具体的页面

    SpringMVC注解解析

    @RequestMapping 作用:用于建立请求 URL 和处理请求方法之间的对应关系 位置: ​ 类上,请求URL 的第一级访问目录。此处不写的话,就相当于应用的根目录 ​ 方法上,请求 URL 的第二级访问目录,与类上的使用@ReqquestMapping标注的一级目录一起组成访问虚拟路径

    属性: ​ value:用于指定请求的URL。它和path属性的作用是一样的 ​ method:用于指定请求的方式 ​ params:用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的key和value必须和配置的一模一样

    例如: ​ params = {“accountName”},表示请求参数必须有accountName ​ params = {“moeny!100”},表示请求参数中money不能是100

    3.4 SpringMVC的XML配置解析

    mvc命名空间引入 命名空间:xmlns:context="http://www.springframework.org/schema/context" xmlns:mvc="http://www.springframework.org/schema/mvc" 约束地址: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 组件扫描

    SpringMVC基于Spring容器,所以在进行SpringMVC操作时,需要将Controller存储到Spring容器中,如果使用@Controller注解标注的话,就需要使用<context:component-scan base-package=“com.yh.controller"/>进行组件扫描。 SpringMVC有默认组件配置,默认组件都是DispatcherServlet.properties配置文件中配置的,该配置文件地址org/springframework/web/servlet/DispatcherServlet.properties,该文件中配置了默认的视图解析器,如下:

    org.springframework.web.servlet.ViewResolver=org.springframework.web.servlet.view.InternalResourceViewResolver

    翻看该解析器源码,可以看到该解析器的默认设置,如下:

    REDIRECT_URL_PREFIX = "redirect:" --重定向前缀 FORWARD_URL_PREFIX = "forward:" --转发前缀(默认值) prefix = ""; --视图名称前缀 suffix = ""; --视图名称后缀 视图解析器 我们可以通过属性注入的方式修改视图的的前后缀 <!--配置内部资源视图解析器--> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/views/"></property> <property name="suffix" value=".jsp"></property> </bean>

    SpringMVC的数据响应

    数据响应方式

    1) 页面跳转 ①直接返回字符串 ②通过ModelAndView(HttpServletRequest)对象返回

    2) 回写数据 ①直接返回字符串 ②返回对象或集合

    页面跳转-返回字符串形式

    第一种形式: 这种方式进行页面跳转一般与HttpServletRequest对象一起使用,在参数列表中声明,将数据存储至作用域中进行传递

    第二种形式:

    @RequestMapping(value="/quick4") public String save4(Model model){ model.addAttribute("username","二狗子"); return "success"; }

    这种方式同样会进行页面跳转,但是数据传递使用model对象,model对象的使用方式与HttpServletRequest类似,可以在jsp中使用el表达式通过key进行获取

    页面跳转-通过ModelAndView对象返回

    在Controller中方法返回ModelAndView对象,并且设置视图名称

    @RequestMapping(value="/quick2") public ModelAndView save2(){ /* Model:模型 作用封装数据 View:视图 作用展示数据 */ ModelAndView modelAndView = new ModelAndView(); //设置模型数据 modelAndView.addObject("username","二狗子"); //设置视图名称 modelAndView.setViewName("success"); return modelAndView; }

    这种方法就是直接将返回的视图与数据一同交由视图解析器进行自动处理

    当然也可以不创建ModelAndView对象而是在方法中声明,在Controller中方法形参上直接声明ModelAndView,无需在方法中自己创建,在方法中直接使用该对象设置视图,同样可以跳转页面

    @RequestMapping(value="/quick3") public ModelAndView save3(ModelAndView modelAndView){ modelAndView.addObject("username","华华"); modelAndView.setViewName("success"); return modelAndView; }

    回写数据-直接返回字符串

    通过SpringMVC框架注入的response对象,使用response.getWriter().print(“hello world”) 回写数据,此时不需要视图跳转,业务方法返回值为void将需要回写的字符串直接返回,但此时需要通过@ResponseBody注解告知SpringMVC框架通知视图解析器,方法返回的字符串不是跳转是直接在http响应体中返回

    @RequestMapping(value="/quick7") @ResponseBody //告知SpringMVC框架 不进行视图跳转 直接进行数据响应 public String save7() throws IOException { return "hello yh"; } @RequestMapping(value="/quick6") public void save6(HttpServletResponse response) throws IOException { response.getWriter().print("hello yh"); }

    json字符串也是字符串,所以也可以通过这种方式返回json字符串数据

    @RequestMapping(value="/quick8") @ResponseBody public String save8() throws IOException { return "{\"username\":\"zhangsan\",\"age\":18}"; }

    手动拼接json格式字符串的方式很麻烦,开发中往往要将复杂的java对象转换成json格式的字符串,我们可以使用web阶段学习过的json转换工具类进行转换后回写字符串(一般不用手动转换的方式)

    回写数据-返回对象或集合

    通过SpringMVC帮助我们对对象或集合进行json字符串的转换并回写,为处理器适配器配置消息转换参数,指定使用jackson进行对象或集合的转换,因此需要在spring-mvc.xml中进行如下配置:

    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"> <property name="messageConverters"> <list> <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/> </list> </property> </bean> @RequestMapping(value="/quick10") @ResponseBody //期望SpringMVC自动将User转换成json格式的字符串 public User save10() throws IOException { User user = new User(); user.setUsername("张三"); user.setAge(18); return user; }

    这样配置还是比较麻烦,配置的代码比较多,因此,我们可以使用mvc的注解驱动代替上述配置

    <mvc:annotation-driven/>

    在 SpringMVC 的各个组件中,处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件。 使用<mvc:annotation-driven />自动加载 RequestMappingHandlerMapping(处理映射器)和RequestMappingHandlerAdapter( 处 理 适 配 器 ),可用在Spring-xml.xml配置文件中使用<mvc:annotation-driven />替代注解处理器和适配器的配置。同时使用<mvc:annotation-driven />默认底层就会集成jackson进行对象或集合的json格式字符串的转换

    SpringMVC的数据请求

    客户端请求参数的格式是:name=value&name=value…… 服务器端要获得请求的参数,有时还需要进行数据的封装,SpringMVC可以接收如下类型的参数 ①基本类型参数 ②类类型参数 ③数组类型参数 ④集合类型参数

    1.基本类型参数的获取

    springmvc会自动进行解析,只需要在controller中的业务方法的参数名称与请求参数的name一致,参数值会自动映射匹配。并且能自动做类型转换; 自动的类型转换是指从String向其他类型的转换(注意类型转换失败的情况)

    @RequestMapping(value="/quick11") @ResponseBody public void save11(String username,int age){ System.out.println(username); System.out.println(age); }

    Controller中的业务方法的POJO参数的属性名与请求参数的name一致,参数值会自动映射匹配。

    2.类类型参数的获取

    package com.yunhe.pojo; public class User { private String username; private int age; public String getUsername() { return username; } public void setUsername(String username) { this.username = username; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } @Override public String toString() { return "User{" + "username='" + username + '\'' + ", age=" + age + '}'; } } @RequestMapping(value="/quick12") @ResponseBody public void save12(User user){ System.out.println(user); }

    3.数组类型参数的获取

    在前台页面提交的数据中,多个数据name相同,springmvc会自动解析成数组,但要求controller中的业务方法数组名称与请求参数的name一致,参数值会自动映射匹配。

    @RequestMapping(value="/quick13") @ResponseBody public void save13(String[] strs) throws IOException { System.out.println(Arrays.asList(strs)); }

    4.集合类型参数的获取

    springmvc会自动将对个name相同的数据解析为数组,所以在进行集合获取时需要将集合参数包装到一个POJO中才可以。

    <form action="${pageContext.request.contextPath}/user/quick14" method="post"> <%--表明是第一个User对象的username age--%> <input type="text" name="userList[0].username"><br/> <input type="text" name="userList[0].age"><br/> <input type="text" name="userList[1].username"><br/> <input type="text" name="userList[1].age"><br/> <input type="submit" value="提交"> </form> package com.yh.domain; import java.util.List; public class VO { private List<User> userList; public List<User> getUserList() { return userList; } public void setUserList(List<User> userList) { this.userList = userList; } @Override public String toString() { return "VO{" + "userList=" + userList + '}'; } } @RequestMapping(value="/quick14") @ResponseBody public void save14(VO vo) throws IOException { System.out.println(vo); }

    这种使用方式太过繁琐,对于不同的pojo类需要创建对应的集合类

    使用ajax提交json数据获取集合类型参数数据

    当使用ajax提交时,可以指定contentType为json形式,那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装

    <script src="${pageContext.request.contextPath}/js/jquery-3.3.1.js"></script> <script> var userList = new Array(); userList.push({username:"zhangsan",age:18}); userList.push({username:"lisi",age:28}); $.ajax({ type:"POST", url:"${pageContext.request.contextPath}/user/quick15", data:JSON.stringify(userList), contentType:"application/json;charset=utf-8" }); </script> @RequestMapping(value="/quick15") @ResponseBody public void save15(@RequestBody List<User> userList) throws IOException { System.out.println(userList); }

    SpringMVC静态资源的访问

    当有静态资源需要加载时,比如jquery文件,通过谷歌开发者工具抓包发现,没有加载到jquery文件,原因是SpringMVC的前端控制器DispatcherServlet的url-pattern配置的是/,代表对所有的资源都进行过滤操作,我们可以通过以下两种方式指定放行静态资源:

    •在spring-mvc.xml配置文件中指定放行的资源

    ​ <mvc:resources mapping="/js/**"location="/js/"/>

    •使用<mvc:default-servlet-handler/>标签

    <!--开发资源的访问--> <!--<mvc:resources mapping="/js/**" location="/js/"/> <mvc:resources mapping="/img/**" location="/img/"/>--> <mvc:default-servlet-handler/>

    SpringMVC配置编码过滤器

    使用springmvc与servlet一样,当编码不一致时会出现乱码问题,springmvc提供了CharacterEncodingFilter全局过滤器进行全局的编码配置

    <!--配置全局过滤的filter--> <filter> <filter-name>CharacterEncodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter> <filter-mapping> <filter-name>CharacterEncodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>

    SpringMVC配置编码过滤器

    当请求的参数名称与Controller的业务方法参数名称不一致时,就需要通过@RequestParam注解显式的绑定

    <form action="${pageContext.request.contextPath}/quick16" method="post"> <input type="text" name="name"><br> <input type="submit" value="提交"><br> </form> @RequestMapping(value="/quick16") @ResponseBody public void save16(@RequestParam(value="name",required = false,defaultValue = "yh") String username) throws IOException { System.out.println(username); }

    属性: value :页面数据的name required :是否必填(如果页面没有传递则报错默认为false) defaultValue :默认值,当页面没有传递数据时的赋值(默认为数据类型默认值)

    SpringMVC配置请求类型转换器

    SpringMVC 默认已经提供了一些常用的类型转换器,例如客户端提交的字符串转换成int型进行参数设置。 但是不是所有的数据类型都提供了转换器,没有提供的就需要自定义转换器,例如:日期类型的数据就需要自定义转换器。

    @component public class DateConverter implements Converter<String, Date> { public Date convert(String dateStr) { //将日期字符串转换成日期对象 返回 SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd"); Date date = null; try { date = format.parse(dateStr); } catch (ParseException e) { e.printStackTrace(); } return date; } } @RequestMapping(value="/quick18") @ResponseBody public void save18(Date date) throws IOException { System.out.println(date); } <mvc:annotation-driven conversion-service="conversionService"/> <bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean"> <property name="converters"> <set> <ref bean="dateConverter"/> </set> </property> </bean>

    请求头信息信息的获取

    使用@RequestHeader可以获得请求头信息,相当于web阶段学习的request.getHeader(name) @RequestHeader注解的属性如下: value:请求头的名称 required:是否必须携带此请求头

    @RequestMapping(value="/quick20") @ResponseBody public void save20(@RequestHeader(value = "User-Agent",required = false) String user_agent) throws IOException { System.out.println(user_agent); }

    使用@CookieValue可以获得指定Cookie的值 @CookieValue注解的属性如下: value:指定cookie的名称 required:是否必须携带此cookie

    @RequestMapping(value="/quick21") @ResponseBody public void save21(@CookieValue(value = "JSESSIONID") String jsessionId) throws IOException { System.out.println(jsessionId); }

    springmvc使用RESTful风格参数的获取

    Restful是一种软件架构风格、设计风格,而不是标准,只是提供了一组设计原则和约束条件。主要用于客户端和服务器交互类的软件,基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存机制等。

    Restful风格的请求是使用“url+请求方式”表示一次请求目的的,HTTP 协议里面四个表示操作方式的动词如下: GET:用于获取资源 POST:用于新建资源 PUT:用于更新资源 DELETE:用于删除资源

    例如: /user/1 GET : 得到 id = 1 的 user /user/1 DELETE: 删除 id = 1 的 user /user/1 PUT: 更新 id = 1 的 user /user POST: 新增 user

    上述url地址/user/1中的1就是要获得的请求参数,form表单提交数据的方式支持get与post,但是在SpringMVC中可以使用占位符进行参数绑定。地址/user/1可以写成/user/{id},占位符{id}对应的就是1的值。在业务方法中我们可以使用@PathVariable注解进行占位符的匹配获取工作。

    http://localhost:8080/springmvc1/quick17/zhangsan

    @RequestMapping(value="/quick17/{name}") @ResponseBody public void save17(@PathVariable(value="name") String username) throws IOException { System.out.println(username); }

    springmvc使用RESTful风格就是使用占位符的形式,将数据与地址进行绑定,通过@PathVariable注解进行获取,完成通过对不同路径请求完成类似功能的需求

    Processed: 0.011, SQL: 8