play.api

Configuration

Related Docs: object Configuration | package api

case class Configuration(underlying: Config) extends Product with Serializable

A full configuration set.

The underlying implementation is provided by https://github.com/typesafehub/config.

underlying

the underlying Config implementation

Source
Configuration.scala
Linear Supertypes
Serializable, Serializable, Product, Equals, AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. Configuration
  2. Serializable
  3. Serializable
  4. Product
  5. Equals
  6. AnyRef
  7. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Instance Constructors

  1. new Configuration(underlying: Config)

    underlying

    the underlying Config implementation

Value Members

  1. final def !=(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Definition Classes
    AnyRef → Any
  3. def ++(other: Configuration): Configuration

    Merge 2 configurations.

  4. final def ==(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  5. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  6. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  7. def entrySet: Set[(String, ConfigValue)]

    Returns every path as a set of key to value pairs, by recursively iterating through the config objects.

  8. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  9. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  10. def getBoolean(path: String): Option[Boolean]

    Retrieves a configuration value as a Boolean.

    Retrieves a configuration value as a Boolean.

    For example:

    val configuration = Configuration.load()
    val isEnabled = configuration.getBoolean("engine.isEnabled")

    A configuration error will be thrown if the configuration value is not a valid Boolean. Authorized vales are yes/no or true/false.

    path

    the configuration key, relative to the configuration root key

    returns

    a configuration value

  11. def getBooleanList(path: String): Option[List[Boolean]]

    Retrieves a configuration value as a List of Boolean.

    Retrieves a configuration value as a List of Boolean.

    For example:

    val configuration = Configuration.load()
    val switches = configuration.getBooleanList("board.switches")

    The configuration must be provided as:

    board.switches = [true, true, false]

    A configuration error will be thrown if the configuration value is not a valid Boolean. Authorized vales are yes/no or true/false.

  12. def getBooleanSeq(path: String): Option[Seq[Boolean]]

    Retrieves a configuration value as a Seq of Boolean.

    Retrieves a configuration value as a Seq of Boolean.

    For example:

    val configuration = Configuration.load()
    val switches = configuration.getBooleanSeq("board.switches")

    The configuration must be provided as:

    board.switches = [true, true, false]

    A configuration error will be thrown if the configuration value is not a valid Boolean. Authorized vales are yes/no or true/false.

  13. def getBytes(path: String): Option[Long]

    Retrieves a configuration value as Bytes.

    Retrieves a configuration value as Bytes.

    For example:

    val configuration = Configuration.load()
    val maxSize = configuration.getString("engine.maxSize")

    The configuration must be provided as:

    engine.maxSize = 512k
  14. def getBytesList(path: String): Option[List[Long]]

    Retrieves a configuration value as a List of Bytes.

    Retrieves a configuration value as a List of Bytes.

    For example:

    val configuration = Configuration.load()
    val maxSizes = configuration.getBytesList("engine.maxSizes")

    The configuration must be provided as:

    engine.maxSizes = [512k, 256k, 256k]
  15. def getBytesSeq(path: String): Option[Seq[Long]]

    Retrieves a configuration value as a Seq of Bytes.

    Retrieves a configuration value as a Seq of Bytes.

    For example:

    val configuration = Configuration.load()
    val maxSizes = configuration.getBytesSeq("engine.maxSizes")

    The configuration must be provided as:

    engine.maxSizes = [512k, 256k, 256k]
  16. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  17. def getConfig(path: String): Option[Configuration]

    Retrieves a sub-configuration, i.e.

    Retrieves a sub-configuration, i.e. a configuration instance containing all keys starting with a given prefix.

    For example:

    val configuration = Configuration.load()
    val engineConfig = configuration.getConfig("engine")

    The root key of this new configuration will be ‘engine’, and you can access any sub-keys relatively.

    path

    the root prefix for this sub-configuration

    returns

    a new configuration

  18. def getConfigList(path: String): Option[List[Configuration]]

    Retrieves a List of sub-configurations, i.e.

    Retrieves a List of sub-configurations, i.e. a configuration instance for each key that matches the path.

    For example:

    val configuration = Configuration.load()
    val engineConfigs = configuration.getConfigList("engine")

    The root key of this new configuration will be "engine", and you can access any sub-keys relatively.

  19. def getConfigSeq(path: String): Option[Seq[Configuration]]

    Retrieves a Seq of sub-configurations, i.e.

    Retrieves a Seq of sub-configurations, i.e. a configuration instance for each key that matches the path.

    For example:

    val configuration = Configuration.load()
    val engineConfigs = configuration.getConfigSeq("engine")

    The root key of this new configuration will be "engine", and you can access any sub-keys relatively.

  20. def getDouble(path: String): Option[Double]

    Retrieves a configuration value as a Double.

    Retrieves a configuration value as a Double.

    For example:

    val configuration = Configuration.load()
    val population = configuration.getDouble("world.population")

    A configuration error will be thrown if the configuration value is not a valid Double.

    path

    the configuration key, relative to the configuration root key

    returns

    a configuration value

  21. def getDoubleList(path: String): Option[List[Double]]

    Retrieves a configuration value as a List of Double.

    Retrieves a configuration value as a List of Double.

    For example:

    val configuration = Configuration.load()
    val maxSizes = configuration.getDoubleList("engine.maxSizes")

    The configuration must be provided as:

    engine.maxSizes = [5.0, 3.34, 2.6]
  22. def getDoubleSeq(path: String): Option[Seq[Double]]

    Retrieves a configuration value as a Seq of Double.

    Retrieves a configuration value as a Seq of Double.

    For example:

    val configuration = Configuration.load()
    val maxSizes = configuration.getDoubleSeq("engine.maxSizes")

    The configuration must be provided as:

    engine.maxSizes = [5.0, 3.34, 2.6]
  23. def getInt(path: String): Option[Int]

    Retrieves a configuration value as an Int.

    Retrieves a configuration value as an Int.

    For example:

    val configuration = Configuration.load()
    val poolSize = configuration.getInt("engine.pool.size")

    A configuration error will be thrown if the configuration value is not a valid Int.

    path

    the configuration key, relative to the configuration root key

    returns

    a configuration value

  24. def getIntList(path: String): Option[List[Integer]]

    Retrieves a configuration value as a List of Integer.

    Retrieves a configuration value as a List of Integer.

    For example:

    val configuration = Configuration.load()
    val maxSizes = configuration.getIntList("engine.maxSizes")

    The configuration must be provided as:

    engine.maxSizes = [100, 500, 2]
  25. def getIntSeq(path: String): Option[Seq[Integer]]

    Retrieves a configuration value as a Seq of Integer.

    Retrieves a configuration value as a Seq of Integer.

    For example:

    val configuration = Configuration.load()
    val maxSizes = configuration.getIntSeq("engine.maxSizes")

    The configuration must be provided as:

    engine.maxSizes = [100, 500, 2]
  26. def getList(path: String): Option[ConfigList]

    Gets a list value (with any element type) as a ConfigList, which implements java.util.List<ConfigValue>.

    Gets a list value (with any element type) as a ConfigList, which implements java.util.List<ConfigValue>.

    For example:

    val configuration = Configuration.load()
    val maxSizes = configuration.getList("engine.maxSizes")

    The configuration must be provided as:

    engine.maxSizes = ["foo", "bar"]
  27. def getLong(path: String): Option[Long]

    Retrieves a configuration value as a Long.

    Retrieves a configuration value as a Long.

    For example:

    val configuration = Configuration.load()
    val duration = configuration.getLong("timeout.duration")

    A configuration error will be thrown if the configuration value is not a valid Long.

    path

    the configuration key, relative to the configuration root key

    returns

    a configuration value

  28. def getLongList(path: String): Option[List[Long]]

    Retrieves a configuration value as a List of Long.

    Retrieves a configuration value as a List of Long.

    For example:

    val configuration = Configuration.load()
    val maxSizes = configuration.getLongList("engine.maxSizes")

    The configuration must be provided as:

    engine.maxSizes = [10000000000000, 500, 2000]
  29. def getLongSeq(path: String): Option[Seq[Long]]

    Retrieves a configuration value as a Seq of Long.

    Retrieves a configuration value as a Seq of Long.

    For example:

    val configuration = Configuration.load()
    val maxSizes = configuration.getLongSeq("engine.maxSizes")

    The configuration must be provided as:

    engine.maxSizes = [10000000000000, 500, 2000]
  30. def getMilliseconds(path: String): Option[Long]

    Retrieves a configuration value as Milliseconds.

    Retrieves a configuration value as Milliseconds.

    For example:

    val configuration = Configuration.load()
    val timeout = configuration.getMilliseconds("engine.timeout")

    The configuration must be provided as:

    engine.timeout = 1 second
  31. def getMillisecondsList(path: String): Option[List[Long]]

    Retrieves a configuration value as List of Milliseconds.

    Retrieves a configuration value as List of Milliseconds.

    For example:

    val configuration = Configuration.load()
    val timeouts = configuration.getMillisecondsList("engine.timeouts")

    The configuration must be provided as:

    engine.timeouts = [1 second, 1 second]
  32. def getMillisecondsSeq(path: String): Option[Seq[Long]]

    Retrieves a configuration value as Seq of Milliseconds.

    Retrieves a configuration value as Seq of Milliseconds.

    For example:

    val configuration = Configuration.load()
    val timeouts = configuration.getMillisecondsSeq("engine.timeouts")

    The configuration must be provided as:

    engine.timeouts = [1 second, 1 second]
  33. def getNanoseconds(path: String): Option[Long]

    Retrieves a configuration value as Nanoseconds.

    Retrieves a configuration value as Nanoseconds.

    For example:

    val configuration = Configuration.load()
    val timeout = configuration.getNanoseconds("engine.timeout")

    The configuration must be provided as:

    engine.timeout = 1 second
  34. def getNanosecondsList(path: String): Option[List[Long]]

    Retrieves a configuration value as List of Nanoseconds.

    Retrieves a configuration value as List of Nanoseconds.

    For example:

    val configuration = Configuration.load()
    val timeouts = configuration.getNanosecondsList("engine.timeouts")

    The configuration must be provided as:

    engine.timeouts = [1 second, 1 second]
  35. def getNanosecondsSeq(path: String): Option[Seq[Long]]

    Retrieves a configuration value as Seq of Nanoseconds.

    Retrieves a configuration value as Seq of Nanoseconds.

    For example:

    val configuration = Configuration.load()
    val timeouts = configuration.getNanosecondsSeq("engine.timeouts")

    The configuration must be provided as:

    engine.timeouts = [1 second, 1 second]
  36. def getNumber(path: String): Option[Number]

    Retrieves a configuration value as a Number.

    Retrieves a configuration value as a Number.

    For example:

    val configuration = Configuration.load()
    val counter = configuration.getNumber("foo.counter")

    A configuration error will be thrown if the configuration value is not a valid Number.

    path

    the configuration key, relative to the configuration root key

    returns

    a configuration value

  37. def getNumberList(path: String): Option[List[Number]]

    Retrieves a configuration value as a List of Number.

    Retrieves a configuration value as a List of Number.

    For example:

    val configuration = Configuration.load()
    val maxSizes = configuration.getNumberList("engine.maxSizes")

    The configuration must be provided as:

    engine.maxSizes = [50, 500, 5000]
  38. def getNumberSeq(path: String): Option[Seq[Number]]

    Retrieves a configuration value as a Seq of Number.

    Retrieves a configuration value as a Seq of Number.

    For example:

    val configuration = Configuration.load()
    val maxSizes = configuration.getNumberSeq("engine.maxSizes")

    The configuration must be provided as:

    engine.maxSizes = [50, 500, 5000]
  39. def getObject(path: String): Option[ConfigObject]

    Retrieves a ConfigObject for this path, which implements Map<String,ConfigValue>

    Retrieves a ConfigObject for this path, which implements Map<String,ConfigValue>

    For example:

    val configuration = Configuration.load()
    val engineProperties = configuration.getObject("engine.properties")

    The configuration must be provided as:

    engine.properties = {id: 1, power: 5}
  40. def getObjectList(path: String): Option[List[_ <: ConfigObject]]

    Retrieves a configuration value as a List of ConfigObject.

    Retrieves a configuration value as a List of ConfigObject.

    For example:

    val configuration = Configuration.load()
    val engineProperties = configuration.getObjectList("engine.properties")

    The configuration must be provided as:

    engine.properties = [{id: 5, power: 3}, {id: 6, power: 20}]
  41. def getString(path: String, validValues: Option[Set[String]] = None): Option[String]

    Retrieves a configuration value as a String.

    Retrieves a configuration value as a String.

    This method supports an optional set of valid values:

    val config = Configuration.load()
    val mode = config.getString("engine.mode", Some(Set("dev","prod")))

    A configuration error will be thrown if the configuration value does not match any of the required values.

    path

    the configuration key, relative to configuration root key

    validValues

    valid values for this configuration

    returns

    a configuration value

  42. def getStringList(path: String): Option[List[String]]

    Retrieves a configuration value as a List of String.

    Retrieves a configuration value as a List of String.

    For example:

    val configuration = Configuration.load()
    val names = configuration.getStringList("names")

    The configuration must be provided as:

    names = ["Jim", "Bob", "Steve"]
  43. def getStringSeq(path: String): Option[Seq[String]]

    Retrieves a configuration value as a Seq of String.

    Retrieves a configuration value as a Seq of String.

    For example:

    val configuration = Configuration.load()
    val names = configuration.getStringSeq("names")

    The configuration must be provided as:

    names = ["Jim", "Bob", "Steve"]
  44. def globalError(message: String, e: Option[Throwable] = None): PlayException

    Creates a configuration error for this configuration.

    Creates a configuration error for this configuration.

    For example:

    val configuration = Configuration.load()
    throw configuration.globalError("Missing configuration key: [yop.url]")
    message

    the error message

    e

    the related exception

    returns

    a configuration exception

  45. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any
  46. def keys: Set[String]

    Returns available keys.

    Returns available keys.

    For example:

    val configuration = Configuration.load()
    val keys = configuration.keys
    returns

    the set of keys available in this configuration

  47. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  48. final def notify(): Unit

    Definition Classes
    AnyRef
  49. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  50. def reportError(path: String, message: String, e: Option[Throwable] = None): PlayException

    Creates a configuration error for a specific configuration key.

    Creates a configuration error for a specific configuration key.

    For example:

    val configuration = Configuration.load()
    throw configuration.reportError("engine.connectionUrl", "Cannot connect!")
    path

    the configuration key, related to this error

    message

    the error message

    e

    the related exception

    returns

    a configuration exception

  51. def subKeys: Set[String]

    Returns sub-keys.

    Returns sub-keys.

    For example:

    val configuration = Configuration.load()
    val subKeys = configuration.subKeys
    returns

    the set of direct sub-keys available in this configuration

  52. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  53. val underlying: Config

    the underlying Config implementation

  54. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  55. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  56. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from Serializable

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from AnyRef

Inherited from Any

Ungrouped