java-http-clj.core — com.owainlewis/java-http-clj 0.3.0

async-request clj

(async-request req)

(async-request req opts)

(async-request req opts callback)

(async-request req {:keys [as client raw?]} callback ex-handler)

build-request clj

(build-request)

(build-request req-map)

build-uri clj

(build-uri uri query-parameters)

delete clj

(delete url & [req opts])

Like #'request, but sets the :method and :url as appropriate.

delete-async clj

(delete-async url & [req opts callback exception-handler])

Like #'async-request, but sets the :method and :url as appropriate.

fn->java-function clj macro

(fn->java-function f)

Turns a Clojure fn form into a Java function

get clj

(get url & [req opts])

Like #'request, but sets the :method and :url as appropriate.

get-async clj

(get-async url & [req opts callback exception-handler])

Like #'async-request, but sets the :method and :url as appropriate.

head clj

(head url & [req opts])

Like #'request, but sets the :method and :url as appropriate.

head-async clj

(head-async url & [req opts callback exception-handler])

Like #'async-request, but sets the :method and :url as appropriate.

options clj

(options url & [req opts])

Like #'request, but sets the :method and :url as appropriate.

options-async clj

(options-async url & [req opts callback exception-handler])

Like #'async-request, but sets the :method and :url as appropriate.

params->query-string clj

(params->query-string m)

Converts a map of query parameter options into a URL encoded query string that can be added to a URI

patch clj

(patch url & [req opts])

Like #'request, but sets the :method and :url as appropriate.

patch-async clj

(patch-async url & [req opts callback exception-handler])

Like #'async-request, but sets the :method and :url as appropriate.

post clj

(post url & [req opts])

Like #'request, but sets the :method and :url as appropriate.

post-async clj

(post-async url & [req opts callback exception-handler])

Like #'async-request, but sets the :method and :url as appropriate.

put clj

(put url & [req opts])

Like #'request, but sets the :method and :url as appropriate.

put-async clj

(put-async url & [req opts callback exception-handler])

Like #'async-request, but sets the :method and :url as appropriate.

request clj

(request req)

(request req {:keys [as client raw?] :as opts})

Sends a HTTP request and blocks until a response is returned or the request takes longer than the specified timeout. If the request times out, a [HttpTimeoutException] (https://docs.oracle.com/en/java/javase/11/docs/api/java.net.http/java/net/http/HttpTimeoutException.html) is thrown.

The request map takes the following keys:

• :method - HTTP method as a keyword (e.g :get, :put, :post)
• :url - the request url
• :headers - HTTP headers as a map where keys are strings and values are strings or a list of strings
• :body - the request body. Can be a string, a primitive Java byte array or a java.io.InputStream.
• :timeout - the request timeout in milliseconds or a java.time.Duration
• :version - the HTTP protocol version, one of :http1.1 or :http2

The opts param is a map containing one of the following keys:

• :as - converts the response body to one of the following formats:
  • :string - a java.lang.String (default)
  • :byte-array - a Java primitive byte array.
  • :input-stream - a java.io.InputStream.
• :client - the HttpClient to use for the request. If not provided the [[default-client]] will be used.
• :raw? - if true, skip the Ring format conversion and return the raw [HttpResponse](https://docs.oracle.com/en/java/javase/11/docs/api/java.net.http/java/net/http/HttpResponse.html

request-builder clj

(request-builder opts)

response->map clj

(response->map resp)