SpringCloudGateway获取body中的参数,最优雅的方式

本文介绍如何在Spring Cloud Gateway中整合URL参数与Form Body参数。通过配置CacheRequestBodyGatewayFilterFactory过滤器缓存请求体,再自定义过滤器解析并合并参数。

前言

        项目需要在Gateway中获取请求参数,原生提供了request.getQueryParams()方法获取请求参数,但是只能获得url上的param,对于form body中的参数获取不到。找了很多方法,网上普遍都是通过自定义Filter缓存Body中的内容,然后再获取缓存的Body,此处的缓存实现方法各异,有些还存在内存泄漏问题。本文使用官方自带的缓存过滤器实现,然后整合url参数和body参数到同一对象进行查询。

配置官方过滤器

        在yml配置文件中设置CacheRequestBodyGatewayFilterFactory过滤器到请求链路上,此过滤器或帮我们缓存请求中的body,避免后文获取不到body。需要注意的是yml中的name对应的是CacheRequestBody,还需要提供一个bodyClass参数,具体配置看代码。

spring:
  cloud:
    gateway:
      routes:
        #user 模块
        - id: user-system
          uri: lb://user-system
          predicates:
            - Path=/user/**
          filters:
            - name: CacheRequestBody
              args:
                bodyClass: java.lang.String
            # token认证
            - TokenFilter

获取参数

        上文配置缓存后,我们就可以在自定义过滤器中获取body内容了,此处获取到的是String类型的数据,类似:name=123456&sex=1。我们使用自定义方法将body字符串进行解析,然后将原有的queryParams合并到一起方便后文查询。

public class TokenFilter extends AbstractGatewayFilterFactory {

	@Override
	public GatewayFilter apply(Object config) {
		return (exchange, chain) -> {
			ServerHttpRequest request = exchange.getRequest();
			//获取body内容,必须在yml中配置CacheRequestBody,让系统缓存body,不然此处无法获取
			String cachedRequestBody = exchange.getAttribute(ServerWebExchangeUtils.CACHED_REQUEST_BODY_ATTR);
			MultiValueMap<String, String> queryParams = formatUrlParam(cachedRequestBody, request.getQueryParams());
			// 获取参数
			String grantType = queryParams.getFirst("grant_type");
			// TODO 业务逻辑
			return chain.filter(exchange.mutate().request(request).build());
		};
	}

	/**
	 * 将body中的字符串格式化并合并url中的参数
	 * @param cachedRequestBody body字符串
	 * @return map
	 */
	private MultiValueMap<String, String> formatUrlParam(String cachedRequestBody, MultiValueMap<String, String> queryParams){
		if(cachedRequestBody == null || "".equals(cachedRequestBody.trim())){
			return queryParams;
		}
		//定义返回对象
		Map<String, List<String>> mapParam = new HashMap<>();
		//拷贝url中的参数
		queryParams.forEach(mapParam::put);
		//解析body中的参数
		String[] splitURL=cachedRequestBody.split("&");
		for(String s:splitURL){
			if(s.indexOf("=") > 0){
				s = s.replace("&", "");
				int index = s.indexOf("=");
				String key = s.substring(0, index);
				String value = s.substring(index+1);
				//适配系统逻辑
				List<String> list = mapParam.computeIfAbsent(key, k -> new ArrayList<>());
				list.add(value);
			}
		}
		return new MultiValueMapAdapter<>(mapParam);
	}
}

总结

  1. 配置yml中的CacheRequestBody
  2. 自定义过滤器中获取:
    exchange.getAttribute(ServerWebExchangeUtils.CACHED_REQUEST_BODY_ATTR)
### 如何在 Spring Cloud Gateway获取 HTTP 请求对象及参数 #### 使用 `ServerWebExchange` 获取请求信息 在 Spring Cloud Gateway 的环境中,所有的请求处理都是基于 `ServerWebExchange` 对象完成的。此对象提供了访问当前HTTP请求和响应的能力[^1]。 ```java @Component public class CustomGlobalFilter implements GlobalFilter { @Override public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) { ServerHttpRequest request = exchange.getRequest(); // 打印请求路径 System.out.println("Request Path: " + request.getURI().getPath()); // 处理逻辑... return chain.filter(exchange); } } ``` #### 解决 POST 请求体只能读取一次的问题 由于 Reactor Netty 和 WebFlux 的特性,在 Spring Cloud Gateway 中直接读取请求体会消耗掉输入流,使得后续处理器无法再读取该数据。为了克服这个问题,可以采用缓存请求体的方式: - 将原始请求转换成新的带有相同属性但可重复读取的内容的新请求; - 利用自定义过滤器来实现上述功能[^2]。 ```java import org.springframework.core.io.buffer.DataBuffer; import reactor.core.publisher.Flux; // 缓存请求体并创建新请求的方法 private static ServerHttpRequest copyRequestBody(ServerHttpRequest request) throws IOException { Flux<DataBuffer> cachedBody = request.getBody() .cache(); ServerHttpRequestDecorator decoratedRequest = new ServerHttpRequestDecorator(request) { @Override public Flux<DataBuffer> getBody() { return cachedBody; } }; return decoratedRequest; } ``` #### 日志记录中的应用实例 当希望在网关层面对所有进入系统的 API 调用做统一的日志管理时,可以通过全局过滤器截获每一个到来的请求,并从中提取必要的元数据以及可能存在的 JSON 形式的负载内容进行记录。 ```java @Slf4j @Component public class LoggingFilter extends AbstractGatewayFilterFactory<LoggingFilter.Config> { private final ObjectMapper objectMapper = new ObjectMapper(); public LoggingFilter() { super(Config.class); } @Override public GatewayFilter apply(Config config) { return (exchange, chain) -> { try { String bodyString = extractBodyAsString(exchange); log.info("Received Request:\nMethod:{}\nPath:{}\nHeaders:{}\nBody:{}", exchange.getRequest().getMethod(), exchange.getRequest().getURI().getPath(), exchange.getRequest().getHeaders(), bodyString); return chain.filter(exchange.mutate().request(copyRequestBody(exchange.getRequest())).build()); } catch (Exception e) { throw new RuntimeException(e.getMessage(), e); } }; } private String extractBodyAsString(ServerWebExchange exchange) throws Exception { StringBuilder builder = new StringBuilder(); exchange.getAttributeOrDefault("cached_request_body", "") .toString() .chars() .forEach(c -> builder.append((char)c)); if(builder.length() == 0){ return ""; } return builder.toString(); } public static class Config {} } ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值