org.odpi.openmetadata.commonservices.ffdc

Class RESTExceptionHandler

java.lang.Object

org.odpi.openmetadata.commonservices.ffdc.RESTExceptionHandler

public class RESTExceptionHandler
extends Object

RESTExceptionHandler converts standard exceptions to REST responses. These responses ensure exception objects (with their stack traces) are not serialized over REST APIs. This class does use developer logging (SLF4J) for components that are not mature enough to have implemented FFDC. For mature components, this logging is superfluous.

Constructor Summary

Constructors

Constructor and Description
RESTExceptionHandler() Constructor

Method Summary

Modifier and Type	Method and Description
protected void	captureCheckedException(FFDCResponseBase response, OCFCheckedExceptionBase error, String exceptionClassName) Set the exception information into the response.
protected void	captureCheckedException(FFDCResponseBase response, OCFCheckedExceptionBase error, String exceptionClassName, Map<String,Object> exceptionProperties) Set the exception information into the response.
void	captureInvalidParameterException(FFDCResponseBase response, InvalidParameterException error) Set the exception information into the response.
void	capturePropertyServerException(FFDCResponseBase response, PropertyServerException error) Set the exception information into the response.
void	captureThrowable(FFDCResponseBase response, Throwable error, String methodName) Set the exception information into the response.
void	captureThrowable(FFDCResponseBase response, Throwable error, String methodName, AuditLog auditLog) Set the exception information into the response.
void	captureUserNotAuthorizedException(FFDCResponseBase response, UserNotAuthorizedException error) Set the exception information into the response.
void	detectAndThrowInvalidParameterException(FFDCResponseBase restResult) Throw an InvalidParameterException if it is encoded in the REST response.
void	detectAndThrowInvalidParameterException(String methodName, FFDCResponseBase restResult) Deprecated.
void	detectAndThrowPropertyServerException(FFDCResponseBase restResult) Throw a PropertyServerException if it is encoded in the REST response.
void	detectAndThrowPropertyServerException(String methodName, FFDCResponseBase restResult) Deprecated.
void	detectAndThrowStandardExceptions(String methodName, FFDCResponseBase restResult) Throw an exception if it is encoded in the REST response.
void	detectAndThrowUserNotAuthorizedException(FFDCResponseBase restResult) Throw an UserNotAuthorizedException if it is encoded in the REST response.
void	detectAndThrowUserNotAuthorizedException(String methodName, FFDCResponseBase restResult) Deprecated.
void	handleNoRequestBody(String userId, String methodName, String serverName) Manage an unexpected exception
void	handleUnexpectedException(Throwable error, String methodName, String serverName, String serverURL) Manage an unexpected exception

Methods inherited from class java.lang.Object

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

Constructor Detail

RESTExceptionHandler

public RESTExceptionHandler()

Constructor

Method Detail

handleNoRequestBody

public void handleNoRequestBody(String userId,
                                String methodName,
                                String serverName)
                         throws InvalidParameterException

Manage an unexpected exception

Parameters:

userId - calling user

methodName - method that caught the exception

serverName - name of the server being called

Throws:

InvalidParameterException - exception to report error

detectAndThrowStandardExceptions

public void detectAndThrowStandardExceptions(String methodName,
                                             FFDCResponseBase restResult)
                                      throws InvalidParameterException,
                                             UserNotAuthorizedException,
                                             PropertyServerException

Throw an exception if it is encoded in the REST response.

Parameters:

methodName - name of the method called

restResult - response from the rest call. This generated in the remote server.

Throws:

InvalidParameterException - one of the parameters is invalid.

UserNotAuthorizedException - the user is not authorized to make this request.

PropertyServerException - something went wrong with the REST call stack.

detectAndThrowInvalidParameterException

public void detectAndThrowInvalidParameterException(FFDCResponseBase restResult)
                                             throws InvalidParameterException

Throw an InvalidParameterException if it is encoded in the REST response.

Parameters:

restResult - response from the rest call. This generated in the remote server.

Throws:

InvalidParameterException - encoded exception from the server

detectAndThrowInvalidParameterException

@Deprecated
public void detectAndThrowInvalidParameterException(String methodName,
                                                                FFDCResponseBase restResult)
                                                         throws InvalidParameterException

Deprecated.

Throw an InvalidParameterException if it is encoded in the REST response.

Parameters:

methodName - calling method.

restResult - response from the rest call. This generated in the remote server.

Throws:

InvalidParameterException - encoded exception from the server

detectAndThrowUserNotAuthorizedException

@Deprecated
public void detectAndThrowUserNotAuthorizedException(String methodName,
                                                                 FFDCResponseBase restResult)
                                                          throws UserNotAuthorizedException

Deprecated.

Throw an UserNotAuthorizedException if it is encoded in the REST response.

Parameters:

methodName - calling method.

restResult - response from the rest call. This generated in the remote server.

Throws:

UserNotAuthorizedException - encoded exception from the server

detectAndThrowPropertyServerException

@Deprecated
public void detectAndThrowPropertyServerException(String methodName,
                                                              FFDCResponseBase restResult)
                                                       throws PropertyServerException

Deprecated.

Throw an PropertyServerException if it is encoded in the REST response.

Parameters:

methodName - calling method.

restResult - response from the rest call. This generated in the remote server.

Throws:

PropertyServerException - encoded exception from the server

detectAndThrowPropertyServerException

public void detectAndThrowPropertyServerException(FFDCResponseBase restResult)
                                           throws PropertyServerException

Throw a PropertyServerException if it is encoded in the REST response.

Parameters:

restResult - response from the rest call. This generated in the remote server.

Throws:

PropertyServerException - encoded exception from the server

detectAndThrowUserNotAuthorizedException

public void detectAndThrowUserNotAuthorizedException(FFDCResponseBase restResult)
                                              throws UserNotAuthorizedException

Throw an UserNotAuthorizedException if it is encoded in the REST response.

Parameters:

restResult - response from UserNotAuthorizedException encoded exception from the server.

Throws:

UserNotAuthorizedException - encoded exception from the server

handleUnexpectedException

public void handleUnexpectedException(Throwable error,
                                      String methodName,
                                      String serverName,
                                      String serverURL)
                               throws PropertyServerException

Manage an unexpected exception

Parameters:

error - unexpected exception

methodName - method that caught the exception

serverName - name of the server being called

serverURL - platform URL

Throws:

PropertyServerException - wrapping exception for the caught exception

captureCheckedException

protected void captureCheckedException(FFDCResponseBase response,
                                       OCFCheckedExceptionBase error,
                                       String exceptionClassName)

Set the exception information into the response.

Parameters:

response - REST Response

error - returned response.

exceptionClassName - class name of the exception to recreate

captureCheckedException

protected void captureCheckedException(FFDCResponseBase response,
                                       OCFCheckedExceptionBase error,
                                       String exceptionClassName,
                                       Map<String,Object> exceptionProperties)

Set the exception information into the response.

Parameters:

response - REST Response

error - returned response.

exceptionClassName - class name of the exception to recreate

exceptionProperties - map of properties stored in the exception to help with diagnostics

captureThrowable

public void captureThrowable(FFDCResponseBase response,
                             Throwable error,
                             String methodName)

Set the exception information into the response.

Parameters:

response - REST Response

error - returned response

methodName - calling method

captureThrowable

public void captureThrowable(FFDCResponseBase response,
                             Throwable error,
                             String methodName,
                             AuditLog auditLog)

Set the exception information into the response.

Parameters:

response - REST Response

error - returned response

methodName - calling method

auditLog - log location for recording an unexpected exception

captureInvalidParameterException

public void captureInvalidParameterException(FFDCResponseBase response,
                                             InvalidParameterException error)

Set the exception information into the response.

Parameters:

response - REST Response

error - returned response.

capturePropertyServerException

public void capturePropertyServerException(FFDCResponseBase response,
                                           PropertyServerException error)

Set the exception information into the response.

Parameters:

response - REST Response

error - returned response.

captureUserNotAuthorizedException

public void captureUserNotAuthorizedException(FFDCResponseBase response,
                                              UserNotAuthorizedException error)

Set the exception information into the response.

Parameters:

response - REST Response

error - returned response.