Package co.ankatech.ankasecure.sdk.exception

Class AnkaSecureSdkException

Object

Throwable

Exception

RuntimeException

AnkaSecureSdkException

All Implemented Interfaces:

Serializable

public class AnkaSecureSdkException
extends RuntimeException

AnkaSecureSdkException is a custom unchecked exception indicating that an error occurred during a call to the Anka Secure SDK. It provides context about the HTTP status code and the raw response body returned by the remote server, enabling deeper inspection and handling by the caller.

Typical Usage Example:

 try {
     // Invoke a method that communicates with the remote Anka Secure API
     sdk.generateSymmetricKey(kid, algorithm, keySize);
 } catch (AnkaSecureSdkException ex) {
     // Access details for troubleshooting or custom handling
     int httpCode = ex.getStatusCode();
     String serverResponse = ex.getResponseBody();

     // Log or re-throw as needed
     log.error("Failed to generate symmetric key. HTTP code={}, response={}",
               httpCode, serverResponse, ex);
     // ...
 }
 

Design & Intent:

• This exception extends RuntimeException, meaning the caller is not forced to handle or declare it, but is free to do so if desired.
• The statusCode and responseBody provide granular information about the HTTP error—key for diagnosing failures or mapping error responses to custom application logic.
• The cause can be an ApiException or another low-level exception thrown by the underlying HTTP client.

Example Scenarios:

1. HTTP 404 (Not Found) when a key kid does not exist.
2. HTTP 401/403 (Unauthorized/Forbidden) for invalid credentials or insufficient privileges.
3. HTTP 500 (Server Error) if the remote service encounters an unexpected issue.

Since:

2025-02-12

Version:

1.0

Author:

AnkaTech SDK Team

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
AnkaSecureSdkException(String message, int statusCode, String responseBody, Throwable cause)	Constructs a new AnkaSecureSdkException with a detailed message, HTTP status code, raw response body, and an optional cause.

Method Summary

Modifier and Type	Method	Description
String	getResponseBody()	Returns the raw response body from the server, which can hold additional diagnostic details about the error.
int	getStatusCode()	Returns the HTTP status code that caused this exception.

Methods inherited from class Throwable

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

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

AnkaSecureSdkException

public AnkaSecureSdkException(String message,
 int statusCode,
 String responseBody,
 Throwable cause)

Constructs a new AnkaSecureSdkException with a detailed message, HTTP status code, raw response body, and an optional cause.

Parameters:

message - a human-readable explanation of the error

statusCode - the HTTP status code returned by the remote server

responseBody - the raw body from the server's error response, if any

cause - the underlying cause of this exception; may be null

Method Details

getStatusCode

public int getStatusCode()

Returns the HTTP status code that caused this exception.

Returns:

the integer status code, such as 400, 404, or 500

getResponseBody

public String getResponseBody()

Returns the raw response body from the server, which can hold additional diagnostic details about the error.

Returns:

the server response body, or null if none was provided