Environment (micronaut 3.4.0 API)

All Superinterfaces:

AutoCloseable, Closeable, ConversionService<Environment>, LifeCycle<Environment>, PropertyResolver, ResourceLoader, ValueResolver<String>

All Known Implementing Classes:

DefaultEnvironment
```
public interface Environment
extends PropertyResolver, LifeCycle<Environment>, ConversionService<Environment>, ResourceLoader
```
The current application environment. The environment represents the loaded configuration of the application for a current list of active environment names.

The active environment names can be obtained from the getActiveNames() method and are established from one of the following sources:
- Environment names passed to the ApplicationContext.run(String...) method
- The value of the ENVIRONMENTS_PROPERTY system property
- The value of the ENVIRONMENTS_ENV environment variable
- The class that started the application
When establishing the environment name from the class the started the application Micronaut will inspect the stacktrace. If JUnit or Spock are featured in the stacktrace the TEST environment is included. When running from Android the ANDROID environment is included.
Since:

1.0

Author:

Graeme Rocher

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`AMAZON_EC2` Cloud provider amazon ec2.
`static String`	`ANDROID` The android environment.
`static String`	`AZURE` Cloud provider Microsoft Azure.
`static String`	`BARE_METAL` Cloud or non cloud provider on bare metal (unknown).
`static String`	`BOOTSTRAP_CONTEXT_PROPERTY` Whether the bootstrap context is enabled.
`static String`	`BOOTSTRAP_NAME` The default bootstrap config name.
`static String`	`BOOTSTRAP_NAME_PROPERTY` System property to override the default bootstrap name.
`static String`	`CLI` The cli environment.
`static String`	`CLOUD` The cloud environment.
`static String`	`CLOUD_FOUNDRY` Running on Cloud Foundry.
`static String`	`CLOUD_PLATFORM_PROPERTY` The default bootstrap name.
`static String`	`DEDUCE_ENVIRONMENT_ENV` Environment key for whether to deduce environments.
`static String`	`DEDUCE_ENVIRONMENT_PROPERTY` Property for whether to deduce environments.
`static String`	`DEFAULT_NAME` The default application name.
`static String`	`DEVELOPMENT` The development environment.
`static String`	`DIGITAL_OCEAN` Cloud provider Digital Ocean.
`static String`	`ENVIRONMENTS_ENV` The environment key that stores additional environments.
`static String`	`ENVIRONMENTS_PROPERTY` The property that stores additional environments.
`static String`	`FUNCTION` The application is executing as a function.
`static String`	`GAE` Cloud provider for google app engine.
`static String`	`GOOGLE_COMPUTE` Cloud provider google compute instance.
`static String`	`HEROKU` Running on Heroku.
`static String`	`HOSTNAME` The host name environment variable.
`static String`	`IBM` Cloud provider IBM cloud.
`static String`	`KUBERNETES` Running on Kubernetes.
`static String`	`MICRONAUT` Constant for the name micronaut.
`static String`	`ORACLE_CLOUD` Cloud provider Oracle Cloud.
`static String`	`PROPERTY_SOURCES_KEY` The key used to load additional property sources.
`static String`	`TEST` The test environment.

Fields inherited from interface io.micronaut.core.convert.ConversionService
SHARED

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`Environment`	`addConfigurationExcludes(String... names)` Exclude configurations by name.
`Environment`	`addConfigurationIncludes(String... names)` Exclude configurations by name.
`default Environment`	`addPackage(Package pkg)` Add an application package.
`Environment`	`addPackage(String pkg)` Add an application package.
`Environment`	`addPropertySource(PropertySource propertySource)` Adds a property source to this environment.
`default Environment`	`addPropertySource(String name, Map<String,? super Object> values)` Add a property source for the given map.
`Set<String>`	`getActiveNames()` Should respect the order as provided.
`default ClassLoader`	`getClassLoader()`
`Collection<String>`	`getPackages()`
`PropertyPlaceholderResolver`	`getPlaceholderResolver()`
`Collection<PropertySourceLoader>`	`getPropertySourceLoaders()` Obtains the `PropertySourceLoader` instances.
`Collection<PropertySource>`	`getPropertySources()`
`boolean`	`isActive(BeanConfiguration configuration)` Whether the current environment includes the given configuration.
`default boolean`	`isPresent(String className)` Check whether the given class is present within this environment.
`Map<String,Object>`	`refreshAndDiff()` Refresh the environment from the list of `PropertySource` instances and return a diff of the changes.
`Environment`	`removePropertySource(PropertySource propertySource)` Removes a property source from this environment.
`default Stream<Class<?>>`	`scan(Class<? extends Annotation> annotation)` Scan the current environment for classes annotated with the given annotation.
`default Stream<Class<?>>`	`scan(Class<? extends Annotation> annotation, String... packages)` Scan the current environment for classes annotated with the given annotation.

Methods inherited from interface io.micronaut.core.value.PropertyResolver
containsProperties, containsProperty, get, getProperties, getProperties, getProperty, getProperty, getProperty, getProperty, getProperty, getPropertyEntries, getRequiredProperty, nameOf

Methods inherited from interface io.micronaut.core.value.ValueResolver
get, get, get

Methods inherited from interface io.micronaut.context.LifeCycle
close, isRunning, refresh, start, stop

Methods inherited from interface io.micronaut.core.convert.ConversionService
addConverter, addConverter, canConvert, convert, convert, convert, convert, convertRequired, convertRequired

Methods inherited from interface io.micronaut.core.io.ResourceLoader
forBase, getResource, getResourceAsStream, getResources, supportsPrefix

- Field Detail
  - MICRONAUT
```
static final String MICRONAUT
```
    Constant for the name micronaut.
    
    See Also:
    
    Constant Field Values
  - TEST
```
static final String TEST
```
    The test environment.
    
    See Also:
    
    Constant Field Values
  - DEVELOPMENT
```
static final String DEVELOPMENT
```
    The development environment.
    
    See Also:
    
    Constant Field Values
  - ANDROID
```
static final String ANDROID
```
    The android environment.
    
    See Also:
    
    Constant Field Values
  - CLI
```
static final String CLI
```
    The cli environment.
    
    See Also:
    
    Constant Field Values
  - CLOUD
```
static final String CLOUD
```
    The cloud environment.
    
    See Also:
    
    Constant Field Values
  - FUNCTION
```
static final String FUNCTION
```
    The application is executing as a function.
    
    See Also:
    
    Constant Field Values
  - BOOTSTRAP_NAME_PROPERTY
```
static final String BOOTSTRAP_NAME_PROPERTY
```
    System property to override the default bootstrap name.
    
    See Also:
    
    Constant Field Values
  - BOOTSTRAP_CONTEXT_PROPERTY
```
static final String BOOTSTRAP_CONTEXT_PROPERTY
```
    Whether the bootstrap context is enabled.
    
    See Also:
    
    Constant Field Values
  - CLOUD_PLATFORM_PROPERTY
```
static final String CLOUD_PLATFORM_PROPERTY
```
    The default bootstrap name.
    
    See Also:
    
    Constant Field Values
  - ENVIRONMENTS_PROPERTY
```
static final String ENVIRONMENTS_PROPERTY
```
    The property that stores additional environments.
    
    See Also:
    
    Constant Field Values
  - ENVIRONMENTS_ENV
```
static final String ENVIRONMENTS_ENV
```
    The environment key that stores additional environments.
    
    See Also:
    
    Constant Field Values
  - BOOTSTRAP_NAME
```
static final String BOOTSTRAP_NAME
```
    The default bootstrap config name.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_NAME
```
static final String DEFAULT_NAME
```
    The default application name.
    
    See Also:
    
    Constant Field Values
  - GOOGLE_COMPUTE
```
static final String GOOGLE_COMPUTE
```
    Cloud provider google compute instance.
    
    See Also:
    
    Constant Field Values
  - GAE
```
static final String GAE
```
    Cloud provider for google app engine.
    
    See Also:
    
    Constant Field Values
  - AMAZON_EC2
```
static final String AMAZON_EC2
```
    Cloud provider amazon ec2.
    
    See Also:
    
    Constant Field Values
  - AZURE
```
static final String AZURE
```
    Cloud provider Microsoft Azure.
    
    See Also:
    
    Constant Field Values
  - ORACLE_CLOUD
```
static final String ORACLE_CLOUD
```
    Cloud provider Oracle Cloud.
    
    See Also:
    
    Constant Field Values
  - DIGITAL_OCEAN
```
static final String DIGITAL_OCEAN
```
    Cloud provider Digital Ocean.
    
    See Also:
    
    Constant Field Values
  - BARE_METAL
```
static final String BARE_METAL
```
    Cloud or non cloud provider on bare metal (unknown).
    
    See Also:
    
    Constant Field Values
  - IBM
```
static final String IBM
```
    Cloud provider IBM cloud.
    
    See Also:
    
    Constant Field Values
  - KUBERNETES
```
static final String KUBERNETES
```
    Running on Kubernetes.
    
    See Also:
    
    Constant Field Values
  - CLOUD_FOUNDRY
```
static final String CLOUD_FOUNDRY
```
    Running on Cloud Foundry.
    
    See Also:
    
    Constant Field Values
  - HEROKU
```
static final String HEROKU
```
    Running on Heroku.
    
    See Also:
    
    Constant Field Values
  - PROPERTY_SOURCES_KEY
```
static final String PROPERTY_SOURCES_KEY
```
    The key used to load additional property sources.
    
    See Also:
    
    Constant Field Values
  - HOSTNAME
```
static final String HOSTNAME
```
    The host name environment variable.
    
    See Also:
    
    Constant Field Values
  - DEDUCE_ENVIRONMENT_PROPERTY
```
static final String DEDUCE_ENVIRONMENT_PROPERTY
```
    Property for whether to deduce environments.
    
    See Also:
    
    Constant Field Values
  - DEDUCE_ENVIRONMENT_ENV
```
static final String DEDUCE_ENVIRONMENT_ENV
```
    Environment key for whether to deduce environments.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getActiveNames
```
Set<String> getActiveNames()
```
    Should respect the order as provided.
    
    Returns:
    
    The active environment names
  - getPropertySources
```
Collection<PropertySource> getPropertySources()
```
    Returns:
    
    The active property sources
  - addPropertySource
```
Environment addPropertySource(PropertySource propertySource)
```
    Adds a property source to this environment.
    
    Parameters:
    
    propertySource - The property source
    
    Returns:
    
    This environment
  - removePropertySource
```
Environment removePropertySource(PropertySource propertySource)
```
    Removes a property source from this environment.
    
    Parameters:
    
    propertySource - The property source
    
    Returns:
    
    This environment
  - addPackage
```
Environment addPackage(String pkg)
```
    Add an application package. Application packages are candidates for scanning for tools that need it (such as JPA or GORM).
    
    Parameters:
    
    pkg - The package to add
    
    Returns:
    
    This environment
  - addConfigurationExcludes
```
Environment addConfigurationExcludes(String... names)
```
    Exclude configurations by name.
    
    Parameters:
    
    names - The names of the configuration
    
    Returns:
    
    This environment
  - addConfigurationIncludes
```
Environment addConfigurationIncludes(String... names)
```
    Exclude configurations by name.
    
    Parameters:
    
    names - The names of the configuration
    
    Returns:
    
    This environment
  - getPackages
```
Collection<String> getPackages()
```
    Returns:
    
    The application packages
  - getPlaceholderResolver
```
PropertyPlaceholderResolver getPlaceholderResolver()
```
    Returns:
    
    The placeholder resolver
  - refreshAndDiff
```
Map<String,Object> refreshAndDiff()
```
    Refresh the environment from the list of PropertySource instances and return a diff of the changes.
    
    Returns:
    
    The values that changed
  - addPropertySource
```
default Environment addPropertySource(String name,
                                      @Nullable
                                      Map<String,? super Object> values)
```
    Add a property source for the given map.
    
    Parameters:
    
    name - The name
    
    values - The values
    
    Returns:
    
    This environment
  - addPackage
```
default Environment addPackage(Package pkg)
```
    Add an application package. Application packages are candidates for scanning for tools that need it (such as JPA or GORM).
    
    Parameters:
    
    pkg - The package to add
    
    Returns:
    
    This environment
  - scan
```
default Stream<Class<?>> scan(Class<? extends Annotation> annotation)
```
    Scan the current environment for classes annotated with the given annotation. Use with care, repeated invocations should be avoided for performance reasons.
    
    Parameters:
    
    annotation - The annotation to scan
    
    Returns:
    
    The classes
  - scan
```
default Stream<Class<?>> scan(Class<? extends Annotation> annotation,
                              String... packages)
```
    Scan the current environment for classes annotated with the given annotation. Use with care, repeated invocations should be avoided for performance reasons.
    
    Parameters:
    
    annotation - The annotation to scan
    
    packages - The packages to scan
    
    Returns:
    
    The classes
  - getClassLoader
```
default ClassLoader getClassLoader()
```
    Returns:
    
    The class loader for the environment
  - isPresent
```
default boolean isPresent(String className)
```
    Check whether the given class is present within this environment.
    
    Parameters:
    
    className - The class name
    
    Returns:
    
    True if it is
  - isActive
```
boolean isActive(BeanConfiguration configuration)
```
    Whether the current environment includes the given configuration.
    
    Parameters:
    
    configuration - The configuration
    
    Returns:
    
    True if it does
  - getPropertySourceLoaders
```
Collection<PropertySourceLoader> getPropertySourceLoaders()
```
    Obtains the PropertySourceLoader instances.
    
    Returns:
    
    A collection of PropertySourceLoader

Interface Environment

Field Summary

Fields inherited from interface io.micronaut.core.convert.ConversionService

Method Summary

Methods inherited from interface io.micronaut.core.value.PropertyResolver

Methods inherited from interface io.micronaut.core.value.ValueResolver

Methods inherited from interface io.micronaut.context.LifeCycle

Methods inherited from interface io.micronaut.core.convert.ConversionService

Methods inherited from interface io.micronaut.core.io.ResourceLoader

Field Detail

MICRONAUT

TEST

DEVELOPMENT

ANDROID

CLI

CLOUD

FUNCTION

BOOTSTRAP_NAME_PROPERTY

BOOTSTRAP_CONTEXT_PROPERTY

CLOUD_PLATFORM_PROPERTY

ENVIRONMENTS_PROPERTY

ENVIRONMENTS_ENV

BOOTSTRAP_NAME

DEFAULT_NAME

GOOGLE_COMPUTE

GAE

AMAZON_EC2

AZURE

ORACLE_CLOUD

DIGITAL_OCEAN

BARE_METAL

IBM

KUBERNETES

CLOUD_FOUNDRY

HEROKU

PROPERTY_SOURCES_KEY

HOSTNAME

DEDUCE_ENVIRONMENT_PROPERTY

DEDUCE_ENVIRONMENT_ENV

Method Detail

getActiveNames

getPropertySources

addPropertySource

removePropertySource

addPackage

addConfigurationExcludes

addConfigurationIncludes

getPackages

getPlaceholderResolver

refreshAndDiff

addPropertySource

addPackage

scan

scan

getClassLoader

isPresent

isActive

getPropertySourceLoaders