Package dev.reuss.tmdb.core.http

Class JavaNetTmdbHttpClient

java.lang.Object

dev.reuss.tmdb.core.http.JavaNetTmdbHttpClient

All Implemented Interfaces:

TmdbHttpClient

public final class JavaNetTmdbHttpClient
extends Object
implements TmdbHttpClient

TmdbHttpClient implementation based on Java's built-in HttpClient.

This client applies the configured TMDB authentication, builds absolute request URIs from TmdbRequest instances, sends HTTP GET requests and maps successful JSON responses to the requested Java type.

Non-successful HTTP responses are translated into SDK-specific runtime exceptions such as TmdbUnauthorizedException, TmdbNotFoundException, TmdbRateLimitException or TmdbServerException.

Constructor Summary

Constructors

Constructor	Description
JavaNetTmdbHttpClient(TmdbClientConfig config)	Creates a new HTTP client using the given TMDB client configuration.

Method Summary

Modifier and Type	Method	Description
<T> T	get(TmdbRequest request, Class<T> responseType)	Sends a GET request to TMDB and maps the JSON response body to the given type.

Methods inherited from class java.lang.Object

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

Constructor Details

JavaNetTmdbHttpClient

public JavaNetTmdbHttpClient(TmdbClientConfig config)

Creates a new HTTP client using the given TMDB client configuration.

Parameters:

config - the TMDB client configuration

Throws:

NullPointerException - if config is null

Method Details

get

public <T> T get(TmdbRequest request,
 Class<T> responseType)

Sends a GET request to TMDB and maps the JSON response body to the given type.

Specified by:

get in interface TmdbHttpClient

Type Parameters:

T - the expected response type

Parameters:

request - the TMDB request to send

responseType - the expected response type

Returns:

the mapped response body

Throws:

NullPointerException - if request or responseType is null

TmdbUnauthorizedException - if TMDB returns HTTP 401

TmdbNotFoundException - if TMDB returns HTTP 404

TmdbRateLimitException - if TMDB returns HTTP 429

TmdbServerException - if TMDB returns an HTTP 5xx response

TmdbMappingException - if the response body cannot be mapped

TmdbException - for network errors, interruptions or other non-successful responses