play

Class Environment

java.lang.Object

play.Environment

@Singleton
public class Environment
extends java.lang.Object

The environment for the application.

Captures concerns relating to the classloader and the filesystem for the application.

Constructor Summary

Constructors

Constructor and Description
Environment(play.api.Environment environment)
Environment(java.io.File rootPath)
Environment(java.io.File rootPath, java.lang.ClassLoader classLoader, Mode mode)
Environment(java.io.File rootPath, Mode mode)
Environment(Mode mode)

Method Summary

Modifier and Type	Method and Description
play.api.Environment	asScala() The underlying Scala API Environment object that this Environment wraps.
java.lang.ClassLoader	classLoader() The classloader that all application classes and resources can be loaded from.
java.util.Optional<java.io.File>	getExistingFile(java.lang.String relativePath) Retrieves a file relative to the application root path.
java.io.File	getFile(java.lang.String relativePath) Retrieves a file relative to the application root path.
boolean	isDev() Returns `true` if the application is `DEV` mode.
boolean	isProd() Returns `true` if the application is `PROD` mode.
boolean	isTest() Returns `true` if the application is `TEST` mode.
Mode	mode() The mode of the application.
java.net.URL	resource(java.lang.String relativePath) Retrieves a resource from the classpath.
java.io.InputStream	resourceAsStream(java.lang.String relativePath) Retrieves a resource stream from the classpath.
java.io.File	rootPath() The root path that the application is deployed at.
static Environment	simple() A simple environment.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Environment

@Inject
public Environment(play.api.Environment environment)

Environment

public Environment(java.io.File rootPath,
                   java.lang.ClassLoader classLoader,
                   Mode mode)

Environment

public Environment(java.io.File rootPath,
                   Mode mode)

Environment

public Environment(java.io.File rootPath)

Environment

public Environment(Mode mode)

Method Detail

rootPath

public java.io.File rootPath()

The root path that the application is deployed at.

Returns:

the path

classLoader

public java.lang.ClassLoader classLoader()

The classloader that all application classes and resources can be loaded from.

Returns:

the class loader

mode

public Mode mode()

The mode of the application.

Returns:

the mode

isDev

public boolean isDev()

Returns `true` if the application is `DEV` mode.

Returns:

`true` if the application is `DEV` mode.

isProd

public boolean isProd()

Returns `true` if the application is `PROD` mode.

Returns:

`true` if the application is `PROD` mode.

isTest

public boolean isTest()

Returns `true` if the application is `TEST` mode.

Returns:

`true` if the application is `TEST` mode.

getFile

public java.io.File getFile(java.lang.String relativePath)

Retrieves a file relative to the application root path.

Parameters:

relativePath - relative path of the file to fetch

Returns:

a file instance - it is not guaranteed that the file exists

getExistingFile

public java.util.Optional<java.io.File> getExistingFile(java.lang.String relativePath)

Retrieves a file relative to the application root path. This method returns an Optional, using empty if the file was not found.

Parameters:

relativePath - relative path of the file to fetch

Returns:

an existing file

resource

public java.net.URL resource(java.lang.String relativePath)

Retrieves a resource from the classpath.

Parameters:

relativePath - relative path of the resource to fetch

Returns:

URL to the resource (may be null)

resourceAsStream

public java.io.InputStream resourceAsStream(java.lang.String relativePath)

Retrieves a resource stream from the classpath.

Parameters:

relativePath - relative path of the resource to fetch

Returns:

InputStream to the resource (may be null)

simple

public static Environment simple()

A simple environment.

Uses the same classloader that the environment classloader is defined in, the current working directory as the path and test mode.

Returns:

the environment

asScala

public play.api.Environment asScala()

The underlying Scala API Environment object that this Environment wraps.

Returns:

the environment

See Also:

Environment