关于SpringMVC在Controller层方法的参数解析详解
作者:DoneSpeak 发布时间:2022-10-29 01:06:10
使用版本:
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;
}
}
来源:https://www.yangguanrong.com/posts/211225-spring-webmvc-argument-resolver/
猜你喜欢
- Mybatis typeAlias标签在实际的工程之中,类的全限定名称很长,当我们需要大量使用的时候,这非常不方便的,然而mybatis提供
- 在项目中用到了MapStruct,对其可以转换JavaBean特别好奇,因为之前都是使用Vo的方式手动set转换,但是接触到MapStruc
- 今天去某在线教育面试面试官让做的一道题,题目描述如下:给定一个不重复的无序数组arr和一个定值num查找arr中是否有两个数的和等于num有
- 我们开发任何一个Spring Boot项目,都会用到如下的启动类@SpringBootApplication public class Ap
- 目录简介springfox大致原理:SpringBoot整合Swagger2引入依赖编写配置类配置SwaggerSwagger2常用注解使用
- 本文实例为大家分享了springboot实现异步任务的具体代码,供大家参考,具体内容如下1.什么异步任务同步:一定要等任务执行完了,得到结果
- MyBatis-Plus是通过version机制实现乐观锁的。大致思路:取出记录,携带记录的当前version;更新记录的时候,比较记录当前
- 前言你一定会好奇:“老周,你去哪开飞机了?这么久没写博客了。”老周:“我买不起飞机,开了个铁矿,挖了一年半的石头。谁知铁矿垮了,压死了几条蜈
- 前言我们在上一篇文章 中以实例讲解如何定义和使用 lambda 表达式,以及与其它语言相比,lambda 表达式在 Java 中的特殊规范。
- java自定义切面增强写代码时会遇到一些有些重复机械的工作, 这个时候就可以运用切面技术来帮我们节约时间介绍如何使用自定义注解增强方法, 实
- 对 Debug 的好奇初学 Java 时,我对 IDEA 的 Debug 非常好奇,不止是它能查看断点的上下文环境,更神奇的是我可以在断点处
- 最近“全网域(Web Scale)”一词被炒得火热,人们也正在通过扩展他们的应用程序架构来使他们的系统变得更加“全网域”。但是究竟什么是全网
- 本文实例讲述了java用接口、多态、继承、类计算三角形和矩形周长及面积的方法。分享给大家供大家参考。具体如下:定义接口规范:/** * @
- @schedule注解动态配置时间间隔动态配置时间间隔是通过自己实现的任务注册到任务调度实现的,并在每次调度的时候更改下次调度时间间隔,如果
- VisualVM是JDK自带的一款全能型性能监控和故障分析工具,包括对CPU使用、JVM堆内存消耗、线程、类加载的实时监控,内存dump文件
- 本文实例讲述了Hibernate实现批量添加数据的方法。分享给大家供大家参考,具体如下:1.Hibernate_016_Ba
- 在进行详解之前,我想先声明一下,本次我们进行讲解说明的是 Kafka 消息存储的信息文件内容,不是所谓的 Kafka 服务器运行产生的日志文
- 1. 前言在Java开发中接触的开发者大多数不太注重对接口的测试,结果在联调对接中出现各种问题。也有的使用Postman等工具进行测试,虽然
- 由于最近公司在开发一款后台与安卓的更新系统,经过再三研究之后,也是选择Mqtt这个目前流行的框架。为了能够让项目运营起来,最终虽说是选择Ac
- 提示:建议一定要看后面的@RequestBody的核心逻辑源码以及六个重要结论!本文前半部分的内容都是一些基本知识常识,可选择性跳过。声明: