关于SpringMVC在Controller层方法的参数解析详解

目录
  • 自定义参数解析器
  • 实现效果
  • 实现和配置
  • Spring提供解析器
  • 一些使用Tricky
  • 总结

使用版本:

spring-boot: 2.1.6.RELEASE

sping: 5.1.8.RELEASE

java: openjdk 11.0.13

自定义参数解析器

为了能够实现自定义参数解析器,只需要实现 HandlerMethodArgumentResolver 并将添加到 WebMvcConfigurer#addArgumentResolvers 即可。

实现效果

下面以添加一个获取请求头的 client-type 参数为例进行是实现。定义注解 @ClientTypeMark 以及enum ClientType ,用于注入header中的值。

@Target({ElementType.PARAMETER})

@Retention(RetentionPolicy.RUNTIME)

@Documented

public @interface ClientTypeMark {

}
public enum ClientType {

    WEB,

    MOBILE,

    UNKNOWN

    ;

}

最终实现的效果为在Controller的方法中,可以按照如下实现使用。

@RestController

@RequestMapping("/client")

public class ClientTypeEndpoint {

    @GetMapping("/cur")

    public ClientType getCurClientType(@ClientTypeMark ClientType clientType) {

        return clientType;

    }

}

实现和配置

按照如下方法实现 HandlerMethodArgumentResolver ,用于解析header中的 client-type 并转化为 ClientType 。

package io.github.donespeak.springbootsamples.web.common;

import org.apache.commons.lang3.StringUtils;

import org.springframework.core.MethodParameter;

import org.springframework.web.bind.support.WebDataBinderFactory;

import org.springframework.web.context.request.NativeWebRequest;

import org.springframework.web.method.support.HandlerMethodArgumentResolver;

import org.springframework.web.method.support.ModelAndViewContainer;

public class CurClientTypeMethodArgumentResolver implements HandlerMethodArgumentResolver {

    private final String[] CLIENT_TYPE_HEADER_NAMES = {"client-type", "CLIENT-TYPE", "Client-Type"};

    // 选择要被注入的参数:判断参数是否符合解析的条件

    @Override

    public boolean supportsParameter(MethodParameter param) {

        return param.hasParameterAnnotation(ClientTypeMark.class)

                && ClientType.class.isAssignableFrom(param.getParameterType());

    }

    // 返回值将被注入到被选中参数中

    @Override

    public Object resolveArgument(MethodParameter methodParameter, ModelAndViewContainer modelAndViewContainer,

            NativeWebRequest nativeWebRequest, WebDataBinderFactory webDataBinderFactory) throws Exception {

        String clientType = null;

        for (String clientTypeHeader: CLIENT_TYPE_HEADER_NAMES) {

            clientType = nativeWebRequest.getHeader(clientTypeHeader);

            if (StringUtils.isNotBlank(clientType)) {

                break;

            }

        }

        try {

            return StringUtils.isBlank(clientType) ? ClientType.UNKNOWN : ClientType.valueOf(clientType.toUpperCase());

        } catch (Exception e) {

            return ClientType.UNKNOWN;
        }
    }
}

为了使得配置能够生效,可以按照如下的方法添加解析器。

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> argumentResolvers) {

        // 解析@CurUserId注解的参数

        argumentResolvers.add(new CurClientTypeMethodArgumentResolver());

    }

}

至此,自定义参数解析器的工作就完成了。

Spring提供解析器

当你完成上面的自定义解析器的时候,大体就能知道Spring在Controller层的其他参数解析都是怎么实现的了。

如下是Spring Mvc默认的一些参数解析器。

package org.springframework.web.servlet.mvc.method.annotation;

public class RequestMappingHandlerAdapter extends AbstractHandlerMethodAdapter

        implements BeanFactoryAware, InitializingBean {

    ...

    /**

     * Return the list of argument resolvers to use including built-in resolvers

     * and custom resolvers provided via {@link #setCustomArgumentResolvers}.

     */

    private List<HandlerMethodArgumentResolver> getDefaultArgumentResolvers() {

        List<HandlerMethodArgumentResolver> resolvers = new ArrayList<>();

        // Annotation-based argument resolution

        // 解析:@RequestParam(required = false)

        resolvers.add(new RequestParamMethodArgumentResolver(getBeanFactory(), false));

        // 解析:@RequestParam Map

        resolvers.add(new RequestParamMapMethodArgumentResolver());

        // 解析:@PathVariable

        resolvers.add(new PathVariableMethodArgumentResolver());

        // 解析:@PathVariable Map

        resolvers.add(new PathVariableMapMethodArgumentResolver());

        // 解析:@MatrixVariable

        resolvers.add(new MatrixVariableMethodArgumentResolver());

        // 解析:@MatrixVariable Map

        resolvers.add(new MatrixVariableMapMethodArgumentResolver());

        // 解析:@ModelAttribute(required = false)

        resolvers.add(new ServletModelAttributeMethodProcessor(false));

        // 解析:@RequestBody

        resolvers.add(new RequestResponseBodyMethodProcessor(getMessageConverters(), this.requestResponseBodyAdvice));

        // 解析:@RequestPart

        resolvers.add(new RequestPartMethodArgumentResolver(getMessageConverters(), this.requestResponseBodyAdvice));

        // 解析:@RequestHeader

        resolvers.add(new RequestHeaderMethodArgumentResolver(getBeanFactory()));

        // 解析:@RequestHeader Map

        resolvers.add(new RequestHeaderMapMethodArgumentResolver());

        // 解析:@CookieValue

        resolvers.add(new ServletCookieValueMethodArgumentResolver(getBeanFactory()));

        // 解析:@Value

        resolvers.add(new ExpressionValueMethodArgumentResolver(getBeanFactory()));

        // 解析:@SessionAttribute

        resolvers.add(new SessionAttributeMethodArgumentResolver());

        // 解析:@RequestAttribute

        resolvers.add(new RequestAttributeMethodArgumentResolver());

        // Type-based argument resolution

        // 解析:WebRequest、ServletRequest、MultipartRequest、HttpSession、

        //      Principal、Locale、TimeZone、java.time.ZoneId、InputStream

        //      java.io.Reader、org.springframework.http.HttpMethod

        resolvers.add(new ServletRequestMethodArgumentResolver());

        // 解析:ServletResponse、OutputStream、Writer

        resolvers.add(new ServletResponseMethodArgumentResolver());

        // 解析:@HttpEntity、@RequestEntity

        resolvers.add(new HttpEntityMethodProcessor(getMessageConverters(), this.requestResponseBodyAdvice));

        // 解析:RedirectAttributes

        resolvers.add(new RedirectAttributesMethodArgumentResolver());

        // 解析:org.springframework.ui.Model, 值为ModelAndViewContainer#getModel

        resolvers.add(new ModelMethodProcessor());

        // 解析:Map, 值为ModelAndViewContainer#getModel

        resolvers.add(new MapMethodProcessor());

        // 解析:org.springframework.validation.Errors

        resolvers.add(new ErrorsMethodArgumentResolver());

        // 解析:org.springframework.web.bind.support.SessionStatus

        resolvers.add(new SessionStatusMethodArgumentResolver());

        // 解析:UriComponentsBuilder 或者 ServletUriComponentsBuilder

        resolvers.add(new UriComponentsBuilderMethodArgumentResolver());

        // Custom arguments

        if (getCustomArgumentResolvers() != null) {

            resolvers.addAll(getCustomArgumentResolvers());

        }

        // Catch-all

        // 解析:@RequestParam(required = true)

        resolvers.add(new RequestParamMethodArgumentResolver(getBeanFactory(), true));

        // 解析:@ModelAttribute(required = true)

        resolvers.add(new ServletModelAttributeMethodProcessor(true));

        return resolvers;
    }
    ...

}

一些使用Tricky

调整解析器的顺序

在一次使用spring security的开发中,定义的 UserDetials 实现类在实现 UserDetails 的同时还是实现了一个 Account 接口,在使用时,希望实现如下的效果。

public void doSomething(@AuthenticationPrincipal Account accout) {}

但因为同时使用了,spring-data,spring-data提供的 ProxyingHandlerMethodArgumentResolver 会在 AuthenticationPrincipalArgumentResolver 前面对Account进行注入处理。ProxyingHandlerMethodArgumentResolver 会拦截掉所有非org.springframework中定义的 接口 ,并尝试赋值。为了能够正常赋值给Account,需要调整两者的位置。实现如下:

import java.util.LinkedList;

import java.util.List;

import org.springframework.beans.BeansException;

import org.springframework.beans.factory.config.BeanPostProcessor;

import org.springframework.security.web.method.annotation.AuthenticationPrincipalArgumentResolver;

import org.springframework.stereotype.Component;

import org.springframework.web.method.support.HandlerMethodArgumentResolver;

import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter;

/**

 * 将 AuthenticationPrincipalArgumentResolver 移到最前面,如果不做调整,

 * 会因为ProxyingHandlerMethodArgumentResolver在AuthenticationPrincipalArgumentResolver前面,

 * 导致 @AuthenticationPrincipal Account account 无法注入

 */

public class ArgumentResolverBeanPostProcessor implements BeanPostProcessor {

    private static final String BEAN_REQUEST_MAPPING_HANDLER_ADAPTER = "requestMappingHandlerAdapter";

    @Override

    public Object postProcessAfterInitialization(Object bean, String beanName) throws BeansException {

        if (beanName.equals(BEAN_REQUEST_MAPPING_HANDLER_ADAPTER)) {

            RequestMappingHandlerAdapter adapter = (RequestMappingHandlerAdapter)bean;

            List<HandlerMethodArgumentResolver> argumentResolvers = adapter.getArgumentResolvers();

            LinkedList<HandlerMethodArgumentResolver> resolversAdjusted = new LinkedList<>(argumentResolvers);

            argumentResolvers.stream().forEach(r -> {

                if (AuthenticationPrincipalArgumentResolver.class.isInstance(r)) {

                    resolversAdjusted.addFirst(r);

                } else {

                    resolversAdjusted.add(r);

                }
            });
adapter.setArgumentResolvers(resolversAdjusted);

        }
        return bean;
    }

} 

总结

到此这篇关于SpringMVC在Controller层方法的参数解析的文章就介绍到这了,更多相关SpringMVC在Controller层方法参数内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们!

(0)

相关推荐

  • 聊聊springmvc中controller的方法的参数注解方式

    绪论 相信接触过springmvc的同学都知道,在springmvc的控制层中,我们在方法的参数中可以使用注解标识.比如下面例子: public Map<String, Object> login(@PathVariable("loginParams") String loginParams) @PathVariable注解就标识了这个参数是作为一个请求地址模板变量的(不清楚的同学可以先学习一下restful设计风格).这些注解都是spring内置注解,那么 我们可不可以自

  • SpringMVC Controller解析ajax参数过程详解

    在使用ajax发送请求时,如果发送的JSON数据的参数是一个类中的不同属性,在Controller类的方法中使用@RequestBody Object obj会直接封装进obj对象中 例如: 前端部分代码 JavaScript <script language="JavaScript"> function login(){ var user_name = $("#user_name").val(); //用户名 var user_password = $

  • 关于SpringMVC在Controller层方法的参数解析详解

    目录 自定义参数解析器 实现效果 实现和配置 Spring提供解析器 一些使用Tricky 总结 使用版本: spring-boot: 2.1.6.RELEASE sping: 5.1.8.RELEASE java: openjdk 11.0.13 自定义参数解析器 为了能够实现自定义参数解析器,只需要实现 HandlerMethodArgumentResolver 并将添加到 WebMvcConfigurer#addArgumentResolvers 即可. 实现效果 下面以添加一个获取请求头

  • 使用springmvc的controller层获取到请求的数据方式

    目录 content-type 1.application/x-www-form-urlencoded 1.1 String 参数值=reqeust.getParameter("参数名"); 1.2 Map<String,String[]> paramMap=request.getParameterMap(); 2.multipart/form-data 3.text/xml 4.application/json 4.1 页面请求的数据获取 4.1.1 页面js请求如下 4

  • Python requests.post方法中data与json参数区别详解

    在通过requests.post()进行POST请求时,传入报文的参数有两个,一个是data,一个是json. data与json既可以是str类型,也可以是dict类型. 区别: 1.不管json是str还是dict,如果不指定headers中的content-type,默认为application/json 2.data为dict时,如果不指定content-type,默认为application/x-www-form-urlencoded,相当于普通form表单提交的形式 3.data为s

  • SpringMVC开发restful API之用户查询代码详解

    一,什么是restful风格? 首先,我们来看几组例子. 传统的url: 查询 /user/query?name=tom GET 详情 /user/query?id=1 GET 创建 /user/create?name=tom POST 修改 /user/update?id=1&name=jerry POST 删除 /user/delete?id=1 GET restful风格的url: 查询 /user?name=tom GET 详情 /user/1 GET 创建 /user POST 修改

  • jQuery.Ajax()的data参数类型详解

    假如现在有这样一个表单,是添加元素用的. <form id='addForm' action='UserAdd.action' type='post'> <label for='uname'>用户名</label>:<input type='text' name='uname' id='uname'><br> <label for='mobileIpt'>手机号:</label><input type='text'

  • SpringMVC通过Ajax处理Json数据的步骤详解

    SpringMVC通过Ajax处理Json数据的实现 一.前言: Ajax: 在不重新加载整个页面的前提下,对网页的部分进行刷新,例如点赞,发送短信验证码功能等等,都可以通过ajax进行实现,Ajax实现了网页的异步刷新 想要实现的效果,点击按钮,前端显示后台发送过来的学生信息,本次我们使用jquery形式的Ajax来完成 二.使用步骤 1.引入jar jar: jackson-annotation.jar jackson-core.jar jackson-datebind.jar 如果不使用M

  • SpringBoot在RequestBody中使用枚举参数案例详解

    前文说到 优雅的使用枚举参数 和 实现原理,本文继续说一下如何在 RequestBody 中优雅使用枚举. 本文先上实战,说一下如何实现.在 优雅的使用枚举参数 代码的基础上,我们继续实现. 确认需求 需求与前文类似,只不过这里需要是在 RequestBody 中使用.与前文不同的是,这种请求是通过 Http Body 的方式传输到后端,通常是 json 或 xml 格式,Spring 默认借助 Jackson 反序列化为对象. 同样的,我们需要在枚举中定义 int 类型的 id.String

  • SpringMVC视图转发重定向区别及控制器示例详解

    目录 SpringMVC视图 一.ThymeleafView 二.转发视图 三.重定向视图 四.转发和重定向区别 五.视图控制器 view-controller SpringMVC视图 SpringMVC 中的视图是 View 接口,视图的作用是渲染数据,将模型 Model 中的数据展示给用户. 视图的种类很多,默认有:转发视图和重定向视图. 若使用的视图技术为 Thymeleaf,在 SpringMVC 的配置文件中配置了 Thymeleaf 的视图解析器,由此视图解析器解析之后所得到的是 T

  • 业务层hooks封装useSessionStorage实例详解

    目录 封装原因: 建议: 工具库封装模式: 工具库目录: API设计: 代码实践: Hooks设计方式 useSessionStorage.js 简介: 注意点 Api Params Options Result 总结: 封装原因: 名称:useSessionStorage 功能开发过程中,需要进行数据的临时存储,正常情况下,使用localStorage或者 sessionStorage,存在于 window 对象中,使用场景不一样. sessionStorage的生命周期是在浏览器关闭前,浏览

随机推荐