Spring Boot 中的多态配置属性

Polymorphic configuration properties in Spring Boot

我想在 Spring 上使用多态配置属性,使用 Spring 的 @ConfigurationProperties 注释。

假设我们有以下 POJO classes.

public class Base {
  private String sharedProperty;

  public String getSharedProperty() {
    return sharedProperty;
  }

  public String setSharedProperty(String sharedProperty) {
    this.sharedProperty = sharedProperty;
  }
}

public class Foo extends Base {
  private String fooProperty;

  public String getFooProperty() {
    return fooProperty;
  }

  public String setFooProperty(String sharedProperty) {
    this. fooProperty = fooProperty;
  }
}

public class Bar extends Base {
  private String barProperty;

  public String getSharedProperty() {
    return sharedProperty;
  }

  public String setBarProperty(String barProperty) {
    this.barProperty = barProperty;
  }
}

以及配置属性class,

@Component
@ConfigurationProperties(prefix = "playground")
public class SomeConfigurationProperties {
  private List<Base> mixed;

  public List<Base> getMixed() {
    return mixed;
  }

  public void setMixed(List<Base> mixed) {
    this.mixed = mixed;
  }
}

application.yml 文件,

playground:
  mixed:
    - shared-property: "shared prop"
      foo-property: "foo prop"
    - shared-property: "shared prop"
      bar-property: "bar prop"

但是,使用此配置,Spring 使用 Base 对象列表而不是它们的子 class 初始化 @ConfigurationProperties-注释的 class es。也就是说,实际上是预期的行为(出于安全考虑)。

有没有办法强制执行 SnakeYAML 的行为以使用 subclasses,或实施任何类型的自定义反序列化提供程序?

尽管可以实现自定义 PropertySources and/or ConversionService,但不需要自定义反序列化提供程序。

Spring 将相同的属性绑定到多个 bean 没有问题。您的实现不起作用的原因是因为您只在 ApplicationContext 中注册一个 bean,并在基础 class 上使用 @Component 注释。这告诉组件扫描器只有一个 Base 类型的单例。因为 FooBar 没有注册为 beans,所以它们不会被绑定。

如果您考虑制作这些多态性的唯一原因是在基于 SnakeYAML 的配置中共享 属性 名称前缀,那么您实际上不需要引入多态关系,并且可以通过不同 classes.

中的公共字段名称绑定到共享属性

有很多方法可以实现您所要求的,但是以多态方式,这里有一些最直接简单的方法:

自我声明多态 ConfigurationProperties 单例 bean

不是在基础 class 上应用 @ConfigurationProperties@Component 注释,而是在具体的 class 上应用它们,使用相同的 属性名称前缀。这不是我的首选方法,因为每个 bean 都不会以设置它们的属性为条件,但是它可能适合您的需要。根据您的 Spring 配置是否允许重新加载属性,Spring 将维护所有 bean 上的绑定。

注意:从 IntelliJ Idea 2018.3 开始,添加了检查配置文件以将重复的前缀键识别为错误。您可能想忽略它,或禁止显示警告。

我成功测试了以下内容:

Base.java

package sample;

public class Base {
    private String sharedProperty;

    public String getSharedProperty() {
        return sharedProperty;
    }

    public void setSharedProperty(String sharedProperty) {
        this.sharedProperty = sharedProperty;
    }
}

Foo.java

package sample;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties("playground")
public class Foo extends Base {
    private String fooProperty;

    public String getFooProperty() {
        return fooProperty;
    }

    public void setFooProperty(String fooProperty) {
        this.fooProperty = fooProperty;
    }
}

Bar.java

package sample;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties("playground")
public class Bar extends Base {
    private String barProperty;

    public String getBarProperty() {
        return barProperty;
    }

    public void setBarProperty(String barProperty) {
        this.barProperty = barProperty;
    }
}

application.yml

playground:
  shared-property: "shared prop"
  foo-property: "foo prop"
  bar-property: "bar prop"

SampleAppTest.java

package sample;

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.core.env.Environment;

import java.util.List;

import static org.junit.jupiter.api.Assertions.assertEquals;

@SpringBootTest
public class SampleAppTest {

    @Autowired
    public Environment environment;

    @Test
    public void test(@Autowired Bar bar, @Autowired Foo foo) {
        assertEquals("shared prop", bar.getSharedProperty());
        assertEquals("shared prop", foo.getSharedProperty());
        assertEquals("bar prop", bar.getBarProperty());
        assertEquals("foo prop", foo.getFooProperty());
    }

    @Test
    public void testSuper(@Autowired List<Base> props) {
        assertEquals(2, props.size());
    }
}

以属性为条件的多态 ConfigurationProperties bean

如果缺少特定的属性,您可能不希望实例化某些具体实现。此外,您可能不想将 @ConfigurationProperties@Component 注释耦合到每个具体的 class。此实现通过 Spring @Configuration bean 构造 ConfigurationProperties bean。配置 bean 确保它们仅通过 属性 存在检查有条件地构造。如果其他 Base 个 bean 中的 none 满足条件并且共享属性存在,则此实现还会创建一个具体类型 Base 的 bean。此处使用与上一个示例相同的单元测试并通过:

Base.java

package sample;

public class Base {
    private String sharedProperty;

    public String getSharedProperty() {
        return sharedProperty;
    }

    public void setSharedProperty(String sharedProperty) {
        this.sharedProperty = sharedProperty;
    }
}

Foo.java

package sample;

public class Foo extends Base {
    private String fooProperty;

    public String getFooProperty() {
        return fooProperty;
    }

    public void setFooProperty(String fooProperty) {
        this.fooProperty = fooProperty;
    }
}

Bar.java

package sample;

public class Bar extends Base {
    private String barProperty;

    public String getBarProperty() {
        return barProperty;
    }

    public void setBarProperty(String barProperty) {
        this.barProperty = barProperty;
    }
}

SampleConfiguration.java

package sample;

import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class SampleConfiguration {

    @Bean
    @ConfigurationProperties("playground")
    @ConditionalOnProperty("playground.foo-property")
    public Foo foo() {
        return new Foo();
    }

    @Bean
    @ConfigurationProperties("playground")
    @ConditionalOnProperty("playground.bar-property")
    public Bar bar() {
        return new Bar();
    }

    @Bean
    @ConfigurationProperties("playground")
    @ConditionalOnProperty("playground.shared-property")
    @ConditionalOnMissingBean(Base.class)
    public Base base() {
        return new Base();
    }
}

application.yml

playground:
  shared-property: "shared prop"
  foo-property: "foo prop"
  bar-property: "bar prop"

SampleAppTest.java

package sample;

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.core.env.Environment;

import java.util.List;

import static org.junit.jupiter.api.Assertions.assertEquals;

@SpringBootTest
public class SampleAppTest {

    @Autowired
    public Environment environment;

    @Test
    public void test(@Autowired Bar bar, @Autowired Foo foo) {
        assertEquals("shared prop", bar.getSharedProperty());
        assertEquals("shared prop", foo.getSharedProperty());
        assertEquals("bar prop", bar.getBarProperty());
        assertEquals("foo prop", foo.getFooProperty());
    }

    @Test
    public void testSuper(@Autowired List<Base> props) {
        assertEquals(2, props.size());
    }
}