diff --git a/src/main/asciidoc/index.adoc b/src/main/asciidoc/index.adoc index 06540331..9adcf4a1 100644 --- a/src/main/asciidoc/index.adoc +++ b/src/main/asciidoc/index.adoc @@ -4,6 +4,7 @@ Mark Paluch; :revdate: {localdate} :toc: macro :toc-placement!: +:spring-framework-docs: http://docs.spring.io/spring/docs/{springVersion}/spring-framework-reference/ (C) 2016-2017 The original authors. diff --git a/src/main/asciidoc/preface.adoc b/src/main/asciidoc/preface.adoc index e4aaff2c..a3da3792 100644 --- a/src/main/asciidoc/preface.adoc +++ b/src/main/asciidoc/preface.adoc @@ -21,7 +21,7 @@ as well as Spring concepts. [[get-started:first-steps:spring]] == Knowing Spring -Spring Vault uses Spring framework's http://docs.spring.io/spring/docs/4.2.x/spring-framework-reference/html/spring-core.html[core] functionality, such as the http://docs.spring.io/spring/docs/{springVersion}/spring-framework-reference/html/beans.html[IoC] container. While it is not important to know the Spring APIs, understanding the concepts behind them is. At a minimum, the idea behind IoC should be familiar for whatever IoC container you choose to use. +Spring Vault uses Spring framework's {spring-framework-docs}core.html[core] functionality, such as {spring-framework-docs}/core.html[IoC] container. While it is not important to know the Spring APIs, understanding the concepts behind them is. At a minimum, the idea behind IoC should be familiar for whatever IoC container you choose to use. The core functionality of the Vault support can be used directly, with no need to invoke the IoC services of the Spring Container. This is much like `RestTemplate` which can be used 'standalone' without any other services of the Spring container. To leverage all the features of Spring Vault document, such as the session support, you will need to configure some parts of the library using Spring. diff --git a/src/main/asciidoc/reference/authentication.adoc b/src/main/asciidoc/reference/authentication.adoc index 74ec9072..80129900 100644 --- a/src/main/asciidoc/reference/authentication.adoc +++ b/src/main/asciidoc/reference/authentication.adoc @@ -15,7 +15,7 @@ Disclosure of login credentials to any party allows login to Vault and access se are permitted by the underlying role. Picking the appropriate client authentication and injecting credentials into the application is subject to risk evaluation. -Spring's http://docs.spring.io/spring-framework/docs/current/spring-framework-reference/html/beans.html#beans-property-source-abstraction[PropertySource abstraction] is a natural fit +Spring's {spring-framework-docs}core.html#beans-property-source-abstraction[PropertySource abstraction] is a natural fit to keep configuration outside the application code. You can use system properties, environment variables or property files to store login credentials. Each approach comes with its own properties. Keep in mind that the command line and environment properties can be introspected with appropriate diff --git a/src/main/asciidoc/reference/client-support.adoc b/src/main/asciidoc/reference/client-support.adoc index 645d81fd..3fd534e7 100644 --- a/src/main/asciidoc/reference/client-support.adoc +++ b/src/main/asciidoc/reference/client-support.adoc @@ -2,7 +2,7 @@ = Client support Spring Vault supports various HTTP clients to access Vault's HTTP API. Spring Vault uses -http://docs.spring.io/spring/docs/{springVersion}/spring-framework-reference/html/remoting.html#rest-resttemplate[`RestTemplate`] as primary interface accessing Vault. +{spring-framework-docs}integration.html#rest-resttemplate[`RestTemplate`] as primary interface accessing Vault. Dedicated client support originates from <> that is scoped only to Spring Vault's client components. diff --git a/src/main/asciidoc/reference/imperative-template.adoc b/src/main/asciidoc/reference/imperative-template.adoc index 841c878c..fa8a4432 100644 --- a/src/main/asciidoc/reference/imperative-template.adoc +++ b/src/main/asciidoc/reference/imperative-template.adoc @@ -38,7 +38,7 @@ Now let's look at a examples of how to work with Vault in the context of the Spr == Registering and configuring Spring Vault beans Using Spring Vault does not require a Spring Context. However, instances of `VaultTemplate` and `SessionManager` registered inside a managed context will participate -in http://docs.spring.io/spring/docs/current/spring-framework-reference/html/beans.html#beans-factory-nature[lifecycle events] +in {spring-framework-docs}core.html#beans-factory-nature[lifecycle events] provided by the Spring IoC container. This is useful to dispose active Vault sessions upon application shutdown. You also benefit from reusing the same `VaultTemplate` instance across your application. diff --git a/src/main/asciidoc/reference/propertysource.adoc b/src/main/asciidoc/reference/propertysource.adoc index dd7d7cf1..f070718c 100644 --- a/src/main/asciidoc/reference/propertysource.adoc +++ b/src/main/asciidoc/reference/propertysource.adoc @@ -3,7 +3,7 @@ Vault can be used in many different ways. One specific use-case is using Vault to store encrypted properties. Spring Vault supports Vault as property -source to obtain configuration properties using Spring's http://docs.spring.io/spring-framework/docs/current/spring-framework-reference/html/beans.html#beans-property-source-abstraction[PropertySource abstraction]. +source to obtain configuration properties using Spring's {spring-framework-docs}core.html#beans-property-source-abstraction[PropertySource abstraction]. NOTE: You can reference properties stored inside Vault in other property sources or use value injection with `@Value(…)`. Special attention is required when bootstrapping beans that require data stored inside of Vault. A `VaultPropertySource` must be initialized at that time to retrieve properties from Vault. diff --git a/src/main/asciidoc/reference/reactive-template.adoc b/src/main/asciidoc/reference/reactive-template.adoc index 3b42e43c..748cdf2d 100644 --- a/src/main/asciidoc/reference/reactive-template.adoc +++ b/src/main/asciidoc/reference/reactive-template.adoc @@ -58,7 +58,7 @@ Now let's look at a examples of how to work with Vault in the context of the Spr Using Spring Vault does not require a Spring Context. However, instances of `ReactiveVaultTemplate` and `VaultTokenSupplier` registered inside a managed context will participate -in http://docs.spring.io/spring/docs/current/spring-framework-reference/html/beans.html#beans-factory-nature[lifecycle events] +in {spring-framework-docs}core.html#beans-factory-nature[lifecycle events] provided by the Spring IoC container. This is useful to dispose active Vault sessions upon application shutdown. You also benefit from reusing the same `ReactiveVaultTemplate` instance across your application.