Package com.parallels.jenkins.api.exception

Class PrlApiException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.parallels.jenkins.api.exception.PrlApiException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

PrlApiTimeoutException

public class PrlApiException
extends Exception

Thrown when prl-devops-service returns a non-2xx HTTP response, or when a network-level error occurs while communicating with it.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
PrlApiException(int httpStatus, String message)
PrlApiException(int httpStatus, String message, ApiErrorResponse detail)
PrlApiException(String message)
PrlApiException(String message, Throwable cause)

Method Summary

Modifier and Type	Method	Description
static PrlApiException	fromResponse(int httpStatus, String rawBody, com.fasterxml.jackson.databind.ObjectMapper mapper)	Parses the raw response body as ApiErrorResponse and constructs an exception.
ApiErrorResponse	getDetail()	Structured error detail parsed from the response body, may be null.
int	getHttpStatus()	The HTTP status code returned by the service, or 0 for network errors.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, 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

PrlApiException

public PrlApiException(String message)

PrlApiException

public PrlApiException(int httpStatus,
 String message)

PrlApiException

public PrlApiException(int httpStatus,
 String message,
 ApiErrorResponse detail)

PrlApiException

public PrlApiException(String message,
 Throwable cause)

Method Details

fromResponse

public static PrlApiException fromResponse(int httpStatus,
 String rawBody,
 com.fasterxml.jackson.databind.ObjectMapper mapper)

Parses the raw response body as ApiErrorResponse and constructs an exception. Falls back to a plain message if the body cannot be parsed.

getHttpStatus

public int getHttpStatus()

The HTTP status code returned by the service, or 0 for network errors.

getDetail

public ApiErrorResponse getDetail()

Structured error detail parsed from the response body, may be null.