hank
2019-01-22 bf63695cd124ba0c3127f4cc8aa99c737729dd1d
frameworks/FBSDKCoreKit.framework/Headers/FBSDKGraphRequest.h
@@ -22,10 +22,11 @@
@class FBSDKAccessToken;
/*!
 @abstract Represents a request to the Facebook Graph API.
/**
  Represents a request to the Facebook Graph API.
 @discussion `FBSDKGraphRequest` encapsulates the components of a request (the
 `FBSDKGraphRequest` encapsulates the components of a request (the
 Graph API path, the parameters, error recovery behavior) and should be
 used in conjunction with `FBSDKGraphRequestConnection` to issue the request.
@@ -37,20 +38,24 @@
 By default, FBSDKGraphRequest will attempt to recover any errors returned from
 Facebook. You can disable this via `disableErrorRecovery:`.
 @see FBSDKGraphErrorRecoveryProcessor
 */
@interface FBSDKGraphRequest : NSObject
/*!
 @abstract Initializes a new instance that use use `[FBSDKAccessToken currentAccessToken]`.
- (instancetype)init NS_UNAVAILABLE;
+ (instancetype)new NS_UNAVAILABLE;
/**
  Initializes a new instance that use use `[FBSDKAccessToken currentAccessToken]`.
 @param graphPath the graph path (e.g., @"me").
 @param parameters the optional parameters dictionary.
 */
- (instancetype)initWithGraphPath:(NSString *)graphPath
                       parameters:(NSDictionary *)parameters;
/*!
 @abstract Initializes a new instance that use use `[FBSDKAccessToken currentAccessToken]`.
/**
  Initializes a new instance that use use `[FBSDKAccessToken currentAccessToken]`.
 @param graphPath the graph path (e.g., @"me").
 @param parameters the optional parameters dictionary.
 @param HTTPMethod the optional HTTP method. nil defaults to @"GET".
@@ -59,12 +64,12 @@
                       parameters:(NSDictionary *)parameters
                       HTTPMethod:(NSString *)HTTPMethod;
/*!
 @abstract Initializes a new instance.
/**
  Initializes a new instance.
 @param graphPath the graph path (e.g., @"me").
 @param parameters the optional parameters dictionary.
 @param tokenString the token string to use. Specifying nil will cause no token to be used.
 @param version the optional Graph API version (e.g., @"v2.0"). nil defaults to FBSDK_TARGET_PLATFORM_VERSION.
 @param version the optional Graph API version (e.g., @"v2.0"). nil defaults to `[FBSDKSettings graphAPIVersion]`.
 @param HTTPMethod the optional HTTP method (e.g., @"POST"). nil defaults to @"GET".
 */
- (instancetype)initWithGraphPath:(NSString *)graphPath
@@ -74,35 +79,36 @@
                       HTTPMethod:(NSString *)HTTPMethod
NS_DESIGNATED_INITIALIZER;
/*!
 @abstract The request parameters.
/**
  The request parameters.
 */
@property (nonatomic, strong, readonly) NSMutableDictionary *parameters;
/*!
 @abstract The access token string used by the request.
/**
  The access token string used by the request.
 */
@property (nonatomic, copy, readonly) NSString *tokenString;
/*!
 @abstract The Graph API endpoint to use for the request, for example "me".
/**
  The Graph API endpoint to use for the request, for example "me".
 */
@property (nonatomic, copy, readonly) NSString *graphPath;
/*!
 @abstract The HTTPMethod to use for the request, for example "GET" or "POST".
/**
  The HTTPMethod to use for the request, for example "GET" or "POST".
 */
@property (nonatomic, copy, readonly) NSString *HTTPMethod;
/*!
 @abstract The Graph API version to use (e.g., "v2.0")
/**
  The Graph API version to use (e.g., "v2.0")
 */
@property (nonatomic, copy, readonly) NSString *version;
/*!
 @abstract If set, disables the automatic error recovery mechanism.
/**
  If set, disables the automatic error recovery mechanism.
 @param disable whether to disable the automatic error recovery mechanism
 @discussion By default, non-batched FBSDKGraphRequest instances will automatically try to recover
 By default, non-batched FBSDKGraphRequest instances will automatically try to recover
 from errors by constructing a `FBSDKGraphErrorRecoveryProcessor` instance that
 re-issues the request on successful recoveries. The re-issued request will call the same
 handler as the receiver but may occur with a different `FBSDKGraphRequestConnection` instance.
@@ -111,8 +117,8 @@
 */
- (void)setGraphErrorRecoveryDisabled:(BOOL)disable;
/*!
 @abstract Starts a connection to the Graph API.
/**
  Starts a connection to the Graph API.
 @param handler The handler block to call when the request completes.
 */
- (FBSDKGraphRequestConnection *)startWithCompletionHandler:(FBSDKGraphRequestHandler)handler;