关于Spring属性处理器PropertyResolver以及应用运行环境Environment的深度分析，强大的StringValueResolver使用和解析【享学Spring】（中）

// @since 3.1
public interface ConfigurableEnvironment extends Environment, ConfigurablePropertyResolver {
  void setActiveProfiles(String... profiles);
  void addActiveProfile(String profile);
  void setDefaultProfiles(String... profiles);
  // 获取到所有的属性源~   MutablePropertySources表示可变的属性源们~~~ 它是一个聚合的  持有List<PropertySource<?>>
  // 这样获取出来后，我们可以add或者remove我们自己自定义的属性源了~
  MutablePropertySources getPropertySources();
  // 这里两个哥们应该非常熟悉了吧~~~
  Map<String, Object> getSystemProperties();
  Map<String, Object> getSystemEnvironment();
  // 合并两个环境配置信息~  此方法唯一实现在AbstractEnvironment上
  void merge(ConfigurableEnvironment parent);
}

public abstract class AbstractEnvironment implements ConfigurableEnvironment {
  public static final String IGNORE_GETENV_PROPERTY_NAME = "spring.getenv.ignore";
  public static final String ACTIVE_PROFILES_PROPERTY_NAME = "spring.profiles.active";
  public static final String DEFAULT_PROFILES_PROPERTY_NAME = "spring.profiles.default";
  // 保留的默认的profile值   protected final属性，证明子类可以访问
  protected static final String RESERVED_DEFAULT_PROFILE_NAME = "default";
  private final Set<String> activeProfiles = new LinkedHashSet<>();
  // 显然这个里面的值 就是default这个profile了~~~~
  private final Set<String> defaultProfiles = new LinkedHashSet<>(getReservedDefaultProfiles());
  // 这个很关键，直接new了一个 MutablePropertySources来管理属性源们
  // 并且是用的PropertySourcesPropertyResolver来处理里面可能的占位符~~~~~
  private final MutablePropertySources propertySources = new MutablePropertySources();
  private final ConfigurablePropertyResolver propertyResolver = new PropertySourcesPropertyResolver(this.propertySources);
  // 唯一构造方法  customizePropertySources是空方法，交由子类去实现，对属性源进行定制~ 
  // Spring对属性配置分出这么多曾经，在SpringBoot中有着极其重要的意义~~~~
  public AbstractEnvironment() {
    customizePropertySources(this.propertySources);
  }
  // 该方法，StandardEnvironment实现类是有复写的~
  protected void customizePropertySources(MutablePropertySources propertySources) {
  }
  // 若你想改变默认default这个值，可以复写此方法~~~~
  protected Set<String> getReservedDefaultProfiles() {
    return Collections.singleton(RESERVED_DEFAULT_PROFILE_NAME);
  }
  //  下面开始实现接口的方法们~~~~~~~
  @Override
  public String[] getActiveProfiles() {
    return StringUtils.toStringArray(doGetActiveProfiles());
  }
  protected Set<String> doGetActiveProfiles() {
    synchronized (this.activeProfiles) {
      if (this.activeProfiles.isEmpty()) { 
        // 若目前是empty的，那就去获取：spring.profiles.active
        String profiles = getProperty(ACTIVE_PROFILES_PROPERTY_NAME);
        if (StringUtils.hasText(profiles)) {
          //支持,分隔表示多个~~~且空格啥的都无所谓
          setActiveProfiles(StringUtils.commaDelimitedListToStringArray(
              StringUtils.trimAllWhitespace(profiles)));
        }
      }
      return this.activeProfiles;
    }
  }
  @Override
  public void setActiveProfiles(String... profiles) {
    synchronized (this.activeProfiles) {
      this.activeProfiles.clear(); // 因为是set方法  所以情况已存在的吧
      for (String profile : profiles) {
         // 简单的valid，不为空且不以!打头~~~~~~~~
        validateProfile(profile);
        this.activeProfiles.add(profile);
      }
    }
  }
  // default profiles逻辑类似，也是不能以!打头~
  @Override
  @Deprecated
  public boolean acceptsProfiles(String... profiles) {
    for (String profile : profiles) {
      // 此处：如果该profile以!开头，那就截断出来  把后半段拿出来看看   它是否在active行列里~~~ 
      // 此处稍微注意：若!表示一个相反的逻辑~~~~~请注意比如!dev表示若dev是active的，我反倒是不生效的
      if (StringUtils.hasLength(profile) && profile.charAt(0) == '!') {
        if (!isProfileActive(profile.substring(1))) {
          return true;
        }
      } else if (isProfileActive(profile)) {
        return true;
      }
    }
    return false;
  }
  // 采用函数式接口处理  就非常的优雅了~
  @Override
  public boolean acceptsProfiles(Profiles profiles) {
    Assert.notNull(profiles, "Profiles must not be null");
    return profiles.matches(this::isProfileActive);
  }
  // 简答的说要么active包含，要门是default  这个profile就被认为是激活的
  protected boolean isProfileActive(String profile) {
    validateProfile(profile);
    Set<String> currentActiveProfiles = doGetActiveProfiles();
    return (currentActiveProfiles.contains(profile) ||
        (currentActiveProfiles.isEmpty() && doGetDefaultProfiles().contains(profile)));
  }
  @Override
  public MutablePropertySources getPropertySources() {
    return this.propertySources;
  }
  public Map<String, Object> getSystemProperties() {
    return (Map) System.getProperties();
  }
  public Map<String, Object> getSystemEnvironment() {
    // 这个判断为：return SpringProperties.getFlag(IGNORE_GETENV_PROPERTY_NAME);
    // 所以我们是可以通过在`spring.properties`这个配置文件里spring.getenv.ignore=false关掉不暴露环境变量的~~~
    if (suppressGetenvAccess()) {
      return Collections.emptyMap();
    }
    return (Map) System.getenv();
  }
  // Append the given parent environment's active profiles, default profiles and property sources to this (child) environment's respective collections of each.
  // 把父环境的属性合并进来~~~~  
  // 在调用ApplicationContext.setParent方法时，会把父容器的环境合并进来  以保证父容器的属性对子容器都是可见的
  @Override
  public void merge(ConfigurableEnvironment parent) {
    for (PropertySource<?> ps : parent.getPropertySources()) {
      if (!this.propertySources.contains(ps.getName())) {
        this.propertySources.addLast(ps); // 父容器的属性都放在最末尾~~~~
      }
    }
    // 合并active
    String[] parentActiveProfiles = parent.getActiveProfiles();
    if (!ObjectUtils.isEmpty(parentActiveProfiles)) {
      synchronized (this.activeProfiles) {
        for (String profile : parentActiveProfiles) {
          this.activeProfiles.add(profile);
        }
      }
    }
    // 合并default
    String[] parentDefaultProfiles = parent.getDefaultProfiles();
    if (!ObjectUtils.isEmpty(parentDefaultProfiles)) {
      synchronized (this.defaultProfiles) {
        this.defaultProfiles.remove(RESERVED_DEFAULT_PROFILE_NAME);
        for (String profile : parentDefaultProfiles) {
          this.defaultProfiles.add(profile);
        }
      }
    }
  }
  // 其余方法全部委托给内置的propertyResolver属性，因为它就是个`PropertyResolver`
  ...
}

public class StandardEnvironment extends AbstractEnvironment {
  // 这两个值定义着  就是在@Value注解要使用它们时的key~~~~~
  /** System environment property source name: {@value}. */
  public static final String SYSTEM_ENVIRONMENT_PROPERTY_SOURCE_NAME = "systemEnvironment";
  /** JVM system properties property source name: {@value}. */
  public static final String SYSTEM_PROPERTIES_PROPERTY_SOURCE_NAME = "systemProperties";
  // 注册MapPropertySource和SystemEnvironmentPropertySource
  // SystemEnvironmentPropertySource是MapPropertySource的子类~~~~
  @Override
  protected void customizePropertySources(MutablePropertySources propertySources) {
    propertySources.addLast(new MapPropertySource(SYSTEM_PROPERTIES_PROPERTY_SOURCE_NAME, getSystemProperties()));
    propertySources.addLast(new SystemEnvironmentPropertySource(SYSTEM_ENVIRONMENT_PROPERTY_SOURCE_NAME, getSystemEnvironment()));
  }
}

public class StandardServletEnvironment extends StandardEnvironment implements ConfigurableWebEnvironment {
  public static final String SERVLET_CONTEXT_PROPERTY_SOURCE_NAME = "servletContextInitParams";
  public static final String SERVLET_CONFIG_PROPERTY_SOURCE_NAME = "servletConfigInitParams";
  public static final String JNDI_PROPERTY_SOURCE_NAME = "jndiProperties";
  // 放置三个web相关的配置源~  StubPropertySource是PropertySource的一个public静态内部类~~~
  @Override
  protected void customizePropertySources(MutablePropertySources propertySources) {
    propertySources.addLast(new StubPropertySource(SERVLET_CONFIG_PROPERTY_SOURCE_NAME));
    propertySources.addLast(new StubPropertySource(SERVLET_CONTEXT_PROPERTY_SOURCE_NAME));
    // 可以通过spring.properties配置文件里面的spring.jndi.ignore=true关闭对jndi的暴露   默认是开启的
    if (JndiLocatorDelegate.isDefaultJndiEnvironmentAvailable()) {
      propertySources.addLast(new JndiPropertySource(JNDI_PROPERTY_SOURCE_NAME));
    }
    super.customizePropertySources(propertySources);
  }
  // 注册servletContextInitParams和servletConfigInitParams到属性配置源头里
  @Override
  public void initPropertySources(@Nullable ServletContext servletContext, @Nullable ServletConfig servletConfig) {
    WebApplicationContextUtils.initServletPropertySources(getPropertySources(), servletContext, servletConfig);
  }
}