ktor-server-core/io.ktor.server.http.content/StaticContentConfig

StaticContentConfig

class StaticContentConfig<Resource : Any>(source)

A config for serving static content

Functions

fun cacheControl(block: (Resource) -> List<CacheControl>)

Configures CacheControl for requested static content. For files, Resource is a requested File. For resources, Resource is a URL to a requested resource.

contentType

fun contentType(block: (Resource) -> ContentType?)

Configures ContentType for requested static content. If the block returns null, default behaviour of guessing ContentType from the header will be used. For files, Resource is a requested File. For resources, Resource is a URL to a requested resource.

default

fun default(path: String?)

Configures default Resource to respond with, when requested file is not found.

enableAutoHeadResponse

fun enableAutoHeadResponse()

Enables automatic response to a HEAD request for every file/resource that has a GET defined.

etag

fun etag(block: ETagProvider)

Configures HttpHeaders.ETag for requested content. For files, Resource is a requested File. For resources, Resource is a URL to a requested resource.

exclude

fun exclude(block: (Resource) -> Boolean)

Configures resources that should not be served. If this block returns true for Resource, Application will respond with HttpStatusCode.Forbidden. Can be invoked multiple times. For files, Resource is a requested File. For resources, Resource is a URL to a requested resource.

extensions

fun extensions(vararg extensions: String)

Configures file extension fallbacks. When set, if a file is not found, the search will repeat with the given extensions added to the file name. The first match will be served.

fallback

fun fallback(fallback: suspend (String, <Error class: unknown class>) -> Unit)

Configures custom fallback behavior when a requested static resource is not found.

lastModified

fun lastModified(block: (Resource) -> GMTDate?)

Configures HttpHeaders.LastModified for requested static content. For files, Resource is a requested File. For resources, Resource is a URL to a requested resource.

modify

fun modify(block: suspend (Resource, <Error class: unknown class>) -> Unit)

Configures modification of a call for requested content. Useful to add headers to the response, such as HttpHeaders.ETag For files, Resource is a requested File. For resources, Resource is a URL to a requested resource.

preCompressed

fun preCompressed(vararg types: CompressedFileType)

Enables pre-compressed files or resources.