SpringBoot（19） - RestTemplate

参考：https://docs.spring.io/spring-boot/docs/1.5.17.RELEASE/reference/htmlsingle/#boot-features-restclient

 

1. RestTemplate

假如需要从应用程序远程调用REST服务，可以使用Spring的RestTemplate类。因为RestTemplate实例在使用之前通常需要自定义，SpringBoot不提供任何单个自动配置的RestTemplate的bean。但是，SpringBoot会自动配置一个RestTemplateBuilder，在有需要时，可以用来创建RestTemplate实例。自动配置的RestTemplateBuilder将确保将合理的HttpMessageConverter应用于RestTemplate实例。

示例：

@Service
public class MyBean {
    private final RestTemplate restTemplate;
    public MyBean(RestTemplateBuilder restTemplateBuilder) {
        this.restTemplate = restTemplateBuilder.build();
    }

    public Details someRestCall(String name) {
        return this.restTemplate.getForObject("/{name}/details", Details.class, name);
    }
}

注：RestTemplateBuilder包含许多有用的方法帮助我们快速配置一个RestTemplate。例如，要添加BASIC auth支持，可以使用builder.basicAuthorization("user"，"password").build()。

 

2. 自定义RestTemplate

自定义RestTemplate主要有三种方法，取决于想要自定义的广泛程度。

要使任何自定义的范围尽可能窄，注入自动配置的RestTemplateBuilder，然后根据需要调用其方法。 每个方法调用都返回一个新的RestTemplateBuilder实例，因此自定义只会影响构建器的使用。

要进行应用程序范围的附加定制，可以使用RestTemplateCustomizer的bean。 所有这些bean都会自动注册到自动配置的RestTemplateBuilder，并将应用于使用它构建的任何模板。

配置为所有主机使用代理，除了192.168.0.5，示例：

static class ProxyCustomizer implements RestTemplateCustomizer {
    @Override
    public void customize(RestTemplate restTemplate) {
        HttpHost proxy = new HttpHost("proxy.example.com");
        HttpClient httpClient = HttpClientBuilder.create().setRoutePlanner(new DefaultProxyRoutePlanner(proxy) {
            @Override
            public HttpHost determineProxy(HttpHost target,HttpRequest request, HttpContext context) throws HttpException {
                if (target.getHostName().equals("192.168.0.5")) {
                    return null;
                }
                return super.determineProxy(target, request, context);
            }
        }).build();
        restTemplate.setRequestFactory(new HttpComponentsClientHttpRequestFactory(httpClient));
    }
}

最极端（最不常使用）的选择是创建自己的RestTemplateBuilder bean。这将关闭RestTemplateBuilder的自动配置，并将阻止使用任何RestTemplateCustomizer bean。