All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.springframework.boot.context.properties.source.SpringIterableConfigurationPropertySource Maven / Gradle / Ivy

There is a newer version: 3.3.3
Show newest version
/*
 * Copyright 2012-2019 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.springframework.boot.context.properties.source;

import java.util.ArrayList;
import java.util.Collections;
import java.util.ConcurrentModificationException;
import java.util.HashSet;
import java.util.Iterator;
import java.util.List;
import java.util.Set;
import java.util.stream.Stream;

import org.springframework.boot.origin.OriginLookup;
import org.springframework.core.env.EnumerablePropertySource;
import org.springframework.core.env.MapPropertySource;
import org.springframework.core.env.PropertySource;
import org.springframework.core.env.StandardEnvironment;
import org.springframework.core.env.SystemEnvironmentPropertySource;
import org.springframework.util.ObjectUtils;

/**
 * {@link ConfigurationPropertySource} backed by an {@link EnumerablePropertySource}.
 * Extends {@link SpringConfigurationPropertySource} with full "relaxed" mapping support.
 * In order to use this adapter the underlying {@link PropertySource} must be fully
 * enumerable. A security restricted {@link SystemEnvironmentPropertySource} cannot be
 * adapted.
 *
 * @author Phillip Webb
 * @author Madhura Bhave
 * @see PropertyMapper
 */
class SpringIterableConfigurationPropertySource extends SpringConfigurationPropertySource
		implements IterableConfigurationPropertySource {

	private volatile Cache cache;

	SpringIterableConfigurationPropertySource(EnumerablePropertySource propertySource, PropertyMapper mapper) {
		super(propertySource, mapper, null);
		assertEnumerablePropertySource();
	}

	private void assertEnumerablePropertySource() {
		if (getPropertySource() instanceof MapPropertySource) {
			try {
				((MapPropertySource) getPropertySource()).getSource().size();
			}
			catch (UnsupportedOperationException ex) {
				throw new IllegalArgumentException("PropertySource must be fully enumerable");
			}
		}
	}

	@Override
	public ConfigurationProperty getConfigurationProperty(ConfigurationPropertyName name) {
		ConfigurationProperty configurationProperty = super.getConfigurationProperty(name);
		if (configurationProperty == null) {
			configurationProperty = find(getPropertyMappings(getCache()), name);
		}
		return configurationProperty;
	}

	@Override
	public Stream stream() {
		return getConfigurationPropertyNames().stream();
	}

	@Override
	public Iterator iterator() {
		return getConfigurationPropertyNames().iterator();
	}

	@Override
	public ConfigurationPropertyState containsDescendantOf(ConfigurationPropertyName name) {
		return ConfigurationPropertyState.search(this, name::isAncestorOf);
	}

	private List getConfigurationPropertyNames() {
		Cache cache = getCache();
		List names = (cache != null) ? cache.getNames() : null;
		if (names != null) {
			return names;
		}
		PropertyMapping[] mappings = getPropertyMappings(cache);
		names = new ArrayList<>(mappings.length);
		for (PropertyMapping mapping : mappings) {
			names.add(mapping.getConfigurationPropertyName());
		}
		names = Collections.unmodifiableList(names);
		if (cache != null) {
			cache.setNames(names);
		}
		return names;
	}

	private PropertyMapping[] getPropertyMappings(Cache cache) {
		PropertyMapping[] result = (cache != null) ? cache.getMappings() : null;
		if (result != null) {
			return result;
		}
		String[] names = getPropertySource().getPropertyNames();
		List mappings = new ArrayList<>(names.length * 2);
		for (String name : names) {
			Collections.addAll(mappings, getMapper().map(name));
		}
		result = mappings.toArray(new PropertyMapping[0]);
		if (cache != null) {
			cache.setMappings(result);
		}
		return result;
	}

	private Cache getCache() {
		CacheKey key = CacheKey.get(getPropertySource());
		if (key == null) {
			return null;
		}
		Cache cache = this.cache;
		try {
			if (cache != null && cache.hasKeyEqualTo(key)) {
				return cache;
			}
			cache = new Cache(key.copy());
			this.cache = cache;
			return cache;
		}
		catch (ConcurrentModificationException ex) {
			// Not fatal at this point, we can continue without a cache
			return null;
		}
	}

	@Override
	protected EnumerablePropertySource getPropertySource() {
		return (EnumerablePropertySource) super.getPropertySource();
	}

	private static class Cache {

		private final CacheKey key;

		private List names;

		private PropertyMapping[] mappings;

		Cache(CacheKey key) {
			this.key = key;
		}

		boolean hasKeyEqualTo(CacheKey key) {
			return this.key.equals(key);
		}

		List getNames() {
			return this.names;
		}

		void setNames(List names) {
			this.names = names;
		}

		PropertyMapping[] getMappings() {
			return this.mappings;
		}

		void setMappings(PropertyMapping[] mappings) {
			this.mappings = mappings;
		}

	}

	private static final class CacheKey {

		private static final CacheKey IMMUTABLE_PROPERTY_SOURCE = new CacheKey(new Object[0]);

		private final Object key;

		private CacheKey(Object key) {
			this.key = key;
		}

		CacheKey copy() {
			if (this == IMMUTABLE_PROPERTY_SOURCE) {
				return IMMUTABLE_PROPERTY_SOURCE;
			}
			return new CacheKey(copyKey(this.key));
		}

		private Object copyKey(Object key) {
			if (key instanceof Set) {
				return new HashSet((Set) key);
			}
			return ((String[]) key).clone();
		}

		@Override
		public boolean equals(Object obj) {
			if (this == obj) {
				return true;
			}
			if (obj == null || getClass() != obj.getClass()) {
				return false;
			}
			CacheKey otherCacheKey = (CacheKey) obj;
			return ObjectUtils.nullSafeEquals(this.key, otherCacheKey.key);
		}

		@Override
		public int hashCode() {
			return this.key.hashCode();
		}

		static CacheKey get(EnumerablePropertySource source) {
			if (isImmutable(source)) {
				return IMMUTABLE_PROPERTY_SOURCE;
			}
			if (source instanceof MapPropertySource) {
				MapPropertySource mapPropertySource = (MapPropertySource) source;
				return new CacheKey(mapPropertySource.getSource().keySet());
			}
			return new CacheKey(source.getPropertyNames());
		}

		private static boolean isImmutable(EnumerablePropertySource source) {
			if (source instanceof OriginLookup) {
				return ((OriginLookup) source).isImmutable();
			}
			if (StandardEnvironment.SYSTEM_ENVIRONMENT_PROPERTY_SOURCE_NAME.equals(source.getName())) {
				return source.getSource() == System.getenv();
			}
			return false;
		}

	}

}