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
java.lang.ClassLoader	classLoader() The classloader that all application classes and resources can be loaded from.
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.
play.api.Environment	underlying() The underlying Scala API Environment object that this Environment wraps.

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.

classLoader

public java.lang.ClassLoader classLoader()

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

mode

public Mode mode()

The mode of the application.

isDev

public boolean isDev()

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

isProd

public boolean isProd()

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

isTest

public boolean isTest()

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

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.

underlying

public play.api.Environment underlying()

The underlying Scala API Environment object that this Environment wraps.