-
Notifications
You must be signed in to change notification settings - Fork 3.5k
/
FBErrorUtility.h
66 lines (52 loc) · 2.41 KB
/
FBErrorUtility.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
/*
* Copyright 2010-present Facebook.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*!
@class FBErrorUtility
@abstract A utility class with methods to provide more information for Facebook
related errors if you do not want to use the NSError(FBError) category.
*/
@interface FBErrorUtility : NSObject
/*!
@abstract
Categorizes the error, if it is Facebook related, to simplify application mitigation behavior
@discussion
In general, in response to an error connecting to Facebook, an application should, retry the
operation, request permissions, reconnect the application, or prompt the user to take an action.
The error category can be used to understand the class of error received from Facebook. For more infomation on this
see https://developers.facebook.com/docs/reference/api/errors/
@param error the error to be categorized.
*/
+(FBErrorCategory) errorCategoryForError:(NSError *)error;
/*!
@abstract
If YES indicates that a user action is required in order to successfully continue with the facebook operation
@discussion
In general if this returns NO, then the application has a straightforward mitigation, such as
retry the operation or request permissions from the user, etc. In some cases it is necessary for the user to
take an action before the application continues to attempt a Facebook connection. For more infomation on this
see https://developers.facebook.com/docs/reference/api/errors/
@param error the error to inspect.
*/
+(BOOL) shouldNotifyUserForError:(NSError *)error;
/*!
@abstract
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
fberrorShouldNotifyUser is YES, this property returns a localizable message suitable for display.
@param error the error to inspect.
*/
+(NSString *) userMessageForError:(NSError *)error;
@end