clj-http.core — twosigma/clj-http 3.9.1-ts2

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]
                    :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 conn-timeout conn-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 spnego-auth
                 suppress-connection-close]
          :as req}
         respond
         raise)

request-config clj

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