Module seppiko.commons.utils

Package org.seppiko.commons.utils.http

Class HttpClientUtil

java.lang.Object

org.seppiko.commons.utils.http.HttpClientUtil

public class HttpClientUtil
extends Object

Http Client Util with java.net.http

Author:

Leonard Woo

Method Summary

Modifier and Type	Method	Description
protected static <T> HttpResponse.BodyHandler<?>	getBodyHandler(Class<T> type)	Response body checker
protected static <T> HttpRequest.BodyPublisher	getBodyPublisher(T requestBody)	Request body checker
static HttpRequest	getRequest(String url, HttpMethod method, int timeout, HttpHeaders headers, byte[] requestBody)	Get Request object with byte array
static HttpRequest	getRequest(String url, HttpMethod method, int timeout, HttpHeaders headers, InputStream requestBody)	Get Request object with inputstream
static HttpRequest	getRequest(String url, HttpMethod method, int timeout, HttpHeaders headers, String requestBody)	Get Request object with String
protected static HttpRequest	getRequestRaw(URI uri, HttpMethod method, int timeout, String[] headers, HttpRequest.BodyPublisher requestBody)	Get HTTP request raw
static HttpResponse<byte[]>	getResponseByteArray(HttpRequest req, InetSocketAddress proxy)	Get Response with byte array body
static HttpResponse<InputStream>	getResponseInputStream(HttpRequest req, InetSocketAddress proxy)	Get Response with inputstream body
static HttpResponse<String>	getResponseString(HttpRequest req, InetSocketAddress proxy)	Get Response with String body
static <R, T> HttpResponse<T>	sendRequest(String url, HttpMethod method, int timeout, HttpHeaders headers, R requestBody, Class<T> responseType, InetSocketAddress proxy)	send http request

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

getRequest

public static HttpRequest getRequest(String url,
 HttpMethod method,
 int timeout,
 HttpHeaders headers,
 String requestBody)
                              throws URISyntaxException,
IllegalArgumentException,
NullPointerException,
HttpRuntimeException

Get Request object with String

Parameters:

url - URL

method - see HttpMethod

timeout - Timeout

headers - Headers

requestBody - Request body string

Returns:

HttpRequest object

Throws:

URISyntaxException - URL is an illegal address

IllegalArgumentException - something not supported or undefined

NullPointerException - something is null

HttpRuntimeException - Http request process exception

getRequest

public static HttpRequest getRequest(String url,
 HttpMethod method,
 int timeout,
 HttpHeaders headers,
 InputStream requestBody)
                              throws URISyntaxException,
IllegalArgumentException,
NullPointerException,
HttpRuntimeException

Get Request object with inputstream

Parameters:

url - URL

method - see HttpMethod

timeout - Timeout

headers - Headers

requestBody - Request body inputstream

Returns:

HttpRequest object

Throws:

URISyntaxException - URL is an illegal address

IllegalArgumentException - something not supported or undefined

NullPointerException - something is null

HttpRuntimeException - Http request process exception

getRequest

public static HttpRequest getRequest(String url,
 HttpMethod method,
 int timeout,
 HttpHeaders headers,
 byte[] requestBody)
                              throws URISyntaxException,
IllegalArgumentException,
NullPointerException,
HttpRuntimeException

Get Request object with byte array

Parameters:

url - URL

method - see HttpMethod

timeout - Timeout

headers - Headers

requestBody - Request body byte array

Returns:

HttpRequest object

Throws:

URISyntaxException - URL is an illegal address

IllegalArgumentException - something not supported or undefined

NullPointerException - something is null

HttpRuntimeException - Http request process exception

getResponseString

public static HttpResponse<String> getResponseString(HttpRequest req,
 InetSocketAddress proxy)
                                              throws HttpClientException,
HttpInterruptedException

Get Response with String body

Parameters:

req - HttpRequest object

proxy - Http proxy, Not null is enabled proxy

Returns:

HttpResponse object, if NULL has failed

Throws:

HttpClientException - get response exception

HttpInterruptedException - if the operation is interrupted

getResponseByteArray

public static HttpResponse<byte[]> getResponseByteArray(HttpRequest req,
 InetSocketAddress proxy)
                                                 throws HttpClientException,
HttpInterruptedException

Get Response with byte array body

Parameters:

req - HttpRequest object

proxy - Http proxy, Not null is enabled proxy

Returns:

HttpResponse object, if NULL has failed

Throws:

HttpClientException - get response exception

HttpInterruptedException - if the operation is interrupted

getResponseInputStream

public static HttpResponse<InputStream> getResponseInputStream(HttpRequest req,
 InetSocketAddress proxy)
                                                        throws HttpClientException,
HttpInterruptedException

Get Response with inputstream body

Parameters:

req - HttpRequest object

proxy - Http proxy, Not null is enabled proxy

Returns:

HttpResponse object, if NULL has failed

Throws:

HttpClientException - get response exception

HttpInterruptedException - if the operation is interrupted

sendRequest

public static <R,
T> HttpResponse<T> sendRequest(String url,
 HttpMethod method,
 int timeout,
 HttpHeaders headers,
 R requestBody,
 Class<T> responseType,
 InetSocketAddress proxy)
                                         throws URISyntaxException,
HttpClientException,
HttpRuntimeException,
HttpTimeoutException

send http request

Type Parameters:

R - request type (String, InputStream and byte[])

T - response type (String, InputStream and byte[])

Parameters:

url - URL

method - request http method

timeout - request timeout

headers - request headers, if none is null

requestBody - request body, is none is null

responseType - response type, default is byte array

proxy - request http proxy, if had not is null

Returns:

http response

Throws:

URISyntaxException - URL is an illegal address

HttpClientException - get response exception

HttpRuntimeException - http request failed or the operation is interrupted

HttpTimeoutException - http request timeout

getRequestRaw

protected static HttpRequest getRequestRaw(URI uri,
 HttpMethod method,
 int timeout,
 String[] headers,
 HttpRequest.BodyPublisher requestBody)
                                    throws IllegalArgumentException,
IllegalStateException,
HttpTimeoutException

Get HTTP request raw

Parameters:

uri - request uri

method - request method

timeout - request timeout

headers - request headers

requestBody - request body

Returns:

HttpRequest object

Throws:

IllegalArgumentException - URI method or headers is not support or valid

IllegalStateException - if a URI has not been set

HttpTimeoutException - timeout is not valid

getBodyPublisher

protected static <T> HttpRequest.BodyPublisher getBodyPublisher(T requestBody)
                                                         throws UnsupportedOperationException

Request body checker

Type Parameters:

T - body type

Parameters:

requestBody - request body

Returns:

BodyPublisher object

Throws:

UnsupportedOperationException - not found request body class type

getBodyHandler

protected static <T> HttpResponse.BodyHandler<?> getBodyHandler(Class<T> type)

Response body checker

Type Parameters:

T - class type

Parameters:

type - response type

Returns:

BodyHandler type