Package com.restfb.exception

Class FacebookException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.restfb.exception.FacebookException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

FacebookErrorMessageException, FacebookJsonMappingException, FacebookLoggerException, FacebookNetworkException, FacebookPreconditionException, FacebookResponseContentException, FacebookSignedRequestParsingException, FacebookSignedRequestVerificationException

public abstract class FacebookException
extends RuntimeException

Root of the RestFB exception hierarchy.

Author:

Mark Allen, Norbert Bartels

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	FacebookException.InfoData	Aggregates optional metadata that may help diagnose a failing Facebook request.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	FacebookException(String message)	Creates an exception with the given message.
protected	FacebookException(String message, Throwable cause)	Creates an exception with the given message and cause.

Method Summary

Modifier and Type	Method	Description
String	getBasicMessage()
Optional<FacebookException.InfoData>	getInfoData()	Request metadata associated with this exception, if available.
String	getMessage()
FacebookException	withInfoData(FacebookException.InfoData infoData)	Adds optional request metadata to the exception for diagnostics.
FacebookException	withInfoData(String httpMethod, String fullEndpoint, String parameterString, String headerAccessToken, Long startTime)	Convenience helper to attach request metadata.

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

FacebookException

protected FacebookException(String message)

Creates an exception with the given message.

Parameters:

message - A message describing this exception.

FacebookException

protected FacebookException(String message,
 Throwable cause)

Creates an exception with the given message and cause.

Parameters:

message - A message describing this exception.

cause - The exception that caused this exception to be thrown.

Method Details

withInfoData

public FacebookException withInfoData(FacebookException.InfoData infoData)

Adds optional request metadata to the exception for diagnostics.

Parameters:

infoData - encapsulated request metadata (may be null)

Returns:

this exception for fluent usage.

withInfoData

public FacebookException withInfoData(String httpMethod,
 String fullEndpoint,
 String parameterString,
 String headerAccessToken,
 Long startTime)

Convenience helper to attach request metadata.

Returns:

this exception for fluent usage.

getMessage

public String getMessage()

Overrides:

getMessage in class Throwable

getBasicMessage

public String getBasicMessage()

getInfoData

public Optional<FacebookException.InfoData> getInfoData()

Request metadata associated with this exception, if available.

Returns:

optional request metadata