controllers

Controller that serves static resources.

Resources are searched in the classpath.

It handles Last-Modified and ETag header automatically. If a gzipped version of a resource is found (Same resource name with the .gz suffix), it is served instead. If a digest file is available for a given asset then its contents are read and used to supply a digest value. This value will be used for serving up ETag values and for the purposes of reverse routing. For example given "a.js", if there is an "a.js.md5" file available then the latter contents will be used to determine the Etag value. The reverse router also uses the digest in order to translate any file to the form <digest>-<asset> for example "a.js" may be also found at "d41d8cd98f00b204e9800998ecf8427e-a.js". If there is no digest file found then digest values for ETags are formed by forming a sha1 digest of the last-modified time.

The default digest algorithm to search for is "md5". You can override this quite easily. For example if the SHA-1 algorithm is preferred:

"play.assets.digest.algorithm" = "sha1"

You can set a custom Cache directive for a particular resource if needed. For example in your application.conf file:

"play.assets.cache./public/images/logo.png" = "max-age=3600"

You can use this controller in any application, just by declaring the appropriate route. For example:

GET     /assets/\uFEFF*file               controllers.Assets.at(path="/public", file)

Can be used to find assets according to configured base path and URL base.

INTERNAL API: Retains metadata for assets that can be readily cached.

A provider for AssetsMetadata that sets up necessary static state for reverse routing. The PathBindable for assets does additional "magic" using statics so routes like routes.Assets.versioned("foo.js") will find the minified and digested version of that asset.

It is also possible to avoid this provider and simply inject AssetsFinder. Then you can call AssetsFinder.path to get the final path of an asset according to the path and url prefix in configuration.

Default actions ready to use as is from your routes file.

Example:

GET   /google          controllers.Default.redirect(to = "http://www.google.com")
GET   /favicon.ico     controllers.Default.notFound
GET   /admin           controllers.Default.todo
GET   /xxx             controllers.Default.error

Default implementation of AssetsMetadata.

If your application uses reverse routing with assets or the Assets static object, you should use the AssetsMetadataProvider to set up needed statics.

Controller that serves static resources from an external folder. It useful in development mode if you want to serve static assets that shouldn't be part of the build process.

Note that this controller IS NOT intended to be used in production mode and can lead to security issues. Therefore it is automatically disabled in production mode.

All assets are served with max-age=3600 cache directive.

You can use this controller in any application, just by declaring the appropriate route. For example:

GET     /assets/\uFEFF*file               controllers.ExternalAssets.at(path="/home/peter/myplayapp/external", file)
GET     /assets/\uFEFF*file               controllers.ExternalAssets.at(path="C:\external", file)
GET     /assets/\uFEFF*file               controllers.ExternalAssets.at(path="relativeToYourApp", file)