getFromBrowseableDirectory
Signature
def getFromBrowseableDirectory(directory: String)(implicit renderer: DirectoryRenderer, resolver: ContentTypeResolver): Route
Description
The getFromBrowseableDirectories is a combination of serving files from the specified directories (like getFromDirectory) and listing a browseable directory with listDirectoryContents.
Nesting this directive beneath get is not necessary as this directive will only respond to GET requests.
Use getFromBrowseableDirectory to serve only one directory.
Use getFromDirectory if directory browsing isn't required.
For more details refer to getFromBrowseableDirectory.
Example
val route =
path("tmp") {
getFromBrowseableDirectory("/tmp")
}
// tests:
Get("/tmp") ~> route ~> check {
status shouldEqual StatusCodes.OK
}
Default file listing page example
Directives which list directories (e.g. getFromBrowsableDirectory) use an implicit DirectoryRenderer instance to perfm the actual rendering of the file listing. This rendered can be easily overriden by simply providing one in-scope for the directives to use, so you can build your custom directory listings.
The default renderer is akka.http.scaladsl.server.directives.FileAndResourceDirectives.defaultDirectoryRenderer, and renders a listing which looks like this:
Example page rendered by the defaultDirectoryRenderer.
It's possible to turn off rendering the footer stating which version of Akka HTTP is rendering this page by configuring the akka.http.routing.render-vanity-footer configuration option to off.
Contents
