clj-http.conn-mgr — clj-http 3.12.1

Utility methods for Scheme registries and HTTP connection managers

*async-connection-manager* clj

connection manager to be rebound during async request execution

*connection-manager* clj

connection manager to be rebound during request execution

get-hostname-verifier clj

(get-hostname-verifier config)

get-keystore clj

(get-keystore keystore & args)

get-keystore* clj

(get-keystore* keystore-file keystore-type keystore-pass)

get-ssl-context clj

(get-ssl-context {:keys [keystore trust-store key-managers trust-managers]
                  :as config})

Gets the SSL Context from a request or connection pool settings

into-registry clj

(into-registry registry)

make-regular-async-conn-manager clj

(make-regular-async-conn-manager
  {:keys [keystore trust-store key-managers trust-managers] :as config})

make-regular-conn-manager clj

(make-regular-conn-manager {:keys [dns-resolver keystore trust-store
                                   key-managers trust-managers socket-timeout]
                            :as config})

make-reusable-async-conn-manager clj

(make-reusable-async-conn-manager opts)

Creates a default pooling async connection manager with the specified options. Handles the same options as make-reusable-conn-manager plus :io-config which should be a map containing some of the following keys:

:connect-timeout - int the default connect timeout value for connection requests (default 0, meaning no timeout) :interest-op-queued - boolean, whether or not I/O interest operations are to be queued and executed asynchronously or to be applied to the underlying SelectionKey immediately (default false) :io-thread-count - int, the number of I/O dispatch threads to be used (default is the number of available processors) :rcv-buf-size - int the default value of the SO_RCVBUF parameter for newly created sockets (default is 0, meaning the system default) :select-interval - long, time interval in milliseconds at which to check for timed out sessions and session requests (default 1000) :shutdown-grace-period - long, grace period in milliseconds to wait for individual worker threads to terminate cleanly (default 500) :snd-buf-size - int, the default value of the SO_SNDBUF parameter for newly created sockets (default is 0, meaning the system default) :so-keep-alive - boolean, the default value of the SO_KEEPALIVE parameter for newly created sockets (default false) :so-linger - int, the default value of the SO_LINGER parameter for newly created sockets (default -1) :so-timeout - int, the default socket timeout value for I/O operations (default 0, meaning no timeout) :tcp-no-delay - boolean, the default value of the TCP_NODELAY parameter for newly created sockets (default true)

If the value 'nil' is specified or the value is not set, the default value will be used.

make-reusable-conn-manager clj

(make-reusable-conn-manager opts)

Creates a default pooling connection manager with the specified options.

The following options are supported:

:timeout - Time that connections are left open before automatically closing default: 5 :threads - Maximum number of threads that will be used for connecting default: 4 :default-per-route - Maximum number of simultaneous connections per host default: 2 :insecure? - Boolean flag to specify allowing insecure HTTPS connections default: false

:keystore - keystore file to be used for connection manager :keystore-pass - keystore password :trust-store - trust store file to be used for connection manager :trust-store-pass - trust store password

:key-managers - KeyManager objects to be used for connection manager :trust-managers - TrustManager objects to be used for connection manager

:dns-resolver - Use a custom DNS resolver instead of the default DNS resolver.

Note that :insecure? and :keystore/:trust-store/:key-managers/:trust-managers options are mutually exclusive

Note that :key-managers/:trust-managers have precedence over :keystore/:trust-store options

If the value 'nil' is specified or the value is not set, the default value will be used.

make-reusable-conn-manager* clj

(make-reusable-conn-manager* {:keys [dns-resolver timeout keystore trust-store
                                     key-managers trust-managers]
                              :as config})

Given an timeout and optional insecure? flag, create a PoolingHttpClientConnectionManager with <timeout> seconds set as the timeout value.

make-reuseable-async-conn-manager clj

(make-reuseable-async-conn-manager opts)

Wraps correctly-spelled version - keeping for backwards compatibility.

make-socks-proxied-conn-manager clj

(make-socks-proxied-conn-manager hostname port)

(make-socks-proxied-conn-manager
  hostname
  port
  {:keys [keystore keystore-type keystore-pass trust-store trust-store-type
          trust-store-pass trust-managers key-managers]
   :as config})

Given an optional hostname and a port, create a connection manager that's proxied using a SOCKS proxy.

PlainGenericSocketFactory clj

(PlainGenericSocketFactory socket-factory)

Given a Function that returns a new socket, create a PlainConnectionSocketFactory that will use that socket.

reusable? clj

(reusable? conn-mgr)

shutdown-manager clj multimethod

Shut down the given connection manager, if it is not nil

socks-proxied-socket clj

(socks-proxied-socket hostname port)

Create a Socket proxied through socks, using the given hostname and port

SSLGenericSocketFactory clj

(SSLGenericSocketFactory socket-factory)

(SSLGenericSocketFactory socket-factory ssl-context)

Given a function that returns a new socket, create an SSLConnectionSocketFactory that will use that socket.