是否可以在自定义 Spring boot starter 中使用默认 application.yml？

Question

I am facing an issue with my custom spring boot starter and a spring boot app consumer that uses as a dependency. I have in both an application.yml but it seems that the configuration I am looking for it is only pressent if it is defined in the consumer.

My config in the starter is like this:

@Getter
@Setter
@Configuration
@ConfigurationProperties(prefix = "security")
public class StarterSecurityConfig {
    private boolean jwtEnabled;
    private String[] unsecuredPaths;
    private String[] securedPaths;
}

And I have this bean defined in the AutoConfiguration class:

@Bean
public StarterSecurityConfig starterSecurityConfig() {
    return new StarterSecurityConfig();
}

It is perfectly retrieved by the consumer which has this application.yml and another variables:

    security:
  jwt-enabled: true
  secured-paths:
    - /user/**
  unsecured-paths:
    - /**

But if I remove that from the consumer and I put it in the application.yml of the starter, the starter beans does not have these properties when creating them.

Maybe am I missing something?

Answer 1

If I understood properly your issue, I have faced such problem just last week ... I was inspecting this issue and I have some findings (they are not supported by official documentation): if you add dependency and want to use its resources, you have a situation when both application.yml files have the same location - classpath:application.yml , and or they cannot be loaded together, or one of them is overridden by other. In any case, in my application, it did not work.

The straight and simple solution if you just need to load configuration from dependent config file - rename it and load in a possible way (manual loading from YAML, property source's initializer, etc.)

But if this config file should be used anywhere, we can load properties manually in the context. In a dependency (consumer in your case) create another configuration file, eg consumer-application.yml and next bean in @configuration class:

@Bean
public static PropertySourcesPlaceholderConfigurer properties() {
    var propertySourcesPlaceholderConfigurer = new PropertySourcesPlaceholderConfigurer();
    var yamlPropertiesFactoryBean = new YamlPropertiesFactoryBean();
    yamlPropertiesFactoryBean.setResources(new ClassPathResource("consumer-application.yaml"));
    propertySourcesPlaceholderConfigurer.setProperties(yamlPropertiesFactoryBean.getObject());
    return propertySourcesPlaceholderConfigurer;
}

And you can use properties from YAML-file in both applications with @Value.

But the simplest way - to use properties configs. In that case, you can just set @PropertySource("classpath:consumer-application.properties") in consumer and @PropertySource(value = {"classpath:application.properties", "classpath:consumer-application.properties"}) In my case both variants work correctly.

Answer 2

You can try initializing the member variables on the starter itself. If consumer wants to override the values they can do it with they're application configuration.

@Getter
@Setter
@Configuration
@ConfigurationProperties(prefix = "security")
public class StarterSecurityConfig {
    private boolean jwtEnabled = true;
    private String[] unsecuredPaths = { "/user/**" };
    private String[] securedPaths = { "/**" };
}

Fews more ideas:

I would make jwtEnabled as false and would remove the @Configuration and @ConfigurationProperties from the above Class and create an SecurityAutoConfiguration Class with other beans.

@Configuration
public class SecurityAutoConfiguration{

   @Bean
   @ConfigurationProperties(prefix = "security")
   public StarterSecurityConfig starterSecurityConfig(){
     return new StarterSecurityConfig();
   }

   @Bean
   @ConditionalOnProperty(value="security.jwtEnabled", havingValue = "true")
   public JwtService jwtService(StarterSecurityConfig starterSecurityConfig) {
     return new JwtService(starterSecurityConfig);
   }   

}

the consumers will be able to enable or disable the security-starter with their application configuration using security.jwtEnabled flag.