Package org.eclipse.aether.spi.connector.transport.http.RFC9457

Class RFC9457Reporter<T,E extends Exception,R>

java.lang.Object

org.eclipse.aether.spi.connector.transport.http.RFC9457.RFC9457Reporter<T,E,R>

Type Parameters:

T - The type of the response.

E - The base exception type to throw if the response is not a RFC9457 message.

R - The type of the request or request builder (which allows to modify headers)

public abstract class RFC9457Reporter<T,E extends Exception,R>
extends Object

A reporter for RFC 9457 messages. RFC 9457 is a standard for reporting problems in HTTP responses as a JSON object. There are members specified in the RFC but none of those appear to be required, see rfc9457 section 3.7 Given the JSON fields are not mandatory, this reporter simply extracts the body of the response without validation. A RFC 9457 message is detected by the content type "application/problem+json"<T,E extends Exception,R> in the response header.

See Also:

• RFC 9457

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CONTENT_TYPE_PROBLEM_DETAILS_JSON

Constructor Summary

Constructors

Constructor	Description
RFC9457Reporter()

Method Summary

Modifier and Type	Method	Description
void	generateException(T response, BiConsumerChecked<Integer,String,E> baseException)	Generates a HttpRFC9457Exception if the response type is a RFC 9457 message.
protected abstract String	getBody(T response)
protected abstract String	getReasonPhrase(T response)
protected abstract int	getStatusCode(T response)
protected boolean	hasRFC9457ContentType(String contentType)
protected abstract boolean	isRFC9457Message(T response)
abstract void	prepareRequest(R request)	Prepares the request to accept RFC 9457 responses.

Methods inherited from class java.lang.Object

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

Field Details

CONTENT_TYPE_PROBLEM_DETAILS_JSON

public static final String CONTENT_TYPE_PROBLEM_DETAILS_JSON

See Also:

• Constant Field Values

Constructor Details

RFC9457Reporter

public RFC9457Reporter()

Method Details

isRFC9457Message

protected abstract boolean isRFC9457Message(T response)

getStatusCode

protected abstract int getStatusCode(T response)

getReasonPhrase

protected abstract String getReasonPhrase(T response)

getBody

protected abstract String getBody(T response)
                           throws IOException

Throws:

IOException

prepareRequest

public abstract void prepareRequest(R request)

Prepares the request to accept RFC 9457 responses. This involves setting/updating the "Accept" header to include "application/problem+json".

Parameters:

request - The request or request builder to prepare

See Also:

• RFC 9457 section 3.2

hasRFC9457ContentType

protected boolean hasRFC9457ContentType(String contentType)

generateException

public void generateException(T response,
 BiConsumerChecked<Integer,String,E> baseException)
                       throws E,
HttpRFC9457Exception

Generates a HttpRFC9457Exception if the response type is a RFC 9457 message. Otherwise, it throws the base exception

Parameters:

response - The response to check for RFC 9457 messages.

baseException - The base exception to throw if the response is not a RFC 9457 message.

Throws:

E

HttpRFC9457Exception