配置属性与Enum值在不同的情况下

Question

有一个行为我找不到相关的留档。让我们假设以下代码。它应该在控制台中显示使用foo.bar属性配置的内容：

@SpringBootApplication
@Component
public class Test {
    @Autowired
    TestConfig testConfig;

    public static void main(String[] args) throws Exception {
        ConfigurableApplicationContext run = new SpringApplication(Test.class).run(args);
        Test test = run.getBean(Test.class);
        test.run();
    }

    public void run() throws Exception {
        testConfig.getBar().entrySet().forEach(e -> {
            System.out.println(e.getKey() + " " + e.getValue());
        });
    }

    @Configuration
    @ConfigurationProperties(ignoreUnknownFields = false, prefix = "foo")
    static class TestConfig {
        private Map<SomeEnum, String> bar = new HashMap<>();

        public Map<SomeEnum, String> getBar() {
            return bar;
        }

        public void setBar(Map<SomeEnum, String> bar) {
            this.bar = bar;
        }
    }
}

如果您在application.yml（foo.bar[A_VALUE]： fromapplication.yml）中设置了以下属性，它将被正确地拾取并在控制台中显示“fromapplication.yml”，没什么花哨的

现在，如果您使用完全相同的代码，但这次您想使用命令行参数覆盖application.yml中定义的属性，并将--foo.bar[aValue]="from命令行"设置为命令行arg（请注意，这次我使用骆驼大小写作为枚举引用）。它仍然在控制台中显示"fromapplication.yml"，而不是覆盖的属性。

如果我在命令行中选择大写枚举，在application.yml中选择骆驼大写枚举，它仍然会向控制台显示相同的内容。

这是预期的行为吗？在这种情况下的规则是什么？

根据我的测试，它与https://docs . spring . io/spring-boot/docs/current/reference/html/boot-features-external-config . html # boot-features-external-config中描述的完全相反

我已经用Spring启动 1.2.5.发布和 1.3.0.发布进行了测试

谢谢你的时间

Answer 1

在配置属性中，最后一个获胜：

>

应用程序。yaml（1）

foo.bar.A_VALUE : 111  
foo.bar.aValue  : 222    # output '222', overrieded

应用程序. yaml (2)

foo.bar.aValue  : 222   
foo.bar.A_VALUE : 111    # output '111', overrieded 

因此，当在PropertiesConfigurationFactory#doBindProperties ToTarget（）（我使用的是spring boot 1.5.2）进行调试时，使用：

>

JVM otpions-Dfoo.bar.B_VALUE=b11-Dfoo.bar.cValue=c11

application.yml：

foo.bar:
  A_VALUE: aaa
  B_VALUE: bbb
  C_VALUE: ccc
  D_VALUE: dddd
  dValue: ddd

logging.level:
  org.springframework.boot.env: TRACE
  org.springframework.boot.context.config: DEBUG

propertyValues#propertyValues 这是 LinkedHashMap，具有以下属性键顺序：

// keys are unique, when same key, systemProperties take first.
0. `foo.bar.B_VALUE`  from 'systemProperties'
1. `foo.bar.cValue`   from 'systemProperties'
2. `foo.bar.A_VALUE`  from 'applicationConfig: [classpath:/application.yml]'
3. `foo.bar.C_VALUE`  from 'applicationConfig: [classpath:/application.yml]'
4. `foo.bar.D_VALUE`  from 'applicationConfig: [classpath:/application.yml]'
5. `foo.bar.dValue`   from 'applicationConfig: [classpath:/application.yml]'

控制台输出为：

B_VALUE b11  // systemProperties first 
A_VALUE aaa  
D_VALUE ddd  // the last one wins. (foo.bar.dValue) 
C_VALUE ccc  // ths last one wins. (foo.bar.C_VALUE)

在我的测试中，使用JSON符号:

PropertiesConfigurationFactory#propertySources = {
    class : ConfigurationPropertiesBindingPostProcessor$FlatPropertySources
    propertySources : [ { 
        class : PropertySourcesPlaceholderConfigurer$1
        name  : 'environmentProperties',
        source: {
            class           : StandardServletEnvironment,
            propertySource  : {
                class               : MutablePropertySources,
                propertySourceList  : [{
                    class: PropertySource$StubPropertySource,
                    name : 'servletConfigInitParams'
                }, {
                    class: MapPropertySource,
                    name : 'systemProperties'
                }, {
                    class: SystemEnvironmentPropertySource,
                    name : 'systemEnvironment'
                }, {
                    class: RandomValuePropertySource,
                    name : 'random'
                }, {
                    class: MapPropertySource,
                    name : 'applicationConfig: [classpath:/application.yml]'
                }, {
                    class: MapPropertySource,
                    name : 'refresh'
                }]
            }
        }
    }, {
        class : PropertiesPropertySource,
        name  : 'localProperties',
        source: <Properties>  // empty in my test
    }]
}

注意：类＜code＞PropertiesConfigurationFactory＜/code＞已在spring boot 2.x中删除。

PS：当搜索这个问题时，我想弄清楚Enum值（如A_VALUE）可以写入配置属性中的概念。答案正如@Moit所说。

RelaxedDataBinder#bind()
  RelaxedConversionService#convert()
    1. try DefaultConvertionService#convert()

       # only support `A_VALUE`
       StringToEnumConverterFactory#StringToEnum#convert()

    2. then GenericConversionService#convert()

       # the config key can be :
       # 0 = "a-value"
       # 1 = "a_value"
       # 2 = "aValue"
       # 3 = "avalue"
       # 4 = "A-VALUE"
       # 5 = "A_VALUE"
       # 6 = "AVALUE"
       RelaxedConversionService$StringToEnumIgnoringCaseConverterFactory$StringToEnum#convert() 

Answer 2

Spring使用StringToEnum将字符串值转换为枚举。该类在内部使用java.lang.Enum#valueOf方法进行转换。枚举类创建一个映射，然后在此映射上执行查找。因此，密钥必须与查找成功的确切大小写匹配。

以下测试用例将验证：

enum SomeEnum{
    A, B
}

public class EnumTest {

    public static void main(String[] args) {
        SomeEnum e1 = Enum.valueOf(SomeEnum.class, "A");
        System.out.println(e1);
        SomeEnum e2 = Enum.valueOf(SomeEnum.class, "a"); //throws exception
    }
}

因此，当spring无法转换从命令行传递的值时，它会返回到application.yml中定义的值。

编辑

如果您尝试以下组合：

foo.bar[A_VALUE]: from application.yml
foo.bar[A_VALUE]: from command line
{A_VALUE=from command line}

foo.bar[A_VALUE]: from application.yml
foo.bar[aValue]: from command line
{A_VALUE=from application.yml}

foo.bar[aValue]: from application.yml
foo.bar[A_VALUE]: from command line
{A_VALUE=from application.yml}

foo.bar[aValue]: from application.yml
foo.bar[aValue]: from command line
{A_VALUE=from command line}

第一

第二