Ring middleware providing RFC7240 (Prefer Header for HTTP) support
codox generated documentation can be found here.
The
wrap-prefer
function can be used to wrap a handler with middleware which will check the
incoming request map for Prefer
headers, parse them according to RFC7240,
and add them to the request under the key :prefer
, whose value will be a map
of preference names to preference instances.
Each preference is an instance of the
org.dthume.ring.middleware.prefer/Preference
record type, which defines three
primary keys:
name
: The name of the preference. Required.
value
: The primary value of the preference. Optional.
params
: A map of any secondary parameters specified by the preference. Optional
Note that all values (preference name, value, param names and param values) are strings.
The response map may contain a :prefer
key, whose value may be a single
Preference
instance, a map with Preference
values, or collection of
Preference
instances. These preferences will be used to add
Preference-Applied
headers to the response map.
Copyright (C) 2014 David Thomas Hume.
Distributed under the Eclipse Public License, the same as Clojure.