Spring boot how to read properties file outside jar

Question

in my target folder, there are 2 folders, lib and conf. all the properties files are placed in conf folder, and jars are placed in lib foulder.

previous to spring boot, we use following configuration in spring.xml to use @value

<context:property-placeholder location="classpath*:*.properties"/>

and in java code like:

@Value("${name}")

private String name;

but in spring boot, i don't know how to do the same in java code.

i have tried following, but not work

@Configuration
@PropertySource(value = "classpath:aaa.properties")
public class AppConfig {
    @Bean
    public PropertySourcesPlaceholderConfigurer propertySourcesPlaceholderConfigurer() {
    return new PropertySourcesPlaceholderConfigurer();
    }
}

score 47 · Accepted Answer · answered Jan 20 '17 at 03:18

47

I'm a bit confused by the title of the question and the description. Hopefully I won't confuse you even more with my comments.

In general, Spring Boot is VERY opiniated about project structure as well as the binary created. The recomended way (Spring Boot opinion) is to build a jar with all dependencies inside (fat jar). If you need configuration properties defined outside your fat jar (or war if that's what you built), Spring Boot offers many options (see reference 1). I like my apps to point to an external file using the flag (spring.config.location) which can be set with a system property:

java -jar -Dspring.config.location=<path-to-file> myBootProject.jar

Notice that you can do something similar by using an environment variable to define where your external file lives.

I hope this helps!

References: 1. https://docs.spring.io/spring-boot/docs/current/reference/html/boot-features-external-config.html

answered Jan 20 '17 at 03:18

Alberto

801
6
10

1

Thanks, this offer great value – Benjamin Liu Jan 21 '17 at 00:47
1

Do you know if i have multiply properties files, how to read it in separate config class? – Benjamin Liu Jan 21 '17 at 04:03
2

Are you referring to multiple external files? – Alberto Jan 21 '17 at 11:40
yes, such as a file for db settings, a file for redis settings and other files for other settings. we want to split different settings. – Benjamin Liu Jan 22 '17 at 08:50
Can you show how to use environment variable in order to define configuration location? – milosdju Jun 07 '18 at 14:32
It doesn't work for me. My configuration is `@PropertySource(value = {"classpath:config/springConfig.properties"})` . It only works when I compile it to jar. – Xiaokun Sep 27 '20 at 03:57

score 20 · Answer 2 · answered Jun 08 '17 at 18:09

I am not sure if you are dealing with the same situation than me, but in my case I have a jar and a *.properties file outside of it. What I did to get the *.properties file located outside the jar was the next:

@Configuration
public class ApplicationContext {

  @Bean
  public PropertySourcesPlaceholderConfigurer propertySourcesPlaceholderConfigurer() {
    PropertySourcesPlaceholderConfigurer properties = new PropertySourcesPlaceholderConfigurer();
    properties.setLocation(new FileSystemResource("application.properties"));
    properties.setIgnoreResourceNotFound(false);

    return properties;
  }
}

When I am setting the location of the application.properties file I created FileSystemResource object, which allow me get the properties.files which is located next to the jar. If your .properties files are in classpath, for example, you can use other classes (like ClassPathResource). You can read other classes that spring offers to get a Resource object under the package org.springframework.core.io. .

I hope this comments helps.

This appears to be a more versatile solution. If you want to set multiple locations using `setLocations` method instead. — SashikaXP, Aug 03 '17 at 05:07

score 14 · Answer 3 · answered Aug 22 '17 at 05:49

As mentioned in the Spring Boot docs,

SpringApplication will load properties from application.properties files in the following locations and add them to the Spring Environment:

A /config subdirectory of the current directory.

The current directory

A classpath /config package

The classpath root

The list is ordered by precedence (properties defined in locations higher in the list override those defined in lower locations).

One way is to simply rename your 'conf' directory to 'config' and it will work without a problem. So there is no need to do extra configuration until and unless you want your properties file at some location other than the 4 mentioned above.

In that case you can define the property source explicitly.

@PropertySource("classpath:config.properties")

and for multiple properties file

@PropertySources({
    @PropertySource("classpath:config.properties"),
    @PropertySource("classpath:logging.properties"),
    @PropertySource(value="classpath:missing.properties", ignoreResourceNotFound=true)
})

score 6 · Answer 4 · answered Jan 20 '17 at 02:20

Found an solution:

first create a class and add @ConfigurationProperties

@ConfigurationProperties(prefix = "asdf", locations = "file:conf/aaa.properties")
public class ASDF {
    private String name;   

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

Please noted in locations, i use file, not classpath.

then in your application class, add @EnableConfigurationProperties

@SpringBootApplication
@EnableConfigurationProperties({ASDF.class, BBB.class})
public class InitialBeanTestApplication {

    public static void main(String[] args) {
        SpringApplication.run(InitialBeanTestApplication.class, args);
    }
}

then you can read config file in the conf folder

the location in @ConfigurationProperties(prefix = "asdf", locations = "file:conf/aaa.properties") can be defined in application-{profile}.yml files. and change to locations = "${configFilePath}". And for dev its value can be classpath:*.properties, for prod its value canbe file:*.properties. — Benjamin Liu, Jun 11 '19 at 01:18

score 2 · Answer 5 · answered Jan 21 '17 at 04:49

Found another solution.

put every configuration in one application.properties files, and in code use @Value("${name}") to read.

and use a assembly file to copy the resource folders' file into target config folder.

and after deploy, just need to change application.properties file in config folder and the run the application.

this because spring boot read application.properties file in follow sequence.

• The /config subdirectory located in the current directory

• The current directory

• A classpath /config package

• The classpath root

but this works for one properties file. not for multiply properties files

score 1 · Answer 6 · answered Jun 09 '19 at 09:51

Actually, the most easiest way is to put application.properties and your.jar into the same directory, and just java -jar your.jar will automatically load this external config file.

And if you are trying to load some context/files from resource folder via ClassPathResource, when you read the file don't use pathResource.getFile(), instead use pathResource.getInputStream(), getFile() works well within your IDE, however it doesn't work with the standalone jar.

Spring boot how to read properties file outside jar

6 Answers6

Linked