Android SDK Version
  • java.lang.Object
    • com.facebook.FacebookRequestError

public final class FacebookRequestError
extends java.lang.Object
This class represents an error that occurred during a Facebook request.
In general, one would call getCategory() to determine the type of error that occurred, and act accordingly. For more information on error handling, see https://developers.facebook.com/docs/reference/api/errors/
Nested Class Summary
Modifier and TypeClass and Description
static class FacebookRequestError.Category
An enum that represents the Facebook SDK classification for the error that occurred.
Field Summary
Modifier and TypeField and Description
static <any>CREATOR 
static intINVALID_ERROR_CODE
Represents an invalid or unknown error code from the server.
static intINVALID_HTTP_STATUS_CODE
Indicates that there was no valid HTTP status code returned, indicating that either the error occurred locally, before the request was sent, or that something went wrong with the HTTP connection.
Constructor Summary
Constructor and Description
FacebookRequestError(int errorCode, java.lang.String errorType, java.lang.String errorMessage) 
Method Summary
Modifier and TypeMethod and Description
intdescribeContents() 
java.lang.ObjectgetBatchRequestResult()
Returns the full JSON response for the batch request.
FacebookRequestError.CategorygetCategory()
Returns the category in which the error belongs.
java.net.HttpURLConnectiongetConnection()
Returns the HTTP connection that was used to make the request.
intgetErrorCode()
Returns the error code returned from Facebook.
java.lang.StringgetErrorMessage()
Returns the error message returned from Facebook.
java.lang.StringgetErrorRecoveryMessage()
Returns the message that can be displayed to the user before attempting error recovery.
java.lang.StringgetErrorType()
Returns the type of error as a raw string.
java.lang.StringgetErrorUserMessage()
Returns a message suitable for display to the user, describing a user action necessary to enable Facebook functionality.
java.lang.StringgetErrorUserTitle()
Returns a short summary of the error suitable for display to the user.
FacebookExceptiongetException()
Returns the exception associated with this request, if any.
JSONObjectgetRequestResult()
Returns the full JSON response for the corresponding request.
JSONObjectgetRequestResultBody()
Returns the body portion of the response corresponding to the request from Facebook.
intgetRequestStatusCode()
Returns the HTTP status code for this particular request.
intgetSubErrorCode()
Returns the sub-error code returned from Facebook.
java.lang.StringtoString() 
voidwriteToParcel(Parcel out, int flags) 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Field Detail

INVALID_ERROR_CODE

public static final int INVALID_ERROR_CODE
Represents an invalid or unknown error code from the server.

INVALID_HTTP_STATUS_CODE

public static final int INVALID_HTTP_STATUS_CODE
Indicates that there was no valid HTTP status code returned, indicating that either the error occurred locally, before the request was sent, or that something went wrong with the HTTP connection. Check the exception from getException();

CREATOR

public static final <any> CREATOR
Constructor Detail

FacebookRequestError

public FacebookRequestError(int errorCode,
                            java.lang.String errorType,
                            java.lang.String errorMessage)
Method Detail

getCategory

public FacebookRequestError.Category getCategory()
Returns the category in which the error belongs. Applications can use the category to determine how best to handle the errors (e.g. exponential backoff for retries if being throttled).
Returns:
the category in which the error belong

getRequestStatusCode

public int getRequestStatusCode()
Returns the HTTP status code for this particular request.
Returns:
the HTTP status code for the request

getErrorCode

public int getErrorCode()
Returns the error code returned from Facebook.
Returns:
the error code returned from Facebook

getSubErrorCode

public int getSubErrorCode()
Returns the sub-error code returned from Facebook.
Returns:
the sub-error code returned from Facebook

getErrorType

public java.lang.String getErrorType()
Returns the type of error as a raw string. This is generally less useful than using the getCategory() method, but can provide further details on the error.
Returns:
the type of error as a raw string

getErrorMessage

public java.lang.String getErrorMessage()
Returns the error message returned from Facebook.
Returns:
the error message returned from Facebook

getErrorRecoveryMessage

public java.lang.String getErrorRecoveryMessage()
Returns the message that can be displayed to the user before attempting error recovery.
Returns:
the message that can be displayed to the user before attempting error recovery

getErrorUserMessage

public java.lang.String getErrorUserMessage()
Returns a message suitable for display to the user, describing a user action necessary to enable Facebook functionality. Not all Facebook errors yield a message suitable for user display; however in all cases where shouldNotifyUser() returns true, this method returns a non-null message suitable for display.
Returns:
the error message returned from Facebook

getErrorUserTitle

public java.lang.String getErrorUserTitle()
Returns a short summary of the error suitable for display to the user. Not all Facebook errors yield a title/message suitable for user display; however in all cases where getErrorUserTitle() returns valid String - user should be notified.
Returns:
the error message returned from Facebook

getRequestResultBody

public JSONObject getRequestResultBody()
Returns the body portion of the response corresponding to the request from Facebook.
Returns:
the body of the response for the request

getRequestResult

public JSONObject getRequestResult()
Returns the full JSON response for the corresponding request. In a non-batch request, this would be the raw response in the form of a JSON object. In a batch request, this result will contain the body of the response as well as the HTTP headers that pertain to the specific request (in the form of a "headers" JSONArray).
Returns:
the full JSON response for the request

getBatchRequestResult

public java.lang.Object getBatchRequestResult()
Returns the full JSON response for the batch request. If the request was not a batch request, then the result from this method is the same as getRequestResult(). In case of a batch request, the result will be a JSONArray where the elements correspond to the requests in the batch. Callers should check the return type against either JSONObject or JSONArray and cast accordingly.
Returns:
the full JSON response for the batch

getConnection

public java.net.HttpURLConnection getConnection()
Returns the HTTP connection that was used to make the request.
Returns:
the HTTP connection used to make the request

getException

public FacebookException getException()
Returns the exception associated with this request, if any.
Returns:
the exception associated with this request

toString

public java.lang.String toString()
Overrides:
toString in class java.lang.Object

writeToParcel

public void writeToParcel(Parcel out,
                          int flags)

describeContents

public int describeContents()