io.jooby

Class Environment

java.lang.Object

io.jooby.Environment

public class Environment
extends Object

Application environment contains configuration object and active environment names. The active environment names serve the purpose of allowing loading different configuration files depending on the environment. Also, Extension modules might configure application services differently depending on the environment too. For example: turn on/off caches, reload files, etc. The application.env property controls the active environment names.

Since:

2.0.0

Author:

edgar

Constructor Summary

Constructors

Constructor and Description
Environment(com.typesafe.config.Config conf, List<String> actives) Creates a new environment.
Environment(com.typesafe.config.Config conf, String... actives) Creates a new environment.

Method Summary

Modifier and Type	Method and Description
static com.typesafe.config.Config	defaults() Creates a default configuration properties with some common values like: application.tmpdir, application.charset and pid (process ID).
List<String>	getActiveNames() Active environment names.
com.typesafe.config.Config	getConfig() Application configuration.
boolean	isActive(String name, String... names) Test is the given environment names are active.
static Environment	loadEnvironment(EnvironmentOptions options) This method search for an application.conf file in three location (first-listed are higher priority): ${user.dir}/conf: This is a file system location, useful is you want to externalize configuration (outside of jar file). ${user.dir}: This is a file system location, useful is you want to externalize configuration (outside of jar file) classpath:// (root of classpath).
static String	pid() Find JVM process ID.
static com.typesafe.config.Config	systemEnv() Creates a Config object from System.getenv().
static com.typesafe.config.Config	systemProperties() Creates a Config object from System.getProperties().
String	toString()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Environment

public Environment(@Nonnull
                   com.typesafe.config.Config conf,
                   @Nonnull
                   String... actives)

Creates a new environment.

Parameters:

conf - Application configuration.

actives - Active environment names.

Environment

public Environment(@Nonnull
                   com.typesafe.config.Config conf,
                   @Nonnull
                   List<String> actives)

Creates a new environment.

Parameters:

conf - Application configuration.

actives - Active environment names.

Method Detail

getConfig

@Nonnull
public com.typesafe.config.Config getConfig()

Application configuration.

Returns:

Application configuration.

getActiveNames

@Nonnull
public List<String> getActiveNames()

Active environment names.

Returns:

Active environment names.

isActive

public boolean isActive(String name,
                        String... names)

Test is the given environment names are active.

Parameters:

name - Environment name.

names - Optional environment names.

Returns:

True if any of the given names is active.

toString

public String toString()

Overrides:

toString in class Object

systemProperties

@Nonnull
public static com.typesafe.config.Config systemProperties()

Creates a Config object from System.getProperties().

Returns:

Configuration object.

systemEnv

@Nonnull
public static com.typesafe.config.Config systemEnv()

Creates a Config object from System.getenv().

Returns:

Configuration object.

loadEnvironment

@Nonnull
public static Environment loadEnvironment(@Nonnull
                                                   EnvironmentOptions options)

This method search for an application.conf file in three location (first-listed are higher priority):

• ${user.dir}/conf: This is a file system location, useful is you want to externalize configuration (outside of jar file).
• ${user.dir}: This is a file system location, useful is you want to externalize configuration (outside of jar file)
• classpath:// (root of classpath). No external configuration, configuration file lives inside the jar file

Property overrides is done in the following order (first-listed are higher priority):

• Program arguments
• System properties
• Environment variables
• Environment property file
• Property file

Parameters:

options - Options like basedir, filename, etc.

Returns:

A new environment.

defaults

@Nonnull
public static com.typesafe.config.Config defaults()

Creates a default configuration properties with some common values like: application.tmpdir, application.charset and pid (process ID).

Returns:

A configuration object.

pid

@Nullable
public static String pid()

Find JVM process ID.

Returns:

JVM process ID or null.