Skip to content

Commit

Permalink
Describe the ordering of spring.config.location in the documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
wilkinsona committed Jan 20, 2016
1 parent b85b608 commit 5e5542f
Showing 1 changed file with 7 additions and 4 deletions.
11 changes: 7 additions & 4 deletions spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -456,10 +456,13 @@ property (typically OS env, system property or command line argument).
If `spring.config.location` contains directories (as opposed to files) they should end
in `/` (and will be appended with the names generated from `spring.config.name` before
being loaded). The default search path `classpath:,classpath:/config,file:,file:config/`
is always used, irrespective of the value of `spring.config.location`. In that way you
can set up default values for your application in `application.properties` (or whatever
other basename you choose with `spring.config.name`) and override it at runtime with a
different file, keeping the defaults.
is always used, irrespective of the value of `spring.config.location`. This search path
is ordered from lowest to highest precedence (`file:config/` wins). If you do specify
your own locations, they take precedence over all of the default locations and use the
same lowest to highest precedence ordering. In that way you can set up default values for
your application in `application.properties` (or whatever other basename you choose with
`spring.config.name`) and override it at runtime with a different file, keeping the
defaults.

NOTE: If you use environment variables rather than system properties, most operating
systems disallow period-separated key names, but you can use underscores instead (e.g.
Expand Down

0 comments on commit 5e5542f

Please sign in to comment.