如果应用需要调用远程REST服务,你可以使用Spring框架的RestTemplate
类。由于RestTemplate
实例经常在使用前需要自定义,Spring Boot就没有提供任何自动配置的RestTemplate
bean,不过你可以通过自动配置的RestTemplateBuilder
创建自己需要的RestTemplate
实例。自动配置的RestTemplateBuilder
会确保应用到RestTemplate
实例的HttpMessageConverters
是合适的。
以下是典型的示例:
@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
。例如,你可以使用builder.basicAuthorization("user", "password").build()
添加基本的认证支持(BASIC auth)。
当使用RestTemplateBuilder
构建RestTemplate
时,可以通过RestTemplateCustomizer
进行更高级的定制,所有RestTemplateCustomizer
beans将自动添加到自动配置的RestTemplateBuilder
。此外,调用additionalCustomizers(RestTemplateCustomizer…)
方法可以创建一个新的,具有其他customizers的RestTemplateBuilder
。
以下示例演示使用自定义器(customizer)配置所有hosts使用代理,除了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));
}
}