24.3. Application属性文件
SpringApplication
将从以下位置加载application.properties
文件,并把它们添加到Spring Environment
中:
- 当前目录下的
/config
子目录。 - 当前目录。
- classpath下的
/config
包。 - classpath根路径(root)。
该列表是按优先级排序的(列表中位置高的路径下定义的属性将覆盖位置低的)。
注 你可以使用YAML(’.yml’)文件替代’.properties’。
如果不喜欢将application.properties
作为配置文件名,你可以通过指定spring.config.name
环境属性来切换其他的名称,也可以使用spring.config.location
环境属性引用一个明确的路径(目录位置或文件路径列表以逗号分割)。
$ java -jar myproject.jar --spring.config.name=myproject
或
$ java -jar myproject.jar --spring.config.location=classpath:/default.properties,classpath:/override.properties
注 在初期需要根据spring.config.name
和spring.config.location
决定加载哪个文件,所以它们必须定义为environment属性(通常为OS env,系统属性或命令行参数)。
如果spring.config.location
包含目录(相对于文件),那它们应该以/
结尾(在被加载前,spring.config.name
关联的名称将被追加到后面,包括profile-specific的文件名)。spring.config.location
下定义的文件使用方法跟往常一样,没有profile-specific变量支持的属性,将被profile-specific的属性覆盖。
不管spring.config.location
配置什么值,默认总会按照classpath:,classpath:/config,file:,file:config/
的顺序进行搜索,优先级由低到高,也就是file:config/
获胜。如果你指定自己的位置,它们会优先于所有的默认位置(locations),并使用相同的由低到高的优先级顺序。那样,你就可以在application.properties
为应用设置默认值,然后在运行的时候使用不同的文件覆盖它,同时保留默认配置。
注 如果使用环境变量而不是系统属性,需要注意多数操作系统的key名称不允许以句号分割(period-separated),但你可以使用下划线(underscores)代替(比如,使用SPRING_CONFIG_NAME
代替spring.config.name
)。
注 如果应用运行在容器中,那么JNDI属性(java:comp/env)或servlet上下文初始化参数可以用来代替环境变量或系统属性,当然也可以使用环境变量或系统属性。