clj-http.core — clj-http 3.12.2

Core HTTP request/response implementation. Rewrite for Apache 4.3

*cookie-store* clj

add-retry-handler clj

(add-retry-handler builder handler)

build-async-http-client clj

(build-async-http-client {:keys [request-interceptor response-interceptor
                                 proxy-host proxy-port async-http-builder-fns]
                          :as req}
                         conn-mgr
                         &
                         [http-url proxy-ignore-hosts])

Builds an Apache HttpAsyncClient from a clj-http request map. Optional arguments http-url and proxy-ignore-hosts are used to specify the host and a list of hostnames to ignore for any proxy settings. They can be safely ignored if not using proxies.

build-cache-config clj

(build-cache-config request)

Given a request with :cache-config as a map or a CacheConfig object, return a CacheConfig object, or nil if no cache config is found. If :cache-config is a map, it checks for the following options:

• :allow-303-caching
• :asynchronous-worker-idle-lifetime-secs
• :asynchronous-workers-core
• :asynchronous-workers-max
• :heuristic-caching-enabled
• :heuristic-coefficient
• :heuristic-default-lifetime
• :max-cache-entries
• :max-object-size
• :max-update-retries
• :never-cache-http10-responses-with-query-string
• :revalidation-queue-size
• :shared-cache
• :weak-etag-on-put-delete-allowed

build-http-client clj

(build-http-client {:keys [retry-handler request-interceptor
                           response-interceptor proxy-host proxy-port
                           http-builder-fns cookie-spec cookie-policy-registry
                           http-client-builder]
                    :as req}
                   caching?
                   conn-mgr
                   &
                   [http-url proxy-ignore-hosts])

Builds an Apache HttpClient from a clj-http request map. Optional arguments http-url and proxy-ignore-hosts are used to specify the host and a list of hostnames to ignore for any proxy settings. They can be safely ignored if not using proxies.

create-custom-cookie-policy-registry clj

(create-custom-cookie-policy-registry cookie-spec-fn)

Given a function that will take an HttpContext and return a CookieSpec, create a new Registry for the cookie policy under the CUSTOM_COOKIE_POLICY string.

credentials-provider clj

(credentials-provider)

CUSTOM_COOKIE_POLICY clj

default-redirect-strategy clj

(default-redirect-strategy original req)

Proxies calls to whatever original redirect strategy is passed in, however, if :validate-redirects is set in the request, checks that the redirected host is not empty.

get-cookie-policy clj multimethod

Method to retrieve the cookie policy that should be used for the request. This is a multimethod that may be extended to return your own cookie policy. Dispatches based on the :cookie-policy key in the request map.

get-redirect-strategy clj

(get-redirect-strategy {:keys [redirect-strategy] :as req})

get-route-planner clj

(get-route-planner proxy-host proxy-port proxy-ignore-hosts http-url)

Return an HttpRoutePlanner that either use the supplied proxy settings if any, or the JVM/system proxy settings otherwise

graceful-redirect-strategy clj

(graceful-redirect-strategy req)

Similar to the default redirect strategy, however, does not throw an error when the maximum number of redirects has been reached. Still supports validating that the new redirect host is not empty.

http-context clj

(http-context caching? request-config http-client-context)

http-get clj

(http-get)

http-request-for clj

(http-request-for request-method http-url body)

Provides the HttpRequest object for a particular request-method and url

make-proxy-method clj

(make-proxy-method method url)

make-proxy-method-with-body clj

(make-proxy-method-with-body method)

parse-headers clj

(parse-headers headers & [use-header-maps-in-response?])

Takes a HeaderIterator and returns a map of names to values.

If a name appears more than once (like set-cookie) then the value will be a vector containing the values in the order they appeared in the headers.

proxy-copy-with-body clj

proxy-delete-with-body clj

proxy-get-with-body clj

proxy-move-with-body clj

proxy-patch-with-body clj

request clj

(request req)

(request {:keys [body connection-timeout connection-request-timeout
                 connection-manager cookie-store cookie-policy headers multipart
                 query-string redirect-strategy max-redirects retry-handler
                 request-method scheme server-name server-port socket-timeout
                 uri response-interceptor proxy-host proxy-port
                 http-client-context http-request-config http-client
                 proxy-ignore-hosts proxy-user proxy-pass digest-auth ntlm-auth
                 multipart-mode multipart-charset conn-timeout
                 conn-request-timeout]
          :as req}
         respond
         raise)

request-config clj

(request-config {:keys [connection-timeout connection-request-timeout
                        socket-timeout max-redirects cookie-spec normalize-uri
                        conn-request-timeout conn-timeout]
                 :as req})