ring.util.response
Functions for generating and augmenting response maps.
(charset resp charset)
Returns an updated Ring response with the supplied charset added to the
Content-Type header.
(file-response filepath)
(file-response filepath options)
Returns a Ring response to serve a static file, or nil if an appropriate
file does not exist.
Options:
:root - take the filepath relative to this root path
:index-files? - look for index.* files in directories (defaults to true)
:allow-symlinks? - allow symlinks that lead to paths outside the root path
(defaults to false)
(find-header resp header-name)
Looks up a header in a Ring response (or request) case insensitively,
returning the header map entry, or nil if not present.
(get-header resp header-name)
Looks up a header in a Ring response (or request) case insensitively,
returning the value of the header, or nil if not present.
(redirect-after-post url)
Returns a Ring response for an HTTP 303 redirect. Deprecated in favor
of using redirect with a :see-other status.
(resource-data url)
Returns data about the resource specified by url, or nil if an
appropriate resource does not exist.
The return value is a map with optional values for:
:content - the content of the URL, suitable for use as the :body
of a ring response
:content-length - the length of the :content, nil if not available
:last-modified - the Date the :content was last modified, nil if not
available
This dispatches on the protocol of the URL as a keyword, and
implementations are provided for :file and :jar. If you are on a
platform where (Class/getResource) returns URLs with a different
protocol, you will need to provide an implementation for that
protocol.
This function is used internally by url-response.
(resource-response path)
(resource-response path options)
Returns a Ring response to serve a packaged resource, or nil if the
resource does not exist.
Options:
:root - take the resource relative to this root
:loader - resolve the resource in this class loader
:allow-symlinks? - allow symlinks that lead to paths outside the root
classpath directories (defaults to false)
(response body)
Returns a skeletal Ring response with the given body, status of 200, and no
headers.