Package io.a2a.spec

Class A2AClientHTTPError

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.a2a.spec.A2AClientError

io.a2a.spec.A2AClientHTTPError

All Implemented Interfaces:

Serializable

public class A2AClientHTTPError
extends A2AClientError

Client exception indicating an HTTP transport error with a specific status code.

This exception is thrown when HTTP communication with an A2A agent fails, capturing both the HTTP status code and error message. It is used for non-2xx HTTP responses that don't contain valid A2A Protocol error responses.

Common HTTP status codes:

• 4xx - Client errors (400 Bad Request, 401 Unauthorized, 404 Not Found, etc.)
• 5xx - Server errors (500 Internal Server Error, 503 Service Unavailable, etc.)

Usage example:

 if (response.statusCode() >= 400) {
     throw new A2AClientHTTPError(
         response.statusCode(),
         "HTTP error: " + response.statusMessage(),
         response.body()
     );
 }
 

See Also:

• for the base client error class
• HTTP Status Codes
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
A2AClientHTTPError(int code, String message, Object data)	Creates a new HTTP client error with the specified status code and message.

Method Summary

Modifier and Type	Method	Description
int	getCode()	Gets the error code
String	getMessage()	Gets the error message

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Details

A2AClientHTTPError

public A2AClientHTTPError(int code,
 String message,
 Object data)

Creates a new HTTP client error with the specified status code and message.

Parameters:

code - the HTTP status code

message - the error message

data - additional error data (may be the response body)

Throws:

IllegalArgumentException - if code or message is null

Method Details

getCode

public int getCode()

Gets the error code

Returns:

the error code

getMessage

public String getMessage()

Gets the error message

Overrides:

getMessage in class Throwable

Returns:

the error message