Package com.storedobject.common

Class HTTP2

java.lang.Object

com.storedobject.common.HTTP2

public class HTTP2
extends Object

The HTTP2 class facilitates HTTP/2 client-server communication with helper methods and a builder pattern for request customization. It leverages Java's HttpClient for synchronous and asynchronous HTTP calls and provides utilities for handling and parsing responses.

Note: This utility class can transparently handle chunked and compressed (zipped or deflated) content as well.

Features:

• Connection pooling optimization with custom client caching
• Automatic retry mechanism for transient failures
• Configurable debug logging with custom log destinations
• Proper handling of chunked transfer encoding
• Automatic decompression of gzip/deflate responses
• Virtual threads executor for async operations (Java 21+)

     Typical usage:
     String s = HTTP2.build("https://www.google.com").string();
     System.out.println("Google's default page's content is: " + s);

     JSON json = HTTP2.build("https://www.example.com?api=xxx").json(); // Get the JSON content

     // With retry and custom logger
     HTTP2.setLogWriter(new PrintWriter(System.out));
     String data = HTTP2.builder("https://api.example.com/data")
         .retry(3, Duration.ofMillis(500))
         .debug()
         .string();
 

Author:

Syam

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	HTTP2.Builder	This class provides a builder pattern for constructing HTTP requests.

Method Summary

Modifier and Type	Method	Description
static HTTP2.Builder	builder()	Creates a new instance of the Builder class, which provides methods to configure and build an HTTP request.
static HTTP2.Builder	builder(String url)	Creates a new Builder instance initialized with the specified URL.
static boolean	isGlobalDebugEnabled()	Checks if global debug is enabled.
static boolean	isServiceAvailable(String url)	Checks if a service is available with default timeout of 5 seconds.
static boolean	isServiceAvailable(String url, Duration timeout)	Checks if a service is available by sending a HEAD request.
static void	setGlobalDebugEnabled(boolean enabled)	Enables or disables global debug logging.
static void	setLogWriter(LogWriter logWriter)	Sets the global log writer for all HTTP2 debug output.

Methods inherited from class java.lang.Object

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

Method Details

setLogWriter

public static void setLogWriter(LogWriter logWriter)

Sets the global log writer for all HTTP2 debug output.

Parameters:

logWriter - the log writer to use

setGlobalDebugEnabled

public static void setGlobalDebugEnabled(boolean enabled)

Enables or disables global debug logging.

Parameters:

enabled - true to enable debug logging globally

isGlobalDebugEnabled

public static boolean isGlobalDebugEnabled()

Checks if global debug is enabled.

Returns:

true if global debug is enabled, false otherwise

isServiceAvailable

public static boolean isServiceAvailable(String url,
 Duration timeout)

Checks if a service is available by sending a HEAD request.

Parameters:

url - the URL to check

timeout - the timeout for the check

Returns:

true if service responds with 200 OK within the timeout

isServiceAvailable

public static boolean isServiceAvailable(String url)

Checks if a service is available with default timeout of 5 seconds.

Parameters:

url - the URL to check

Returns:

true if service responds with 200 OK within 5 seconds

builder

public static HTTP2.Builder builder()

Creates a new instance of the Builder class, which provides methods to configure and build an HTTP request.

Returns:

a new Builder instance

builder

public static HTTP2.Builder builder(String url)

Creates a new Builder instance initialized with the specified URL.

Parameters:

url - the URL to be set for the builder

Returns:

a new Builder instance with the URL set