Spring Boot 参考指南（使用RestTemplate调用REST服务）

33. 使用RestTemplate调用REST服务

若是须要从应用程序调用远程REST服务，你可使用Spring框架的RestTemplate类，因为RestTemplate实例一般须要在使用以前进行定制，所以Spring Boot不提供任何自动配置的RestTemplate bean。可是，它能够自动配置一个RestTemplateBuilder，当须要时，它能够用来建立RestTemplate实例。自动配置的RestTemplateBuilder确保将合理的HttpMessageConverters应用于RestTemplate实例。

下面的代码展现了一个典型的样例：

@Service
public class MyService {

    private final RestTemplate restTemplate;

    public MyService(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()。

33.1 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。

---

上一篇：消息传递

下一篇：使用WebClient调用REST服务