org.springframework.vault.client

Class VaultClients

java.lang.Object

org.springframework.vault.client.VaultClients

public class VaultClients
extends Object

Vault Client factory to create RestTemplate configured to the needs of accessing Vault.

Author:

Mark Paluch

See Also:

VaultEndpoint, RestTemplate

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	VaultClients.PrefixAwareUriBuilderFactory
static class	VaultClients.PrefixAwareUriTemplateHandler

Constructor Summary

Constructors

Constructor and Description
VaultClients()

Method Summary

Modifier and Type	Method and Description
static ClientHttpRequestInterceptor	createNamespaceInterceptor(String namespace) Create a ClientHttpRequestInterceptor that associates each request with a X-Vault-Namespace header if the header is not present.
static RestTemplate	createRestTemplate() Create a RestTemplate for Vault interaction.
static RestTemplate	createRestTemplate(VaultEndpoint endpoint, ClientHttpRequestFactory requestFactory) Create a RestTemplate configured with VaultEndpoint and ClientHttpRequestFactory.
static RestTemplate	createRestTemplate(VaultEndpointProvider endpointProvider, ClientHttpRequestFactory requestFactory) Create a RestTemplate configured with VaultEndpointProvider and ClientHttpRequestFactory.
static UriBuilderFactory	createUriBuilderFactory(VaultEndpointProvider endpointProvider)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

VaultClients

public VaultClients()

Method Detail

createRestTemplate

public static RestTemplate createRestTemplate(VaultEndpoint endpoint,
                                              ClientHttpRequestFactory requestFactory)

Create a RestTemplate configured with VaultEndpoint and ClientHttpRequestFactory. The template accepts relative URIs without a leading slash that are expanded to use VaultEndpoint. RestTemplate is configured with a ClientHttpRequestInterceptor to enforce serialization to a byte array prior continuing the request. Eager serialization leads to a known request body size that is required to send a HttpHeaders.CONTENT_LENGTH request header. Otherwise, Vault will deny body processing.

Requires Jackson 2 for Object-to-JSON mapping.

Parameters:

endpoint - must not be null.

requestFactory - must not be null.

Returns:

the RestTemplate.

See Also:

Netty4ClientHttpRequestFactory, MappingJackson2HttpMessageConverter

createRestTemplate

public static RestTemplate createRestTemplate(VaultEndpointProvider endpointProvider,
                                              ClientHttpRequestFactory requestFactory)

Create a RestTemplate configured with VaultEndpointProvider and ClientHttpRequestFactory. The template accepts relative URIs without a leading slash that are expanded to use VaultEndpoint. RestTemplate is configured with a ClientHttpRequestInterceptor to enforce serialization to a byte array prior continuing the request. Eager serialization leads to a known request body size that is required to send a HttpHeaders.CONTENT_LENGTH request header. Otherwise, Vault will deny body processing.

Requires Jackson 2 for Object-to-JSON mapping.

Parameters:

endpointProvider - must not be null.

requestFactory - must not be null.

Returns:

the RestTemplate.

Since:

1.1

See Also:

Netty4ClientHttpRequestFactory, MappingJackson2HttpMessageConverter

createRestTemplate

public static RestTemplate createRestTemplate()

Create a RestTemplate for Vault interaction. RestTemplate is configured with a ClientHttpRequestInterceptor to enforce serialization to a byte array prior continuing the request. Eager serialization leads to a known request body size that is required to send a HttpHeaders.CONTENT_LENGTH request header. Otherwise, Vault will deny body processing.

Requires Jackson 2 for Object-to-JSON mapping.

Returns:

the RestTemplate.

See Also:

Netty4ClientHttpRequestFactory, MappingJackson2HttpMessageConverter

createNamespaceInterceptor

public static ClientHttpRequestInterceptor createNamespaceInterceptor(String namespace)

Create a ClientHttpRequestInterceptor that associates each request with a X-Vault-Namespace header if the header is not present.

Parameters:

namespace - the Vault namespace to use. Must not be null or empty.

Returns:

the ClientHttpRequestInterceptor to register with RestTemplate.

Since:

2.2

See Also:

VaultHttpHeaders.VAULT_NAMESPACE

createUriBuilderFactory

public static UriBuilderFactory createUriBuilderFactory(VaultEndpointProvider endpointProvider)