# Spring mvc 应用 ## 一、简介 ### 1.mvc体系结构 - 三层架构 我们的开发架构⼀般都是基于两种形式，⼀种是 C/S 架构，也就是客户端/服务器；另⼀种是 B/S 架构，也就是浏览器服务器。在 JavaEE 开发中，⼏乎全都是基于 B/S 架构的开发。那么在 B/S 架构中，系统标准的三层架构包括：表现层、业务层、持久层。三层架构在我们的实际开发中使⽤的⾮常多，所以我们课程中的案例也都是基于三层架构设计的 - 表现层 也就是我们常说的web 层。它负责接收客户端请求，向客户端响应结果，通常客户端使⽤http 协议请求web 层，web 需要接收 http 请求，完成 http 响应 - 业务层 也就是我们常说的 service 层。它负责业务逻辑处理，和我们开发项⽬的需求息息相关。web 层依赖业务层，但是业务层不依赖 web 层。业务层在业务处理时可能会依赖持久层，如果要对数据持久化需要保证事务⼀致性。（也就是我们说的， 事务应该放到业务层来控制） - 持久层 也就是我们是常说的 dao 层。负责数据持久化，包括数据层即数据库和数据访问层，数据库是对数据进⾏持久化的载体，数据访问层是业务层和持久层交互的接⼝，业务层需要通过数据访问层将数据持久化到数据库中。通俗的讲，持久层就是和数据库交互，对数据库表进⾏增删改查的。 - MVC设计模式 MVC 全名是 Model View Controller，是 模型(model)－视图(view)－控制器(controller) 的缩写， 是⼀种⽤于设计创建 Web 应⽤程序表现层的模式。MVC 中每个部分各司其职 - Model（模型）：模型包含业务模型和数据模型，数据模型⽤于封装数据，业务模型⽤于处理业务。 - View（视图）： 通常指的就是我们的 jsp 或者 html。作⽤⼀般就是展示数据的。通常视图是依据模型数据创建的。 - Controller（控制器）： 是应⽤程序中处理⽤户交互的部分。作⽤⼀般就是处理程序逻辑的。MVC提倡：每⼀层只编写⾃⼰的东⻄，不编写任何其他的代码；分层是为了解耦，解耦是为了维护⽅便和分⼯协作。 ### 2.Spring MVC SpringMVC 全名叫 Spring Web MVC，是⼀种基于 Java 的实现 MVC 设计模型的请求驱动类型的轻量级Web 框架，属于 SpringFrameWork 的后续产品 ![img](https://img.zhaojq.top/20260727091751517.png "img") Spring MVC 本质可以认为是对servlet的封装，简化了我们serlvet的开发 作⽤：1）接收请求 2）返回响应，跳转⻚⾯ ![img_1](https://img.zhaojq.top/20260727091751705.png "img_1") ## 二、工作流程 需求：前端浏览器请求url：http://localhost:8080/demo/handle01，前端⻚⾯显示后台服务器的时间开发过程 1）配置DispatcherServlet前端控制器 2）开发处理具体业务逻辑的Handler（@Controller、@RequestMapping） 3）xml配置⽂件配置controller扫描，配置springmvc三⼤件 4）将xml⽂件路径告诉springmvc（DispatcherServlet） ### 1.spring mvc 请求处理流程 ![img_2](https://img.zhaojq.top/20260727091751883.png "img_2") **流程说明** 第⼀步：⽤户发送请求⾄前端控制器DispatcherServlet 第⼆步：DispatcherServlet收到请求调⽤HandlerMapping处理器映射器 第三步：处理器映射器根据请求Url找到具体的Handler（后端控制器），⽣成处理器对象及处理器拦截器(如果 有则⽣成)⼀并返回DispatcherServlet 第四步：DispatcherServlet调⽤HandlerAdapter处理器适配器去调⽤Handler 第五步：处理器适配器执⾏Handler 第六步：Handler执⾏完成给处理器适配器返回ModelAndView 第七步：处理器适配器向前端控制器返回 ModelAndView，ModelAndView 是SpringMVC 框架的⼀个底层对 象，包括 Model 和 View 第⼋步：前端控制器请求视图解析器去进⾏视图解析，根据逻辑视图名来解析真正的视图。 第九步：视图解析器向前端控制器返回View 第⼗步：前端控制器进⾏视图渲染，就是将模型数据（在 ModelAndView 对象中）填充到 request 域 第⼗⼀步：前端控制器向⽤户响应结果 ### 2.spring mvc 九大组件 - HandlerMapping HandlerMapping 是⽤来查找 Handler 的，也就是处理器，具体的表现形式可以是类，也可以是⽅法。⽐如，标注了@RequestMapping的每个⽅法都可以看成是⼀个Handler。Handler负责具体实际的请求处理，在请求到达后，HandlerMapping 的作⽤便是找到请求相应的处理器Handler 和 Interceptor. - HandlerAdapter HandlerAdapter 是⼀个适配器。因为 Spring MVC 中 Handler 可以是任意形式的，只要能处理请求即可。但是把请求交给 Servlet 的时候，由于 Servlet 的⽅法结构都是doService(HttpServletRequest req,HttpServletResponse resp)形式的，要让固定的 Servlet 处理⽅法调⽤ Handler 来进⾏处理，便是 HandlerAdapter 的职责。 - HandlerExceptionResolver HandlerExceptionResolver ⽤于处理 Handler 产⽣的异常情况。它的作⽤是根据异常设置ModelAndView，之后交给渲染⽅法进⾏渲染，渲染⽅法会将 ModelAndView 渲染成⻚⾯ - ViewResolver ViewResolver即视图解析器，⽤于将String类型的视图名和Locale解析为View类型的视图，只有⼀个resolveViewName()⽅法。从⽅法的定义可以看出，Controller层返回的String类型视图名viewName 最终会在这⾥被解析成为View。View是⽤来渲染⻚⾯的，也就是说，它会将程序返回的参数和数据填⼊模板中，⽣成html⽂件。ViewResolver 在这个过程主要完成两件事情：ViewResolver 找到渲染所⽤的模板（第⼀件⼤事）和所⽤的技术（第⼆件⼤事，其实也就是找到视图的类型，如JSP）并填⼊参数。默认情况下，Spring MVC会⾃动为我们配置⼀个InternalResourceViewResolver,是针对 JSP 类型视图的。 - RequestToViewNameTranslator RequestToViewNameTranslator 组件的作⽤是从请求中获取 ViewName.因为 ViewResolver 根据ViewName 查找 View，但有的 Handler 处理完成之后,没有设置 View，也没有设置 ViewName，便要通过这个组件从请求中查找 ViewName。 - LocaleResolver ViewResolver 组件的 resolveViewName ⽅法需要两个参数，⼀个是视图名，⼀个是 Locale。 LocaleResolver ⽤于从请求中解析出 Locale，⽐如中国 Locale 是 zh-CN，⽤来表示⼀个区域。这个组件也是 i18n 的基础。 - ThemeResolver ThemeResolver 组件是⽤来解析主题的。主题是样式、图⽚及它们所形成的显示效果的集合。 Spring MVC 中⼀套主题对应⼀个 properties⽂件，⾥⾯存放着与当前主题相关的所有资源，如图⽚、CSS样式等。创建主题⾮常简单，只需准备好资源，然后新建⼀个“主题名.properties”并将资源设置进去，放在classpath下，之后便可以在⻚⾯中使⽤了。SpringMVC中与主题相关的类有ThemeResolver、ThemeSource和Theme。ThemeResolver负责从请求中解析出主题名， ThemeSource根据主题名找到具体的主题，其抽象也就是Theme，可以通过Theme来获取主题和具体的资源。 - MultipartResolver MultipartResolver ⽤于上传请求，通过将普通的请求包装成 MultipartHttpServletRequest 来实现。MultipartHttpServletRequest 可以通过 getFile() ⽅法 直接获得⽂件。如果上传多个⽂件，还可以调⽤ getFileMap()⽅法得到Map这样的结构，MultipartResolver 的作⽤就是封装普通的请求，使其拥有⽂件上传的功能。 - FlashMapManager FlashMap ⽤于重定向时的参数传递，⽐如在处理⽤户订单时候，为了避免重复提交，可以处理完post请求之后重定向到⼀个get请求，这个get请求可以⽤来显示订单详情之类的信息。这样做虽然可以规避⽤户重新提交订单的问题，但是在这个⻚⾯上要显示订单的信息，这些数据从哪⾥来获得呢？因为重定向时么有传递参数这⼀功能的，如果不想把参数写进URL（不推荐），那么就可以通过FlashMap来传递。只需要在重定向之前将要传递的数据写⼊请求（可以通过ServletRequestAttributes.getRequest()⽅法获得）的属性OUTPUT_FLASH_MAP_ATTRIBUTE中，这样在重定向之后的Handler中Spring就会⾃动将其设置到Model中，在显示订单信息的⻚⾯上就可以直接从Model中获取数据。FlashMapManager 就是⽤来管理 FalshMap 的。 >附：配置示例 > >web.xml > >```xml >"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" >"http://java.sun.com/dtd/web-app_2_3.dtd" > > > >Web Application > > > springmvc > org.springframework.web.servlet.DispatcherServlet > > > contextConfigLocation > classpath:springmvc.xml > > > > > springmvc > > > / > > >``` > >Springmvc.xml > >```xml > > 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 > https://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 >"> > > > > > > > > > > > > > > > > > > > > > > > > > > > > >``` ## 三、请求参数绑定 请求参数绑定：SpringMVC如何接收请求参数 http协议（超⽂本传输协议） **原⽣servlet**接收⼀个整型参数： 1. String ageStr = request.getParameter("age"); 2) Integer age = Integer.parseInt(ageStr); SpringMVC框架对Servlet的封装，简化了servlet的很多操作,SpringMVC在接收整型参数的时候，直接在Handler⽅法中声明形参即可 ```java @RequestMapping("xxx") public String handle(Integer age) { System.out.println(age); } ``` 参数绑定：取出参数值绑定到handler⽅法的形参上 - ### 默认⽀持 Servlet API 作为⽅法参数 当需要使⽤HttpServletRequest、HttpServletResponse、HttpSession等原⽣servlet对象时，直接在handler⽅法中形参声明使⽤即可。 ```java /** * /demo/handle02?id=1 * 如果要在SpringMVC中使⽤servlet原⽣对象，⽐如 * HttpServletRequest\HttpServletResponse\HttpSession，直接在Handler⽅法形参中声明使⽤即可 */ @RequestMapping("/handle02") public ModelAndView handle02(HttpServletRequest request, HttpServletResponse response, HttpSession session) { String id = request.getParameter("id"); ModelAndView modelAndView = new ModelAndView(); modelAndView.addObject("date", id); modelAndView.setViewName("success"); return modelAndView; } //除了ModelAndView,SpringMVC在handler方法上传入Map、Model和ModelMap参数，并向这些参数中保存数据（放入到请求域），都可以在页面获取到 ``` - ### 绑定简单类型参数 ⼋种基本数据类型及其包装类型，推荐使用包装类型，因为基础类型不能为null 绑定简单数据类型参数，只需要直接声明形参即可（形参参数名和传递的参数名要保持⼀致，建议 使⽤包装类型，当形参参数名和传递参数名不⼀致时可以使⽤@RequestParam注解进⾏⼿动映射） - 绑定Pojo类型数据，或pojo里嵌套pojo数据 以实体接收即可 ，参数名需与属性名保持一致 - ### 绑定日期类型参数 ```java /** * /demo/handle06?birth=2021-11-01 */ @RequestMapping("/handle06") public ModelAndView handle06(Date birth) { ModelAndView modelAndView = new ModelAndView(); modelAndView.addObject("date", birth); modelAndView.setViewName("success"); return modelAndView; } //报错 Failed to convert value of type 'java.lang.String' to required type 'java.util.Date ``` - 自定义类型转换器 ```java public class DateConverter implements Converter { @Override public Date convert(String source) { // 完成字符串向日期的转换 SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd"); try { Date parse = simpleDateFormat.parse(source); return parse; } catch (ParseException e) { e.printStackTrace(); } return null; } } ``` - 注册⾃定义类型转换器 ```xml ``` ## 四、Restful风格请求支持 Restful 是⼀种 web 软件架构⻛格，它不是标准也不是协议，它倡导的是⼀个资源定位及资源操作的⻛格 REST（英⽂：Representational State Transfer，简称 REST）描述了⼀个架构样式的⽹络系统， ⽐如web 应⽤程序。它⾸次出现在 2000 年 Roy Fielding 的博⼠论⽂中，他是 HTTP 规范的主要编写者之⼀。在⽬前主流的三种 Web 服务交互⽅案中，REST 相⽐于 SOAP（Simple Object Access protocol，简单对象访问协议）以及 XML-RPC 更加简单明了，⽆论是对 URL 的处理还是对 Payload 的编码，REST 都倾向于⽤更加简单轻量的⽅法设计和实现。值得注意的是 REST 并没有⼀个明确的标准，⽽更像是⼀种设计的⻛格。 它本身并没有什么实⽤性，其核⼼价值在于如何设计出符合 REST ⻛格的⽹络接⼝。 优点： - 结构清晰 - 符合标准 - 易于理解 - 扩展⽅便 特性： - 资源（Resources）：⽹络上的⼀个实体，或者说是⽹络上的⼀个具体信息 它可以是⼀段⽂本、⼀张图⽚、⼀⾸歌曲、⼀种服务，总之就是⼀个具体的存在。可以⽤⼀个 URI（统⼀资源定位符）指向它，每种资源对应⼀个特定的 URI 。要获取这个资源，访问它的 URI 就可以，因此URI 即为每⼀个资源的独⼀⽆⼆的识别符。 - 表现层：把资源具体呈现出来的形式，叫做它的表现层 （Representation）。 ⽐如，⽂本可以⽤ txt 格式表现，也可以⽤ HTML 格式、XML 格式、JSON 格式表现，甚⾄可以采⽤⼆进制格式。 - 状态转化（State Transfer）：每发出⼀个请求，就代表了客户端和服务器的⼀次交互过程 HTTP 协议，是⼀个⽆状态协议，即所有的状态都保存在服务器端。因此，如果客户端想要操作服务器， 必须通过某种⼿段，让服务器端发⽣“状态转化”（State Transfer）。⽽这种转化是建⽴在表现层之上的，所以就是 “ 表现层状态转化” 。具体说， 就是 HTTP 协议⾥⾯，四个表示操作⽅式的动词：GET 、POST 、PUT 、DELETE 。它们分别对应四种基本操作：GET ⽤来获取资源，POST ⽤来新建资源，PUT ⽤来更新资源，DELETE ⽤来删除资源 根据请求⽅式不同，代表要做不同的操作 - get 查询，获取资源 - post 增加，新建资源 - put 更新 - delete 删除资源 rest⻛格带来的直观体现：就是传递参数⽅式的变化，参数可以在uri中了 - /account/1 HTTP GET ：得到 id = 1 的 account - /account/1 HTTP DELETE：删除 id = 1 的 account - /account/1 HTTP PUT：更新 id = 1 的 account - URL：资源定位符，通过URL地址去定位互联⽹中的资源（抽象的概念，⽐如图⽚、视频、app服务等）。 **Spring MVC ⽀持 RESTful ⻛格请求**，具体讲的就是使⽤ **@PathVariable** 注解获取 RESTful ⻛格的请求URL中的路径变量 ```java /* * restful get /demo/handle/15 */ @RequestMapping(value = "/handle/{id}", method = {RequestMethod.GET}) public ModelAndView handleGet(@PathVariable("id") Integer id) { ModelAndView modelAndView = new ModelAndView(); modelAndView.addObject("date", "handleGet id：" + id); modelAndView.setViewName("success"); return modelAndView; } /* * restful post /demo/handle */ @RequestMapping(value = "/handle", method = {RequestMethod.POST}) public ModelAndView handlePost(String username) { ModelAndView modelAndView = new ModelAndView(); modelAndView.addObject("date", "handlePost username: " + username); modelAndView.setViewName("success"); return modelAndView; } /* * restful put /demo/handle/15/lisi */ @RequestMapping(value = "/handle/{id}/{name}", method = {RequestMethod.PUT}) public ModelAndView handlePut(@PathVariable("id") Integer id, @PathVariable("name") String username) { ModelAndView modelAndView = new ModelAndView(); modelAndView.addObject("date", "handlePut id: " + id + ", name: " + username); modelAndView.setViewName("success"); return modelAndView; } /* * restful delete /demo/handle/15 */ @RequestMapping(value = "/handle/{id}", method = {RequestMethod.DELETE}) public ModelAndView handleDelete(@PathVariable("id") Integer id) { Date date = new Date(); ModelAndView modelAndView = new ModelAndView(); modelAndView.addObject("date", "handleDelete id: " + id); modelAndView.setViewName("success"); return modelAndView; } ``` web.xml中配置请求⽅式过滤器（将特定的post请求转换为put和delete请求）(由于浏览器表单只支持get,post) ```xml hiddenHttpMethodFilter org.springframework.web.filter.HiddenHttpMethodFilter hiddenHttpMethodFilter /* ``` ## 五、Ajax Json交互 交互：两个⽅向 1. 前端到后台：前端ajax发送json格式字符串，后台直接接收为pojo参数，使⽤注解`@RequstBody` 2. 后台到前端：后台直接返回pojo对象，前端直接接收为json对象或者字符串，使⽤注解`@ResponseBody` ### 1.JSON Json是⼀种与语⾔⽆关的数据交互格式，就是⼀种字符串，只是⽤特殊符号{}内表示对象、[]内表示数组、""内是属性或值、：表示后者是前者的值 > {"name": "Michael"}可以理解为是⼀个包含name为Michael的对象 > > [{"name": "Michael"},{"name": "Jerry"}]就表示包含两个对象的数组 ### 2.`@ResponseBody`注解 @responseBody注解的作⽤是将controller的⽅法返回的对象通过适当的转换器转换为指定的格式之后，写⼊到response对象的body区，通常⽤来返回JSON数据或者是XML数据。 注意：在使⽤此注解之后不会再⾛视图处理器，⽽是直接将数据写⼊到输⼊流中，他的效果等同于通过response对象输出指定格式的数据 ### 3.分析Spring MVC 使⽤ Json 交互 依赖： ```xml com.fasterxml.jackson.core jackson-core 2.9.6 com.fasterxml.jackson.core jackson-databind 2.9.6 com.fasterxml.jackson.core jackson-annotations 2.9.0 ``` ```java @RequestMapping("/json") // 添加@ResponseBody之后，不再⾛视图解析器那个流程，⽽是等同于response直接输出数据 @ResponseBody public User json(@RequestBody User user) { // 业务逻辑处理，修改name为张三丰 user.setName("张三丰"); return user; } ```