SpringMVC基础知识（3）

偏执的太偏执、 2022-07-13 01:29 251阅读 0赞

# 1、包装类型pojo参数绑定 #

1.1、需求：

商品查询controller方法中实现商品查询条件传入。

1.2、实现方法

第一种方法：在形参中添加HttpServletRequest request参数，通过request接收查询条件参数。

第二种方法：在形参中让包装类型的pojo接收查询条件参数。

分析：

页面传参数的特点：复杂、多样性。

如果将用户账号、商品编号、订单信息等放在简单pojo（属性是简单类型）中，pojo类属性比较多，比较乱。

建议使用包装类型的pojo，pojo中属性是pojo。

1.3、页面参数和controller方法形参定义

页面参数：

controller方法形参：

@RequestMapping("/queryItems")
        public ModelAndView queryItems(HttpServletRequest request, ItemsQueryVo itemsQueryVo) throws Exception{

![Center][]

# 2、集合类型绑定 #

##       2.1、数组绑定 ##

2.1.1、需求：

商品批量删除，用户在页面选择多个商品，批量删除。

2.1.2、表现层实现

关键：将页面选择（多选）的商品id，传到controller方法的形参，方法形参使用数组接收页面请求的多个商品id。

controller方法定义：

//批量删除商品信息
        @RequestMapping("/deleteItems")
        public String deleteItems(Integer[] items_id) throws Exception{

2.1.3、页面定义：

商品列表：
    <table width="100%" border=1>
    <tr>
    	<td>选择</td>
    	<td>商品名称</td>
    	<td>商品价格</td>
    	<td>生产日期</td>
    	<td>商品描述</td>
    	<td>操作</td>
    </tr>
    <c:forEach items="${itemsList }" var="item">
    <tr>
    	<td><input type="checkbox" name="items_id" value="${item.id }"/></td>
    	<td>${item.name }</td>
    	<td>${item.price }</td>
    	<td><fmt:formatDate value="${item.createtime}" pattern="yyyy-MM-dd HH:mm:ss"/></td>
    	<td>${item.detail }</td>
    	
    	<td><a href="${pageContext.request.contextPath }/items/editItems.action?id=${item.id}">修改</a></td>
    
    </tr>
    </c:forEach>

##       2.2、list绑定 ##

2.2.1、需求:

通常在需要批量提交数据时，将提交的数据绑定到list<pojo>中。例如：成绩录入（录入多门课成绩，批量提交）

本例需求：批量修改商品信息，在页面输入多个商品信息，将多个商品信息提交到controller方法中。

2.2.2、表现层实现

controller方法定义：

1）进入批量修改商品页面

2）批量修改商品提交

使用List接收页面提交的批量数据，通过包装pojo接收，在包装pojo中定义list<pojo>属性

public class ItemsQueryVo {
    
        // 商品信息
        private Items items;
    
        private ItemsCustom itemsCustom;
    
        private List<ItemsCustom> itemsList;

修改商品信息提交的方法：

//通过ItemsQueryVo接收批量提交的商品信息，将商品信息存储到itemsQueryVo中itemsList属性中
        @RequestMapping("/editItemsAllsubmit")
        public String editItemsAllsubmit(HttpServletRequest request, ItemsQueryVo itemsQueryVo) throws Exception{

页面定义：

![Center 1][]

##       2.3、map绑定 ##

在包装pojo中定义map类型属性。

在包装类中定义Map对象，并添加get/set方法，action使用包装对象接收。

包装类中定义Map对象如下：

Public class QueryVo {
    private Map<String, Object> itemInfo = new HashMap<String, Object>();
      //get/set方法..
    }

页面定义如下：

# 3、springmvc校验 #

3.1、校验理解

项目中，通常使用较多是前端的校验，比如页面js校验。对于安全要求较高建议在服务端进行校验。

服务端校验：

控制层controller：校验页面请求的参数的合法性。在服务端控制层controller校验，不区分客户端类型（浏览器、手机客户端、远程调用）

业务层service（ 使用较多）：主要校验关键业务参数，仅限于service接口中使用的参数。

持久层dao：一般是不校验的。

3.2、springmvc校验需求

springmvc使用Hibernate的校验框架validation（和Hibernate没有任何关系）

校验思路：

页面提交请求的参数，请求到controller方法中，使用validation进行校验。如果校验出错，将错误信息展示到页面。

具体需求：

商品修改，添加校验（校验商品名称长度，生产日期的非空校验），如果校验出错，在商品修改页面显示错误信息。

3.3、添加校验框架validation所需要的jar包

![Center 2][]

3.4、在springmvc.xml文件中配置校验器

<bean id="validator"
    		class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean">
    		
    		<property name="providerClass" value="org.hibernate.validator.HibernateValidator" />
    		
    		<property name="validationMessageSource" ref="messageSource" />
    	</bean>
    	
    	<bean id="messageSource"
    		class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
    		
    		<property name="basenames">   
           	 <list>    
                <value>classpath:CustomValidationMessages</value> 
           	 </list>   
        	</property>
    		
    		<property name="fileEncodings" value="utf-8" />
    		
    		<property name="cacheSeconds" value="120" />
    	</bean>

3.5、将校验器注入到处理器适配器中

![Center 3][]

3.6、在pojo中添加校验规则

在Items.java中添加校验规则：

![Center 4][]

3.7、配置校验错误信息

创建CustomValidationMessages.properties，配置校验错误信息：

![Center 5][]

3.8、捕获校验错误信息

☆：在需要校验的pojo前边添加@Validated，在需要校验的pojo后边添加BindingResult  bindingResult接收校验出错信息。

注意：@Validated和BindingResult  bindingResult是配对出现的，并且形参顺序是固定的。

![Center 6][]

3.9、在页面显示校验错误信息

在controller中将错误信息传到页面：

![Center 7][]

在页面中显示错误信息：

![Center 8][]

3.10、分组校验

3.10.1、需求：

在pojo中定义校验规则，而pojo是被多个controller所共用，当不同的controller方法对同一个pojo进行校验，但是每个controller方法需要不同的校验。

解决方法：

定义多个校验分组（其实是一个java接口），分组中定义有哪些规则

每个controller方法使用不同的校验分组

3.10.2、创建校验分组

![Center 9][]

3.10.3、在校验规则中添加分组

![Center 10][]

3.10.4、在controller中使用指定分组的校验

![Center 11][]

# 4、数据回显 #

4.1、什么数据回显？

提交后，如果出现错误，将刚才提交的数据回显到刚才的提交页面。

4.2、pojo数据回显方法

1）springmvc默认对pojo数据进行回显。

pojo数据传入controller方法后，springmvc自动将pojo数据放到request域，key等于pojo类型（首字母小写）

使用@ModelAttribute指定pojo回显到页面在request中的key

2）@ModelAttribute还可以将方法的返回值传到页面

在商品查询列表页面，通过商品类型查询商品信息。

在controller中定义商品类型查询方法，最终将商品类型传到页面。

![Center 12][]

页面上可以得到itemTypes数据：

![Center 13][]

3）简单方法使用model，可以不用@ModelAttribute

![Center 14][]

4.3、简单类型数据回显

使用简单方法model

model.addAttribute("id",id);

# 5、异常处理 #

5.1、异常处理思路

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

系统的dao、service、controller出现都通过throws Exception向上抛出，最后由springmvc前端控制器交由异常处理器进行处理，如下图：

![Center 15][]

springmvc提供全局异常处理处理器（一个系统只有一个异常处理器）进行统一异常处理。

5.2、自定义异常类

对不同的异常类型定义异常类，继承Exception。

package lsq.study.ssm.exception;
    
    /**
     * 系统自定义异常类，针对预期的异常，需要在程序中抛出此类的异常
     * @author lsq
     *
     */
    public class CustomException extends Exception {
    
        // 异常信息
        public String message;
    
        public CustomException(String message) {
            super(message);
            this.message = message;
        }
    
        public String getMessage() {
            return message;
        }
    
        public void setMessage(String message) {
            this.message = message;
        }
    
    }

5.3、全局异常处理器

思路：

系统遇到异常，在程序中手动抛出，dao抛给service，service抛给controller，controller抛给前端控制器，前端控制器调用全局异常处理器。

全局异常处理器处理思路：

1）解析出异常类型

2）如果该异常类型是系统自定义异常，直接取出异常信息，在错误页面显示

3）如果该异常类型不是系统自定义异常，构造一个自定义的异常类型（信息为“未知错误”）

☆：springmvc提供了一个HandlerExceptionResolver接口

package lsq.study.ssm.exception;
    
    import javax.servlet.http.HttpServletRequest;
    import javax.servlet.http.HttpServletResponse;
    
    import org.springframework.web.servlet.HandlerExceptionResolver;
    import org.springframework.web.servlet.ModelAndView;
    
    /**
     * 全局异常处理类
     * @author lsq
     *
     */
    public class CustomExceptionResolver implements HandlerExceptionResolver{
    
        public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler,
                Exception ex) {
            //handler就是处理器适配器要执行的handler对象（只有method）
            
    //        1）解析出异常类型
    //        2）如果该异常类型是系统自定义异常，直接取出异常信息，在错误页面显示
    //        String message = null;
    //        if(ex instanceof CustomException){
    //            message = ((CustomException)ex).getMessage();
    //        }else {
            3）如果该异常类型不是系统自定义异常，构造一个自定义的异常类型（信息为“未知错误”）
    //            message = "未知错误";
    //        }
            
            //对上边的代码进行修改
            CustomException customException = null;
            if(ex instanceof CustomException){
                customException = (CustomException)ex;
            }else{
                customException = new CustomException("未知错误");
            }
            
            //获取错误信息
            String message = customException.getMessage();
            
            ModelAndView modelAndView = new ModelAndView();
            
            //将错误信息传递到页面
            modelAndView.addObject("message", message);
            
            //指向错误页面
            modelAndView.setViewName("error");
            
            return modelAndView;
        }
    
    }

5.4、错误提示页面

![Center 16][]

5.5、在springmvc.xml配置全局异常处理器

<bean class="lsq.study.ssm.exception.CustomExceptionResolver"></bean>

5.6、异常测试

在controller、service、dao中任意一处需要手动抛出异常。

如果是程序手动抛出的异常，在错误页面中显示自定义的异常信息，如果不是手动抛出异常说明是一个运行时异常，在错误页面只显示“未知错误”。

在商品修改的controller方法中抛出异常：

![Center 17][]

在service接口中抛出异常：

![Center 18][]

总结：

如果与业务功能相关的异常，建议在service中抛出异常。

与业务功能没有关系的异常，建议在controller中抛出异常。

# 6、上传图片 #

6.1、需求：

在修改商品页面，添加上传商品图片功能。

6.2、springmvc中对多部件类型解析

在页面中提交enctype="multipart/form-data"的数据时，需要springmvc对multipart类型的数据进行解析。

在springmvc.xml中配置multipart类型解析器：

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

6.3、加入上传图片的jar包

![Center 19][]

6.4、创建图片虚拟目录存储图片

通过图形界面配置：

![Center 20][]  
      也可以直接修改tomcat的配置：

在conf/server.xml文件中，添加虚拟目录：

![Center 21][]

注意：在图片虚拟目录中，一定将图片目录分级创建（提高i/o性能），一般我们采用按照日期（年、月、日）进行分级创建。

6.5、上传图片代码：

6.5.1、页面

![Center 22][]

6.5.2、controller方法

![Center 23][]

![Center 24][]

# 7、json数据交互 #

##       7.1、为什么要进行json数据交互？ ##

json数据格式在接口调用中、html页面中较常用，json格式比较简单，解析比较方便。

比如：webservice接口，传输json数据。

##       7.2、springmvc进行json交互 ##

![Center 25][]

☆：注意

1）请求json、输出json，要求请求的是json串，所以在前端页面中需要将请求的内容转成json，不方便。

2）请求key/value、输出json。此方法比较常用。

##       7.3、环境准备 ##

7.3.1、加载json使用的jar包

springmvc中使用jackson的包进行json转换（@requestBody和@responseBody使用下边的包进行json转换），如下：

![Center 26][]

7.3.2、配置json转换器

在注解适配器中加入messageConverters

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

☆注意：如果使用<mvc:annotation-driven/>，则不用定义上边的内容。

##       7.4、json交互测试 ##

7.4.1、输入json串，输出json串

1）jsp页面：

使用jquery的ajax提交json串，对输出的json结果进行解析。

![Center 27][]

2）controller定义

![Center 28][]

3）测试结果：

![Center 29][]

7.4.2、输入key/value，输出json串

1）jsp页面

![Center 30][]

2）controller方法

![Center 31][]

3）测试结果

![Center 32][]

# 8、RESTful支持 #

8.1、什么是RESTful?

RESTful架构是目前最流行的一种互联网软件架构。它结构清晰、符合标准、易于理解、扩展方便。

1）对url进行规范，写RESTful格式的url

特点：url简洁，将参数通过url传递到服务端

2）http的方法规范

不管是删除、添加、更新。使用url是一致的，如果进行删除，需要设置http方法为delete。。。

后台controller方法：判断http方法，如果是delete，执行删除，如果是post，执行添加。

8.2、RESTful的例子

8.2.1、需求：查询商品信息，返回json数据

8.2.2、controller方法定义：

定义方法，进行url映射使用REST风格的url，将查询商品信息的id传入controller，

输出json使用@responseBody将java对象输出为json

![Center 33][]

@PathVariable用于将请求URL中的模板变量映射到功能处理方法的参数上。

如果@RequestMapping中表示为"/itemsView/\{id\}"，id和形参名称一致，@PathVariable不用指定名称。

8.2.3、REST方法的前端控制器配置

在web.xml中配置：

![Center 34][]

8.3、对静态资源的解析

配置前端控制器的url-parttern中指定/，对静态资源的解析出现问题：

![Center 35][]

解决办法：

在springmvc.xml文件中添加静态资源解析方法

![Center 36][]

# 9、拦截器 #

9.1、拦截器的定义

定义拦截器，实现HandlerInterceptor接口。接口中提供三个方法：

package lsq.study.ssm.interceptor;
    
    import javax.servlet.http.HttpServletRequest;
    import javax.servlet.http.HttpServletResponse;
    
    import org.springframework.web.servlet.HandlerInterceptor;
    import org.springframework.web.servlet.ModelAndView;
    
    public class HandlerInterceptor1 implements HandlerInterceptor{
    
        //进入Handler方法之前执行
        //用于身份认证、身份授权
        //比如身份认证，如果认证不通过表示当前用户没有登录，需要此方法拦截不再向下执行
        public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
            //return false 表示拦截，不再向下执行
            //return true 表示放行
            return false;
        }
        
        //进入Handler方法之后，返回modelandview之前执行
        //应用场景：（从ModelAndView出发）将公用的模型数据在这里传到视图，也可以在这里统一制定视图
        public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView mv)
                throws Exception {
            
        }
    
        //执行Handler完成执行此方法
        //应用场景：统一异常处理，统一日志处理
        public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
                throws Exception {
            
        }
    }

9.2、拦截器配置

9.2.1、针对HandlerMapping配置

springmvc拦截器针对HandlerMapping进行拦截设置，如果在某个HandlerMapping中配置拦截，经过该HandlerMapping映射成功的handler最终使用该拦截器。

该方法一般不推荐使用。

9.2.2、类似全局的拦截器配置

springmvc配置类似全局的拦截器配置，springmvc框架将配置的类似全局的拦截器注入到每个HandlerMapping中。

<mvc:interceptors>
    		<mvc:interceptor>
    			
    			<mvc:mapping path="/**"/>
    			<bean class="lsq.study.ssm.interceptor.HandlerInterceptor1"/>
    		</mvc:interceptor>
    		<mvc:interceptor>
    			<mvc:mapping path="/**"/>
    			<bean class="lsq.study.ssm.interceptor.HandlerInterceptor2"/>
    		</mvc:interceptor>
    	</mvc:interceptors>

9.3、拦截测试

9.3.1、测试需求

测试多个拦截器各个方法执行时机。

9.3.2、编写两个拦截器

![Center 37][]

9.3.3、两个拦截器都放行

HandlerInterceptor1...preHandle

HandlerInterceptor2...preHandle

HandlerInterceptor2...postHandle

HandlerInterceptor1...postHandle

HandlerInterceptor2...afterCompletion

HandlerInterceptor1...afterCompletion

总结：

preHandle方法按顺序执行，

postHandle和afterCompletion按拦截器配置的逆向顺序执行。

9.3.4、拦截器1放行，拦截器2不放行

HandlerInterceptor1...preHandle

HandlerInterceptor2...preHandle

HandlerInterceptor1...afterCompletion

总结：

拦截器1放行，拦截器2preHandle才会执行。

拦截器2preHandle不放行，拦截器2postHandle和afterCompletion不会执行。

只要有一个拦截器不放行，postHandle不会执行。

9.3.5、拦截器1不放行，拦截器2不放行

HandlerInterceptor1...preHandle

总结：

拦截器1preHandle不放行，postHandle和afterCompletion不会执行。

拦截器1不执行，拦截器2不执行。

9.3.6、小结

根据测试结果，对拦截器应用。

比如：统一日志处理拦截器，需要该拦截器preHandle一定要放行，且将它放在拦截器链中第一个位置，这样afterCompletion方法才会执行。

比如：登录认证拦截器，放在拦截器链中第一个位置。权限校验拦截器，放在登录认证拦截器之后。（因为登录通过后才校验权限）

[Center]: /images/20220713/88883a196d9643f5bad9ec409f7b936b.png
[Center 1]: /images/20220713/81119757f29c4c27a04e329214324275.png
[Center 2]: /images/20220713/ff3f2047f32f470eb3f8c5aae17e3c2d.png
[Center 3]: /images/20220713/572358256f2e40b78e814ed93fde9e76.png
[Center 4]: /images/20220713/f7703536b2ae45d3a9194f7d18b999eb.png
[Center 5]: /images/20220713/aa6a2b1d2451404b9863fdf196a9117f.png
[Center 6]: /images/20220713/616f0505cf7f4678804d93b1bf3f1327.png
[Center 7]: /images/20220713/093cfd172209496899777ba7e6e5fa99.png
[Center 8]: /images/20220713/a8d07540d2c24a6483914804a3d9edda.png
[Center 9]: /images/20220713/11e40ffca66042fdadafb8814deb6bd5.png
[Center 10]: /images/20220713/43865551777444bbb8a86be2074779fc.png
[Center 11]: /images/20220713/c79ab7d372004aeaa865faa4858e1507.png
[Center 12]: /images/20220713/613b119ff4cc4ff2b95c28a5b8b6b444.png
[Center 13]: /images/20220713/7ad10e7ddd324a0f970669f0264a958f.png
[Center 14]: /images/20220713/e36b27f4674c4571a459f8fa0399c92f.png
[Center 15]: /images/20220713/e9bc15a3576a4246b2daf8e9593f8c2f.png
[Center 16]: /images/20220713/7b9874129c934b2aaedb99561a75f6d8.png
[Center 17]: /images/20220713/9b124e3c9e0e4b579cdf886ae137a322.png
[Center 18]: /images/20220713/e03d125688fa48519ab7255ee4ac6e39.png
[Center 19]: /images/20220713/a6e23580c35f41c28d9b4eade1c53993.png
[Center 20]: /images/20220713/ed03e3c1d0c8474598bfa2c206e4217b.png
[Center 21]: /images/20220713/0464d85f7d464b9195c0089a2b666305.png
[Center 22]: /images/20220713/dfa9f32a7e6944b4bab6bc2a4a90b3a7.png
[Center 23]: /images/20220713/f1d5feec01614675a1ef97ff97e87f04.png
[Center 24]: /images/20220713/adb2bcd6e10b4538bc3d648257865c43.png
[Center 25]: /images/20220713/a173c033531a404f96ac88dc63b58fd6.png
[Center 26]: /images/20220713/8ebd9ecc51a24c2ebfaabbbeeed5b101.png
[Center 27]: /images/20220713/ed1baab8d71d4c54947af726b979cac9.png
[Center 28]: /images/20220713/a406d42346fb498f8d3f4a28986d673a.png
[Center 29]: /images/20220713/086b8117610d4019b5753ca63d2a5877.png
[Center 30]: /images/20220713/9fca32f08a8b44908d7c85cb42c0f8c4.png
[Center 31]: /images/20220713/1a362982e3dd414bb4732df40ac9794d.png
[Center 32]: /images/20220713/38e0489fd1614a058f15e31c24685b95.png
[Center 33]: /images/20220713/319a33db92634d2d8bf8159cbe9125b8.png
[Center 34]: /images/20220713/51b5a5a9b966400cb675b6c6e3a6f4b7.png
[Center 35]: /images/20220713/32ebfbe1c47b479590eaf7838a35323e.png
[Center 36]: /images/20220713/a9fedd80013c48cc9695e819ff7f9355.png
[Center 37]: /images/20220713/f9f9c4d78f5545e881f17efa33d66a95.png