Package org.attribyte.api.http.impl.jdk

Class JdkClient

java.lang.Object
org.attribyte.api.http.impl.jdk.JdkClient
All Implemented Interfaces:
AsyncClient, Client
public class JdkClient extends Object implements AsyncClient
HTTP client implementation using the JDK java.net.http.HttpClient.

Requires Java 11+. No external dependencies beyond the JDK and Guava.

  • Constructor Details

    • JdkClient

      public JdkClient()
      Creates an uninitialized client.

    • JdkClient

      public JdkClient(ClientOptions options) throws org.attribyte.api.InitializationException
      Creates a client with specified options.
      Parameters:
      options - The options.
      Throws:
      org.attribyte.api.InitializationException - if options are invalid or other initialization error.

  • Method Details

    • init

      public void init(String prefix, Properties props, org.attribyte.api.Logger logger) throws org.attribyte.api.InitializationException
      Description copied from interface: Client
      Initializes the client. Must be called before first use.
      Specified by:
      init in interface Client
      Parameters:
      prefix - A prefix applied to all property names.
      props - A properties file.
      logger - A logger for messages.
      Throws:
      org.attribyte.api.InitializationException - on initialization error.

    • send

      public Response send(Request request) throws IOException
      Description copied from interface: Client
      Sends a request with default options.
      Specified by:
      send in interface Client
      Parameters:
      request - The request.
      Returns:
      The response.
      Throws:
      IOException - on I/O error.

    • send

      public Response send(Request request, RequestOptions options) throws IOException
      Description copied from interface: Client
      Sends a request with specified options.
      Specified by:
      send in interface Client
      Parameters:
      request - The request.
      options - The request options.
      Returns:
      The response.
      Throws:
      IOException - on I/O error.

    • asyncSend

      public com.google.common.util.concurrent.ListenableFuture<Response> asyncSend(Request request)
      Description copied from interface: AsyncClient
      Sends a request with default options that completes with a ListenableFuture.
      Specified by:
      asyncSend in interface AsyncClient
      Parameters:
      request - The request.
      Returns:
      The (listenable) response future.

    • asyncSend

      public com.google.common.util.concurrent.ListenableFuture<Response> asyncSend(Request request, RequestOptions options)
      Description copied from interface: AsyncClient
      Sends a request with specified options that completes with a ListenableFuture.
      Specified by:
      asyncSend in interface AsyncClient
      Parameters:
      request - The request.
      options - The request options.
      Returns:
      The (listenable) response future.

    • completableSend

      public CompletableFuture<Response> completableSend(Request request)
      Description copied from interface: AsyncClient
      Sends a request with default options that completes with a CompletableFuture.
      Specified by:
      completableSend in interface AsyncClient
      Parameters:
      request - The request.
      Returns:
      The (completable) response future.

    • completableSend

      public CompletableFuture<Response> completableSend(Request request, RequestOptions options)
      Description copied from interface: AsyncClient
      Sends a request with specified options that completes with a CompletableFuture.
      Specified by:
      completableSend in interface AsyncClient
      Parameters:
      request - The request.
      options - The request options.
      Returns:
      The (completable) response future.

    • shutdown

      public void shutdown()
      Description copied from interface: Client
      Releases resources, interrupts threads, etc. Called when application using the client is terminated.
      Specified by:
      shutdown in interface Client