Package io.micronaut.context.env

Class DefaultEnvironment

java.lang.Object
io.micronaut.context.env.PropertySourcePropertyResolver
io.micronaut.context.env.DefaultEnvironment
All Implemented Interfaces:
Environment, LifeCycle<Environment>, io.micronaut.core.convert.ConversionService, io.micronaut.core.convert.MutableConversionService, io.micronaut.core.io.ResourceLoader, io.micronaut.core.value.PropertyResolver, io.micronaut.core.value.ValueResolver<String>, Closeable, AutoCloseable
public class DefaultEnvironment extends PropertySourcePropertyResolver implements Environment

The default implementation of the Environment interface. Configures a named environment.

Since:
1.0

  • Field Details

    • resourceLoader

      protected final io.micronaut.core.io.scan.ClassPathResourceLoader resourceLoader

    • refreshablePropertySources

      protected final List<PropertySource> refreshablePropertySources

    • mutableConversionService

      protected final io.micronaut.core.convert.MutableConversionService mutableConversionService

  • Constructor Details

    • DefaultEnvironment

      public DefaultEnvironment(@NonNull @NonNull ApplicationContextConfiguration configuration)
      Construct a new environment for the given configuration.
      Parameters:
      configuration - The configuration

    • DefaultEnvironment

      public DefaultEnvironment(@NonNull @NonNull ApplicationContextConfiguration configuration, boolean logEnabled)
      Construct a new environment for the given configuration.
      Parameters:
      configuration - The configuration
      logEnabled - flag to enable or disable logger

  • Method Details

    • isPresent

      public boolean isPresent(String className)
      Description copied from interface: Environment
      Check whether the given class is present within this environment.
      Specified by:
      isPresent in interface Environment
      Parameters:
      className - The class name
      Returns:
      True if it is

    • getPlaceholderResolver

      public PropertyPlaceholderResolver getPlaceholderResolver()
      Specified by:
      getPlaceholderResolver in interface Environment
      Returns:
      The placeholder resolver

    • scan

      public Stream<Class<?>> scan(Class<? extends Annotation> annotation)
      Description copied from interface: Environment
      Scan the current environment for classes annotated with the given annotation. Use with care, repeated invocations should be avoided for performance reasons.
      Specified by:
      scan in interface Environment
      Parameters:
      annotation - The annotation to scan
      Returns:
      The classes

    • scan

      public Stream<Class<?>> scan(Class<? extends Annotation> annotation, String... packages)
      Description copied from interface: Environment
      Scan the current environment for classes annotated with the given annotation. Use with care, repeated invocations should be avoided for performance reasons.
      Specified by:
      scan in interface Environment
      Parameters:
      annotation - The annotation to scan
      packages - The packages to scan
      Returns:
      The classes

    • getClassLoader

      public ClassLoader getClassLoader()
      Specified by:
      getClassLoader in interface Environment
      Returns:
      The class loader for the environment

    • isActive

      public boolean isActive(BeanConfiguration configuration)
      Description copied from interface: Environment
      Whether the current environment includes the given configuration.
      Specified by:
      isActive in interface Environment
      Parameters:
      configuration - The configuration
      Returns:
      True if it does

    • addPropertySource

      public DefaultEnvironment addPropertySource(PropertySource propertySource)
      Description copied from class: PropertySourcePropertyResolver
      Add a PropertySource to this resolver.
      Specified by:
      addPropertySource in interface Environment
      Overrides:
      addPropertySource in class PropertySourcePropertyResolver
      Parameters:
      propertySource - The PropertySource to add
      Returns:
      This PropertySourcePropertyResolver

    • removePropertySource

      public Environment removePropertySource(PropertySource propertySource)
      Description copied from interface: Environment
      Removes a property source from this environment.
      Specified by:
      removePropertySource in interface Environment
      Parameters:
      propertySource - The property source
      Returns:
      This environment

    • addPropertySource

      public DefaultEnvironment addPropertySource(String name, Map<String,? super Object> values)
      Description copied from class: PropertySourcePropertyResolver
      Add a property source for the given map.
      Specified by:
      addPropertySource in interface Environment
      Overrides:
      addPropertySource in class PropertySourcePropertyResolver
      Parameters:
      name - The name of the property source
      values - The values
      Returns:
      This environment

    • addPackage

      public Environment addPackage(String pkg)
      Description copied from interface: Environment
      Add an application package. Application packages are candidates for scanning for tools that need it (such as JPA or GORM).
      Specified by:
      addPackage in interface Environment
      Parameters:
      pkg - The package to add
      Returns:
      This environment

    • addConfigurationExcludes

      public Environment addConfigurationExcludes(@Nullable @Nullable String... names)
      Description copied from interface: Environment
      Exclude configurations by name.
      Specified by:
      addConfigurationExcludes in interface Environment
      Parameters:
      names - The names of the configuration
      Returns:
      This environment

    • addConfigurationIncludes

      public Environment addConfigurationIncludes(String... names)
      Description copied from interface: Environment
      Exclude configurations by name.
      Specified by:
      addConfigurationIncludes in interface Environment
      Parameters:
      names - The names of the configuration
      Returns:
      This environment

    • getPackages

      public Collection<String> getPackages()
      Specified by:
      getPackages in interface Environment
      Returns:
      The application packages

    • getActiveNames

      public Set<String> getActiveNames()
      Description copied from interface: Environment
      Should respect the order as provided.
      Specified by:
      getActiveNames in interface Environment
      Returns:
      The active environment names

    • getPropertySources

      public Collection<PropertySource> getPropertySources()
      Specified by:
      getPropertySources in interface Environment
      Returns:
      The active property sources

    • start

      public Environment start()
      Description copied from interface: LifeCycle
      Starts the lifecyle component.
      Specified by:
      start in interface LifeCycle<Environment>
      Returns:
      This lifecycle component

    • isRunning

      public boolean isRunning()
      Specified by:
      isRunning in interface LifeCycle<Environment>
      Returns:
      Whether the component is running

    • stop

      public Environment stop()
      Description copied from interface: LifeCycle
      Stops the life cycle component.
      Specified by:
      stop in interface LifeCycle<Environment>
      Returns:
      This lifecycle component

    • refreshAndDiff

      public Map<String,Object> refreshAndDiff()
      Description copied from interface: Environment
      Refresh the environment from the list of PropertySource instances and return a diff of the changes.
      Specified by:
      refreshAndDiff in interface Environment
      Returns:
      The values that changed

    • convert

      public <T> Optional<T> convert(Object object, Class<T> targetType, io.micronaut.core.convert.ConversionContext context)
      Specified by:
      convert in interface io.micronaut.core.convert.ConversionService

    • convert

      public <S, T> Optional<T> convert(S object, Class<? super S> sourceType, Class<T> targetType, io.micronaut.core.convert.ConversionContext context)
      Specified by:
      convert in interface io.micronaut.core.convert.ConversionService

    • canConvert

      public <S, T> boolean canConvert(Class<S> sourceType, Class<T> targetType)
      Specified by:
      canConvert in interface io.micronaut.core.convert.ConversionService

    • addConverter

      public <S, T> void addConverter(Class<S> sourceType, Class<T> targetType, io.micronaut.core.convert.TypeConverter<S,T> typeConverter)
      Specified by:
      addConverter in interface io.micronaut.core.convert.MutableConversionService

    • addConverter

      public <S, T> void addConverter(Class<S> sourceType, Class<T> targetType, Function<S,T> typeConverter)
      Specified by:
      addConverter in interface io.micronaut.core.convert.MutableConversionService

    • getMutableConversionService

      @Internal public io.micronaut.core.convert.MutableConversionService getMutableConversionService()
      Returns:
      The mutable conversion service.

    • getResourceAsStream

      public Optional<InputStream> getResourceAsStream(String path)
      Specified by:
      getResourceAsStream in interface io.micronaut.core.io.ResourceLoader

    • getResource

      public Optional<URL> getResource(String path)
      Specified by:
      getResource in interface io.micronaut.core.io.ResourceLoader

    • getResources

      public Stream<URL> getResources(String path)
      Specified by:
      getResources in interface io.micronaut.core.io.ResourceLoader

    • supportsPrefix

      public boolean supportsPrefix(String path)
      Specified by:
      supportsPrefix in interface io.micronaut.core.io.ResourceLoader

    • forBase

      public io.micronaut.core.io.ResourceLoader forBase(String basePath)
      Specified by:
      forBase in interface io.micronaut.core.io.ResourceLoader

    • shouldDeduceEnvironments

      protected boolean shouldDeduceEnvironments()
      Returns:
      Whether environment names and packages should be deduced

    • shouldDeduceCloudEnvironment

      protected boolean shouldDeduceCloudEnvironment()
      Returns:
      Whether cloud environment should be deduced based on environment variable, system property or configuration

    • createAnnotationScanner

      protected io.micronaut.core.io.scan.BeanIntrospectionScanner createAnnotationScanner(ClassLoader classLoader)
      Creates the default annotation scanner.
      Parameters:
      classLoader - The class loader
      Returns:
      The scanner

    • getPropertySourceRootName

      protected String getPropertySourceRootName()
      Returns:
      The property source root name

    • readPropertySources

      protected void readPropertySources(String name)
      Parameters:
      name - The name to read property sources

    • getConstantPropertySources

      protected List<PropertySource> getConstantPropertySources()
      Returns:
      Property sources created at build time

    • readPropertySourceListKeyFromEnvironment

      protected String readPropertySourceListKeyFromEnvironment()
      Reads the value of MICRONAUT_CONFIG_FILES environment variable.
      Returns:
      The comma-separated list of files

    • readPropertySourceListFromFiles

      protected List<PropertySource> readPropertySourceListFromFiles(String files)
      Resolve the property sources for files passed via system property and system env.
      Parameters:
      files - The comma separated list of files
      Returns:
      The list of property sources for each file

    • readPropertySourceList

      protected List<PropertySource> readPropertySourceList(String name)
      Parameters:
      name - The name to resolver property sources
      Returns:
      The list of property sources

    • addDefaultPropertySources

      protected void addDefaultPropertySources(List<PropertySource> propertySources)
      Adds default property sources.
      Parameters:
      propertySources - The list of property sources

    • readPropertySourceLoaders

      protected io.micronaut.core.io.service.SoftServiceLoader<PropertySourceLoader> readPropertySourceLoaders()
      Returns:
      Loaded properties as a SoftServiceLoader

    • getPropertySourceLoaders

      public Collection<PropertySourceLoader> getPropertySourceLoaders()
      Obtains the PropertySourceLoader instances.
      Specified by:
      getPropertySourceLoaders in interface Environment
      Returns:
      A collection of PropertySourceLoader

    • close

      public void close()
      Description copied from interface: LifeCycle
      Delegates to LifeCycle.stop().
      Specified by:
      close in interface AutoCloseable
      Specified by:
      close in interface Closeable
      Specified by:
      close in interface LifeCycle<Environment>
      Overrides:
      close in class PropertySourcePropertyResolver