Application Configuration
Steeltoe Configuration builds on the .NET configuration API, which enables developers to configure an application with values from a variety of sources by using configuration providers. Each provider supports reading a set of name-value pairs from a given source location and adding them into a combined multi-level configuration dictionary.
Each value contained in the configuration is tied to a string-typed key or name. The values are organized by key into a hierarchical list of name-value pairs in which the components of the keys are separated by a colon (for example, Spring:Application:Name = DemoApp).
.NET supports the following providers and sources:
- Command-line arguments
- File sources (such as JSON, XML, and INI)
- Environment variables
- Custom providers
To better understand .NET configuration services, see the ASP.NET Core documentation. Note that, while the documentation link suggests this service is tied to ASP.NET Core, it is not. It can be used in many different application types, including Console, ASP.NET 4.x., UWP, and others.
Steeltoe adds the following configuration providers to the preceding list:
- Spring Cloud Config Server
- Random value generator
- Placeholder resolvers
- Decryption of encrypted values
- Cloud Foundry (JSON from the
VCAP_APPLICATIONandVCAP_SERVICESenvironment variables) - Spring Boot configuration
The following sections provide more detail about each of these Steeltoe providers.