Spring Cloud OpenFeign @SpringQueryMap注解

概述

我们在使用@GetMapping方法是，对于多个参数都是通过@RequestParam参数一个一个接取的，多个参数时会比较麻烦，能像@RequestBody那样接取@PostMapping的参数么？答案是可以的。

@SpringQueryMap介绍

@SpringQueryMap 注解是 spring-cloud-openfeign-core:2.1.0.RELEASE 开始引入的一个新注解。

它被包含在 spring-cloud-starter-openfeign:2.1.0.RELEASE 中

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
    <version>2.1.0.RELEASE</version>
</dependency>

虽然 OpenFeign 的 @QueryMap注解支持将 POJO 映射到 GET 方法的参数上。但由于缺少value属性而与 Spring 不兼容，为此 Spring Cloud OpenFeign 提供了等效的@SpringQueryMap注解，用于将 POJO 或 Map ，映射为 GET 方法的参数。

@SpringQueryMap使用

@SpringQueryMap 注解用法也很简单，假设有一个叫 StudentDTO的类。

public class StudentDTO {
    private String name;
    private String age;

    // get、set 方法
}

spring-cloud-openfeign-core:2.1.0.RELEASE 之前，你不能直接传递对象，只能将它手动拆分成多个字段进行传参.

@FeignClient("demo")
public interface DemoTemplate {
    @GetMapping(path = "/demo")
    String demoEndpoint(@RequestParam String name, @RequestParam String age);
}

spring-cloud-openfeign-core:2.1.0.RELEASE 开始 @SpringQueryMap注解可以自动帮你完成参数映射。

// 等效于上面的写法
@FeignClient("demo")
public interface DemoTemplate {

    @GetMapping(path = "/demo")
    String demoEndpoint(@SpringQueryMap StudentDTO studentDTO);
}

@SpringQueryMap 注解不解析父类字段

这句话是啥意思了？
我们来看一个例子，还是刚刚那个 StudentDTO，但是现在它继承了 PageDTO。

public class PageDTO {
    private Integer page;
    private Integer siez;
    // get、set 方法
}

public class StudentDTO exdents PageDTO {
    private String name;
    private String age;
    // get、set 方法
}

然后同样使用 @SpringQueryMap 来映射。

@FeignClient("demo")
public interface DemoTemplate {

    @GetMapping(path = "/demo")
    String demoEndpoint(@SpringQueryMap StudentDTO studentDTO);
    // 等效于 String demoEndpoint(@RequestParam String name，@RequestParam String age);
}

但实际结果可能跟你想的不太一样，上面的写法等效于。

String demoEndpoint(@RequestParam String name, @RequestParam String age);

可以看到 StudentDTO exdents PageDTO 中的参数并没有映射上去。

原因

其实，准确来说，“@SpringQueryMap 注解不解析父类字段” 这种说法并不准确，因为这并不是 @SpringQueryMap 的问题。
原生的 OpenFeign 在使用原生的 @QueryMap 注解时，也会出现这个问题。
问题的重点不在于 @QueryMap 注解而是在于 OpenFeign 的 encode 上。

@QueryMap 对应的 encode 为 QueryMapEncoder, 而从 QueryMapEncoder 源码注释中可以看出，FieldQueryMapEncoder 虽然是 QueryMapEncoder 的默认实现，但是已经不推荐使用了，其中一个原因就是因为它不会去映射 POJO 的父类属性。

public interface QueryMapEncoder {

  /**
   * ...
   */
  Map<String, Object> encode(Object object);

  /**
   * @deprecated use {@link BeanQueryMapEncoder} instead. default encoder uses reflection to inspect
   *             provided objects Fields to expand the objects values into a query string. If you
   *             prefer that the query string be built using getter and setter methods, as defined
   *             in the Java Beans API, please use the {@link BeanQueryMapEncoder}
   */
  class Default extends FieldQueryMapEncoder {
  }
}

解决方案

知道了原因，解决方案就很简单了，跟换为 @QueryMap 的 QueryMapEncoder 为推荐的 BeanQueryMapEncoder 就行了。

@Configuration
public class FeignClientCustomizerConfig {

	/**
	 * 替换解析 queryMap 的类，实现父类中变量的映射
	 * @return
	 */
	@Bean
	public Feign.Builder feignBuilder() {
		return Feign.builder()
			.queryMapEncoder(new BeanQueryMapEncoder());
	}
}

然后使用上面自定义的配置，如果想让它全局生效，就在 Spting boot 启动类上。

@EnableFeignClients(defaultConfiguration = FeignClientCustomizerConfig.class)
@SpringBootApplication
public class TestApplication {
    public static void main(String[] args) {
    }
}

如果只想让它在单个 FeignClient 上生效，就加上 configuration 属性。

@FeignClient(value = "xxx", configuration = FeignClientCustomizerConfig.class)
@RequestMapping("/xxx")
@Service
public interface XxxFeignClient {
}

参考

Spring Cloud OpenFeign @SpringQueryMap