最近很多交互要同原生的HttpServletRequest
和HttpServletResponse
打交道。从HttpServletRequest
中读取body数据封装成某种数据结构;向HttpServletResponse
写入数据并响应。传统的写法十分不优雅,明天给大家介绍一种比拟优雅的形式。
HttpMessageConverter
HttpMessageConverter
是Spring框架提供的一个音讯转换器模型,用于在 HTTP 申请和响应之间进行转换的策略接口。它能够对输出音讯HttpInputMessage
进行读;也能够对输入音讯HttpOutputMessage
进行写。
Spring MVC的音讯转换都是通过这个接口的实现来实现的。HttpMessageConverter
有很多实现:
通常Spring MVC中解决Form表单提交、JSON、XML、字符串、甚至Protobuf都由HttpMessageConverter
的实现来实现,前端传递到后端的body参数,后端返回给前端的数据都是由这个接口实现转换的。在Spring IoC中(Spring MVC环境)还存在一个寄存HttpMessageConverter
的容器HttpMessageConverters
:
@Bean @ConditionalOnMissingBean public HttpMessageConverters messageConverters(ObjectProvider<HttpMessageConverter<?>> converters) { return new HttpMessageConverters((Collection)converters.orderedStream().collect(Collectors.toList())); }
咱们能够间接拿来应用。那么到底怎么应用呢?那首先要搞清楚HttpInputMessage
和HttpOutputMessage
是干什么用的。
HttpInputMessage
HttpInputMessage
示意一个 HTTP 输出音讯,由申请头headers和一个可读的申请体body组成,通常由服务器端的 HTTP 申请句柄或客户端的 HTTP 响应句柄实现。
而HttpServletRequest
是ServletRequest
的扩大接口,提供了HTTP Servlet的申请信息,也蕴含了申请头和申请体,所以两者是有分割的。咱们只有找出两者之间的理论关系就能让HttpMessageConverter
去读取并解决HttpServletRequest
携带的申请信息。
ServletServerHttpRequest
说实话还真找到了:
ServletServerHttpRequest
不仅仅是HttpInputMessage
的实现,它还持有了一个HttpServletRequest
实例属性,ServletServerHttpRequest
的所有操作都是基于HttpServletRequest
进行的。咱们能够通过结构为其注入HttpServletRequest
实例,这样HttpMessageConverter
就能间接解决HttpServletRequest
了。
提取申请体实战
这里聚焦的场景是在Servlet过滤器中应用HttpMessageConverter
,在Spring MVC中不太倡议去操作HttpServletRequest
。我抉择了FormHttpMessageConverter
,它通常用来解决application/x-www-form-urlencoded
申请。咱们编写一个过滤器来拦挡申请提取body:
/** * 解决 application/x-www-form-urlencoded 申请 * * @author felord.cn */@Componentpublic class FormUrlencodedFilter implements Filter { private final FormHttpMessageConverter formHttpMessageConverter = new FormHttpMessageConverter(); private static final Logger log = LoggerFactory.getLogger(FormUrlencodedFilter.class); @Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException { String contentType = request.getContentType(); MediaType type= StringUtils.hasText(contentType)? MediaType.valueOf(contentType):null; ServletServerHttpRequest serverHttpRequest = new ServletServerHttpRequest((HttpServletRequest) request); if (formHttpMessageConverter.canRead(MultiValueMap.class,type)) { MultiValueMap<String, String> read = formHttpMessageConverter.read(null, serverHttpRequest); log.info("打印读取到的申请体:{}",read); } }}
而后执行一个POST
类型,Content-Type
为application/x-www-form-urlencoded
的申请:
POST /ind HTTP/1.1Host: localhost:8080Content-Type: application/x-www-form-urlencodedContent-Length: 20a=b123&c=d123&e=f123
控制台会打印:
2021-12-30 6:43:56.409 INFO 12408 --- [nio-8080-exec-1] sfds: 打印读取到的申请体:{a=[b123], c=[d123], e=[f123]}
ServletServerHttpResponse
有ServletServerHttpRequest
就有ServletServerHttpResponse
,大抵原理差不多。它正好和ServletServerHttpRequest
相同,如果咱们须要去解决响应问题,比方想通过HttpServletResponse
写个JSON响应,大略能够这么写:
ServletServerHttpResponse servletServerHttpResponse = new ServletServerHttpResponse(response);// 应用json converterMappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter = new MappingJackson2HttpMessageConverter();// authentication 指的是须要写的对象实例mappingJackson2HttpMessageConverter.write(authentication, MediaType.APPLICATION_JSON,servletServerHttpResponse);
总结
HttpMessageConverter
形象了HTTP音讯转换的策略,能够帮忙咱们优雅地解决一些申请响应的问题。不过有一点须要留神,申请体body只能读取一次,即便它包裹在ServletServerHttpRequest
中,要留神和HttpServletRequestWrapper
的区别。
关注公众号:Felordcn 获取更多资讯
集体博客:https://felord.cn