springmvc的使用

末蓝、 2022-05-28 07:49 104阅读 0赞

一、springmvc的简介

springMVC的重要的拦截是servlet，其中他讲所有的拦截都拦截到这个servlet，将请求转接到springMVC的框架上，进行相应的逻辑处理。

二、springmvc的简单执行原理

其中springmvc是一个应用在java的后端的web层，其中主要是和客户端进行交互的框架，而其中的原理也是基于javaweb的，javaweb中的web层就是listening，filter，servlet等，而springmvc就是在servlet拦截请求后将拦截的请求传递给springmvc的框架进行处理。其中的协议也是基于http或者https的协议。

在后端的开发中其中web层主要是和客户端进行交互的接口，所以在这里我们要整合swagger来进行处理，方便客户端进行处理。也可以用rap搭建文档服务器。

![70][]

执行流程：

1）用户发送请求至**前端控制器**org.springframework.web.servlet.DispatcherServlet，其中这个类要在web.xml中进行配置，而且这个配置中还要制定springmvc的配置文件，如果不制定配置位置，默认配置文件在

<table> 
 <tbody> 
  <tr> 
   <td>DispatcherServlet：前端控制器<br> 用户请求到达前端控制器，它就相当于mvc模式中的c，dispatcherServlet是整个流程控制的中心，由它调用其它组件处理用户的请求，dispatcherServlet的存在降低了组件之间的耦合性。</td> 
  </tr> 
 </tbody> 
</table>

<servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
      	<init-param>
      		<param-name>contextConfigLocation</param-name>
      		<param-value>classpath:springmvc.xml</param-value>
      	</init-param>
    </servlet>
    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>*.action</url-pattern>
    </servlet-mapping>

2）DispatcherServlet收到请求调用HandlerMapping处理器映射器。

<table> 
 <tbody> 
  <tr> 
   <td> <p><span style="color:#000000;">HandlerMapping</span><span style="color:#000000;">：处理器映射器</span></p> <p><span style="color:#000000;">HandlerMapping</span><span style="color:#000000;">负责根据用户请求找到Handler即处理器，springmvc提供了不同的映射器实现不同的映射方式，例如：配置文件方式，实现接口方式，注解方式等。</span></p> </td> 
  </tr> 
 </tbody> 
</table>

3）处理器映射器根据请求url找到具体的处理器，生成处理器对象及处理器拦截器(如果有则生成)一并返回给DispatcherServlet。

4）DispatcherServlet通过HandlerAdapter处理器适配器调用处理器

<table> 
 <tbody> 
  <tr> 
   <td> <p><span style="color:#000000;">HandlAdapter</span><span style="color:#000000;">：处理器适配器</span></p> <p style="margin-left:0cm;"><span style="color:#000000;">通过HandlerAdapter对处理器进行执行，这是适配器模式的应用，通过扩展适配器可以对更多类型的处理器进行执行。</span></p> </td> 
  </tr> 
 </tbody> 
</table>

5）执行处理器(Controller，也叫后端控制器)。

<table> 
 <tbody> 
  <tr> 
   <td> <p><span style="color:#000000;">Handler</span><span style="color:#000000;">：处理器</span></p> <p style="margin-left:0cm;"><span style="color:#000000;">Handler </span><span style="color:#000000;">是继DispatcherServlet前端控制器的后端控制器，在DispatcherServlet的控制下Handler对具体的用户请求进行处理。</span><span style="color:#ff0000;">由于Handler涉及到具体的用户业务请求，所以一般情况需要程序员根据业务需求开发Handler。</span></p> </td> 
  </tr> 
 </tbody> 
</table>

6）Controller执行完成返回ModelAndView

7）HandlerAdapter将controller执行结果ModelAndView返回给DispatcherServlet

8）DispatcherServlet将ModelAndView传给ViewReslover视图解析器

<table> 
 <tbody> 
  <tr> 
   <td> <p><span style="color:#000000;">View Resolver</span><span style="color:#000000;">：视图解析器</span></p> <span style="color:#000000;">View Resolver</span><span style="color:#000000;">负责将处理结果生成View视图，View Resolver首先根据逻辑视图名解析成物理视图名即具体的页面地址，再生成View视图对象，最后对View进行渲染将处理结果通过页面展示给用户。</span></td> 
  </tr> 
 </tbody> 
</table>

9）ViewReslover解析后返回具体View

<table> 
 <tbody> 
  <tr> 
   <td> <p><span style="color:#000000;">View</span><span style="color:#000000;">：视图</span></p> <p style="margin-left:0cm;"><span style="color:#000000;">springmvc</span><span style="color:#000000;">框架提供了很多的View视图类型的支持，包括：jstlView、freemarkerView、pdfView等。我们最常用的视图就是jsp。</span><span style="color:#ff0000;">一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户，需要由程序员根据业务需求开发具体的页面。</span></p> </td> 
  </tr> 
 </tbody> 
</table>

10）DispatcherServlet对View进行渲染视图（即将模型数据填充至视图中）。

11）DispatcherServlet响应用户

思考的问题：

org.springframework.web.servlet.DispatcherServlet其中冲tomcat是怎样将其中传递到这个servlet上的？

servlet、filter、listen的执行顺序，这个是javaweb的内容？

org.springframework.web.servlet.DispatcherServlet在配置拦截的方式的时候其中几种的区别？

三、springmvc的重要配置文件springmvc.xml

1）spirngmvc的前段控制器

前端控制器是springmvc的重要入口，其中只有通过这个前段控制器，才能把前段的所有权限交给springmvc框架进行处理。

<servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
      		
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring/springmvc.xml</param-value>
        </init-param>
    </servlet>
    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
      	<url-pattern>*.action</url-pattern>
    </servlet-mapping>

2）处理器映射器和处理器适配器

代码处理方法：在controller注解的方法上用@ResquestMapping

当用户请求传递到前端控制器DispatcherServlet的时候，前端控制器要找到执行这个的具体的处理器Controller，所以前端控制器DispatcherServlet就将这个请求传递给处理器映射器HandlerMapping，通过处理器映射器去找到具体的处理器，但是这个处理器映射器如何才能找到具体的处理器呢？所以在整个springmvc加载之初，就是加载springmvc的配置文件springmvc.xml的时候，处理器映射器就需要知道所有的可以映射的处理器，就是处理器映射器要知道有多少个映射的方式，也就是有多少个controller。而处理器适配器就是在

<context:component-scan base-package="com.weiwei.springmvc.controller.first"/>
    
    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"/>
    
    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"/>

可以将上面的配置换位下面的配置

<context:component-scan base-package="com.weiwei.springmvc.controller"/>
    
    <mvc:annotation-driven conversion-service="conversionService"/>

3）视图解析器

就是在返回页面的时候，用户只需要用return "逻辑视图名";就可以直接放回页面，其中主要是配置了视图解析器，其中可以找到具体的页面，并将数据填充到页面中。

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView" />
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

四、springmvc的url映射@RequestMapping

1）@RequestMapping(value="/item")或@RequestMapping("/item"）,value的值是数组，可以将多个url映射到同一个方法

2)在class上添加@RequestMapping(url)指定通用请求前缀， 限制此类下的所有方法请求url必须以请求前缀开头，通过此方法对url进行分类管理。

3）请求方法限定

GET方法：@RequestMapping(method = RequestMethod.*GET*)

<table> 
 <tbody> 
  <tr> 
   <td> <p style="margin-left:0cm;"><span style="color:#000000;">如果通过</span><span style="color:#000000;">Post</span><span style="color:#000000;">访问则报错：</span></p> <p style="margin-left:0cm;"><span style="color:#000000;">HTTP Status 405 - Request method 'POST' not supported</span></p> </td> 
  </tr> 
 </tbody> 
</table>

POST方法：@RequestMapping(method = RequestMethod.*POST*)

<table> 
 <tbody> 
  <tr> 
   <td> <p style="margin-left:0cm;">如果通过Get访问则报错：</p> <p style="margin-left:0cm;"><span style="color:#000000;">HTTP Status 405 - Request method 'GET' not supported</span></p> </td> 
  </tr> 
 </tbody> 
</table>

GET和POST都可以：@RequestMapping(method=\{RequestMethod.GET,RequestMethod.POST\})

五、spirngmvc的参数绑定

1）参数绑定的说明流程

在servlet容器，比如说tomcat，其中tomcat的链接器和用户进行链接，链接之后会接受用户的请求，并将请求封装为request和response，并将这两个参数传递给tomcat的重要的另外一个主键server，server其中会接受request和response，之后就是根据javaweb的servlet进行拦截，但是springmvc使用了前段控制器DispatcherServlet将所有的拦截下来，之后就将所有的处理都交给springmvc框架进行处理。这个过程可以去深入了解tomcat原理和javaweb的基础知识。

2）springmvc可以接受的参数类型

**url中的参数**：其中url的地址中带有参数，

@RequestMapping("/viewItems/{id}") 
    public @ResponseBody viewItems(@PathVariable("id") String id,Model model) throws Exception{
        //如果RequestMapping中表示为"/viewItems/{id}"，id和形参名称一致，@PathVariable不用指定名称。
    
        //方法中使用@PathVariable获取useried的值，使用model传回页面
        //调用 service查询商品信息
        ItemsCustom itemsCustom = itemsService.findItemsById(id);
        return itemsCustom;
    }

**默认类型**：这些都是javaweb中的一些参数，应为这些参数都是有servlet传递的。（上面的原理有介绍到）

HttpServletRequest、HttpServletResponse、HttpSession：Springmvc框架会自动把Request对象传递给方法

Model/ModelMap：这个是springmvc为了将参数添加到页面的时候的一个参数，ModelMap是Model接口的实现类，通过Model或ModelMap向页面传递数据

**简单类型**：请求的参数名称和处理器形参**名称一致**时会将请求参数与形参进行绑定，参数类型推荐使用**包装数据类型**，因为基础数据类型不可以为null。

<table> 
 <thead> 
  <tr> 
   <th style="width:398px;">简单数据类型</th> 
   <th style="width:451px;">推荐使用</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td style="width:398px;">字符串</td> 
   <td style="width:451px;">String</td> 
  </tr> 
  <tr> 
   <td style="width:398px;"> <p>整形</p> </td> 
   <td style="width:451px;">Integer</td> 
  </tr> 
  <tr> 
   <td style="width:398px;">单精度</td> 
   <td style="width:451px;">Float</td> 
  </tr> 
  <tr> 
   <td style="width:398px;">双精度</td> 
   <td style="width:451px;">Double</td> 
  </tr> 
  <tr> 
   <td style="width:398px;"> <p>布尔型</p> </td> 
   <td style="width:451px;">Boolean</td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
  <tr> 
   <td> <p style="margin-left:0cm;">说明：对于布尔类型的参数，请求的参数值为true或false。</p> <p style="margin-left:0cm;">public String editItem(Model model,Integer id,<span style="color:#ff0000;">Boolean status</span>) throws Exception</p> <p style="margin-left:0cm;">请求url：http://localhost:8080/xxx.action?id=2<span style="color:#ff0000;">&amp;status=false</span></p> </td> 
  </tr> 
 </tbody> 
</table>

简单参数接受的方式还可以通过注解来进行接受@RequestParam

public String editItem(@RequestParam(value="item_id",required=true) String id) {
    	
    }
    /**
    value：参数名字，即入参的请求参数名字，如value=“item_id”表示请求的参数区中的名字为item_id的参数的值将传入；如果请求参数中没有item_id将跑出异常：
    HTTP Status 500 - Required Integer parameter 'item_id' is not present
    required：是否必须，默认是true，表示请求中一定要有相应的参数，否则将报:TTP Status 400 - Required Integer parameter 'XXXX' is not present
    defaultValue：默认值，表示如果请求中没有同名参数时的默认值
    **/

**简单java类（pojo）类型**：pojo对象中的属性名和表单中input的name属性一致

注意：提交的表单中不要有日期类型的数据，否则会报400错误。如果想提交日期类型的数据需要自定义参数绑定

解决原理：由于日期数据有很多种格式，所以springmvc没办法把字符串转换成日期类型。所以需要自定义参数绑定。前端控制器接收到请求后，找到注解形式的处理器适配器，对RequestMapping标记的方法进行适配，并对方法中的形参进行参数绑定。在springmvc这可以在处**理器适配器**上自定义**Converter进行参数绑定**。如果使用<mvc:annotation-driven/>可以在此标签上进行扩展。

<mvc:annotation-driven conversion-service="conversionService"/>
    
    <bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
        <property name="converters">
            <set>
                <bean class="com.weiwei.springmvc.convert.DateConverter"/>
            </set>
        </property>
    </bean>

public class DateConverter implements Converter<String, Date> {
    	@Override
    	public Date convert(String source) {
    		SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
    		try {
    			return simpleDateFormat.parse(source);
    		} catch (ParseException e) {
    			e.printStackTrace();
    		}
    		return null;
    	}
    }

其中上面的实质原理是如下的配置，就是在适配器RequestMappingHandlerAdapter中将自定义的DateConverter插入进去。

<context:component-scan base-package="cn.itcast.springmvc.controller" />
    		
    
    <bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
        <property name="converters">
            <set>
                <bean class="com.weiwei.springmvc.convert.DateConverter"/>
            </set>
        </property>
    </bean>
    
    
    <bean id="customBinder" class="org.springframework.web.bind.support.ConfigurableWebBindingInitializer">
        <property name="conversionService" ref="conversionService" />
    </bean>
    
    
    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
        <property name="webBindingInitializer" ref="customBinder"></property> 
    </bean>
    
    
    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"/>
    
    
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView" />
        
        <property name="prefix" value="/WEB-INF/jsp/" />
        
        <property name="suffix" value=".jsp" />
    </bean>

**绑定包装pojo**：就是类中封装了一个类

**绑定数组**：

**集合List**：

3）绑定参数中的乱码解决方法

**post解决方法**：在web.xml中配置如下参数，由于在javaweb中执行顺序是listen——>filter——>servlet，在将请求传递给springmvc的前端控制器的时候，filter会先处理，其中下面的处理就是处理请求过来post的参数的乱码问题。

<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>

**get乱码解决方法**：

修改tomcat中的conf下的server.xml的配置文件，其中添加URIEncoding="utf-8"（推荐）

或者在代码中使用转码的方式（不推荐）

String userName = new String(request.getParamter("userName").getBytes("ISO8859-1"),"utf-8")

五、springmvc的参数返回

1）返回ModelAndView

controller方法中定义ModelAndView对象并返回，对象中可添加model数据、指定view。

2）返回void，其中在参数接受中可以接受request和response的javaweb的两个参数，可以用javaweb的方式来返回

//使用request转向页面，如下：
    request.getRequestDispatcher("页面路径").forward(request, response);
    
    //也可以通过response页面重定向：
    response.sendRedirect("url")
    
    //也可以通过response指定响应结果，例如响应json数据如下：
    response.setCharacterEncoding("utf-8");
    response.setContentType("application/json;charset=utf-8");
    response.getWriter().write("json串");

3）返回字符串

//controller方法返回字符串可以指定逻辑视图名，通过视图解析器解析为物理视图地址。
    return "item/editItem";
    
    //重定向到queryItem.action地址,request无法带过去
    return "redirect:queryItem.action";
    
    //结果转发到editItem.action，request可以带过去
    return "forward:editItem.action";

六、json数据交互（传递json数据，返回json数据，**这种方式常用**）

说明：这种方式就是浏览器传递过来的是json，我们需要返回的也是json，所以springmvc的工作就是**将请求来的json转化为javabean，将javabean转化为json返回给浏览器。**Springmvc默认用MappingJacksonHttpMessageConverter对json数据进行转换。

@RequestBody：通过springmvc提供的HttpMessageConverter接口将读到的内容转换为json、xml等格式的数据并绑定到controller方法的参数上。实现接收http请求的json数据，将json数据转换为java对象。

@ResponseBody：通过HttpMessageConverter接口转换为指定格式的数据如：json,xml等，通过Response响应给客户端。

其中默认使用MappingJacksonHttpMessageConverter，如果使用**<mvc:annotation-driven />**则不用配置，其配置原理如下。

<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
        <property name="messageConverters">
            <list>
                <bean class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter"></bean>
            </list>
        </property>
    </bean>

七、spirngmvc的图片上传

1）文件上传的原理

*CommonsMultipartResolver*解析器依赖commons-fileupload和commons-io，

2）配置和使用

在springmvc.xml文件中进行配置

<bean id="multipartResolver"
    	class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    	
    	<property name="maxUploadSize">
    		<value>5242880</value>
    	</property>
    </bean>

图片上传controller的使用

//商品修改提交
    @RequestMapping("/editItemSubmit")
    public String editItemSubmit(Items items, MultipartFile pictureFile)throws Exception{
        //原始文件名称
        String pictureFile_name =  pictureFile.getOriginalFilename();
        //新文件名称
        String newFileName = UUID.randomUUID().toString()+pictureFile_name.substring(pictureFile_name.lastIndexOf("."));
    		
        //上传图片
        File uploadPic = new java.io.File("F:/develop/upload/temp/"+newFileName);
        if(!uploadPic.exists()){
            uploadPic.mkdirs();
        }
        //向磁盘写文件
        pictureFile.transferTo(uploadPic);
        .....
    }

八、springmvc的异常处理

1）异常处理思路

springmvc在处理请求过程中出现异常信息交由异常处理器进行处理，自定义异常处理器可以实现一个系统的异常处理逻辑。

系统中异常包括两类：预期异常和运行时异常RuntimeException，前者通过捕获异常从而获取异常信息，后者主要通过规范代码开发、测试通过手段减少运行时异常的发生。

系统的dao、service、controller出现都通过throws Exception向上抛出，最后由springmvc前端控制器交由异常处理器进行异常处理，自己定义的异常处理器要实现HandlerExceptionResolver。

2）springmvc的异常处理器的使用

在springmvc进行配置

<bean id="handlerExceptionResolver" class="com.weiwei.ssm.controller.exceptionResolver.CustomExceptionResolver"/>

public class CustomExceptionResolver implements HandlerExceptionResolver {
    
    	@Override
    	public ModelAndView resolveException(HttpServletRequest request,HttpServletResponse response, Object handler, Exception ex) {
    		ex.printStackTrace();
    
    		CustomException customException = null;
    		
    		//如果抛出的是系统自定义异常则直接转换
    		if(ex instanceof CustomException){
    			customException = (CustomException)ex;
    		}else{
    			//如果抛出的不是系统自定义异常则重新构造一个系统错误异常。
    			customException = new CustomException("系统错误，请与系统管理 员联系！");
    		}
    		
    		ModelAndView modelAndView = new ModelAndView();
    		modelAndView.addObject("message", customException.getMessage());
    		modelAndView.setViewName("error");
    
    		return modelAndView;
    	}
    }

九、springmvc的拦截器

1）拦截器的简介

Spring MVC 的处理器拦截器类似于Servlet 开发中的过滤器Filter，用于对**处理器**进行**预处理**和**后处理**。

2）拦截器的执行流程

preHandle按拦截器定义**顺序调用**

postHandler按拦截器定义**逆序调用**

afterCompletion按拦截器定义**逆序调用**

postHandler在拦截器链内**所有拦截器返成功调用**

afterCompletion只有**preHandle返回true**才调用

3）拦截器的定义

Public class HandlerInterceptor1 implements HandlerInterceptor{
    
    	/**
    	 * controller执行前调用此方法
    	 * 返回true表示继续执行，返回false中止执行
    	 * 这里可以加入登录校验、权限拦截等
    	 */
    	@Override
    	Public boolean preHandle(HttpServletRequest request,HttpServletResponse response, Object handler) throws Exception {
    		// TODO Auto-generated method stub
    		Return false;
    	}
    
    	/**
    	 * controller执行后但未返回视图前调用此方法
    	 * 这里可在返回用户前对模型数据进行加工处理，比如这里加入公用信息以便页面显示
    	 */
    	@Override
    	Public void postHandle(HttpServletRequest request,HttpServletResponse response,Object handler,ModelAndView modelAndView) throws Exception {
    		// TODO Auto-generated method stub
    	}
    
    	/**
    	 * controller执行后且视图返回后调用此方法
    	 * 这里可得到执行controller时的异常信息
    	 * 这里可记录操作日志，资源清理等
    	 */
    	@Override
    	Public void afterCompletion(HttpServletRequest request,HttpServletResponse response,Object handler, Exception ex)
            throws Exception {
    		// TODO Auto-generated method stub
    	}
    }

4）拦截器的配置

针对某种mapping配置拦截器

针对所有mapping配置全局拦截器

<mvc:interceptors>
    	
    	<mvc:interceptor>
    		<mvc:mapping path="/**"/>
    		<bean class="com.weiwei.springmvc.filter.HandlerInterceptor1"></bean>
    	</mvc:interceptor>
    	<mvc:interceptor>
    		<mvc:mapping path="/**"/>
    		<bean class="com.weiwei.springmvc.filter.HandlerInterceptor2"></bean>
    	</mvc:interceptor>
    </mvc:interceptors>

十、spirngmvc的总结

springmvc主要是和浏览器进行交互数据的，其中要考虑如何通过url来找到对应的处理方法，之后就是接受参数，返回参数。其中接受参数类型有json、文件、基本数据等等，返回参数有json、页面等等。

[70]: /images/20220528/618c3c5d0adb4221b257706d25c9d39e.png