From 9fdbb77fd2d766c9aa88f6753108354592770058 Mon Sep 17 00:00:00 2001
From: hank <hank.zhang@proficientcity.com>
Date: Thu, 20 Jun 2019 09:50:53 +0800
Subject: [PATCH] [Update] WAFbImpl (3.8.2)
---
frameworks/FBSDKCoreKit.framework/Headers/FBSDKGraphRequestConnection.h | 147 ++++++++++++++++++++++--------------------------
1 files changed, 67 insertions(+), 80 deletions(-)
diff --git a/frameworks/FBSDKCoreKit.framework/Headers/FBSDKGraphRequestConnection.h b/frameworks/FBSDKCoreKit.framework/Headers/FBSDKGraphRequestConnection.h
index 3eca584..6dc8057 100644
--- a/frameworks/FBSDKCoreKit.framework/Headers/FBSDKGraphRequestConnection.h
+++ b/frameworks/FBSDKCoreKit.framework/Headers/FBSDKGraphRequestConnection.h
@@ -18,34 +18,45 @@
#import <Foundation/Foundation.h>
-#import <FBSDKCoreKit/FBSDKMacros.h>
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ The key in the result dictionary for requests to old versions of the Graph API
+ whose response is not a JSON object.
+
+
+ When a request returns a non-JSON response (such as a "true" literal), that response
+ will be wrapped into a dictionary using this const as the key. This only applies for very few Graph API
+ prior to v2.1.
+ */
+FOUNDATION_EXPORT NSString *const FBSDKNonJSONResponseProperty
+NS_SWIFT_NAME(NonJSONResponseProperty);
@class FBSDKGraphRequest;
@class FBSDKGraphRequestConnection;
/**
- FBSDKGraphRequestHandler
+ FBSDKGraphRequestBlock
A block that is passed to addRequest to register for a callback with the results of that
request once the connection completes.
-
-
Pass a block of this type when calling addRequest. This will be called once
the request completes. The call occurs on the UI thread.
- - Parameter connection: The `FBSDKGraphRequestConnection` that sent the request.
+ @param connection The `FBSDKGraphRequestConnection` that sent the request.
- - Parameter result: The result of the request. This is a translation of
+ @param result The result of the request. This is a translation of
JSON data to `NSDictionary` and `NSArray` objects. This
is nil if there was an error.
- - Parameter error: The `NSError` representing any error that occurred.
+ @param error The `NSError` representing any error that occurred.
*/
-typedef void (^FBSDKGraphRequestHandler)(FBSDKGraphRequestConnection *connection,
- id result,
- NSError *error);
+typedef void (^FBSDKGraphRequestBlock)(FBSDKGraphRequestConnection *_Nullable connection,
+ id _Nullable result,
+ NSError *_Nullable error)
+NS_SWIFT_NAME(GraphRequestBlock);
/**
@protocol
@@ -53,6 +64,7 @@
The `FBSDKGraphRequestConnectionDelegate` protocol defines the methods used to receive network
activity progress information from a <FBSDKGraphRequestConnection>.
*/
+NS_SWIFT_NAME(GraphRequestConnectionDelegate)
@protocol FBSDKGraphRequestConnectionDelegate <NSObject>
@optional
@@ -68,7 +80,7 @@
start, the object returned from the convenience method has already begun loading and this method
will not be called when the delegate is set.
- - Parameter connection: The request connection that is starting a network request
+ @param connection The request connection that is starting a network request
*/
- (void)requestConnectionWillBeginLoading:(FBSDKGraphRequestConnection *)connection;
@@ -81,12 +93,12 @@
If the request connection completes without a network error occurring then this method is called.
Invocation of this method does not indicate success of every <FBSDKGraphRequest> made, only that the
- request connection has no further activity. Use the error argument passed to the FBSDKGraphRequestHandler
+ request connection has no further activity. Use the error argument passed to the FBSDKGraphRequestBlock
block to determine success or failure of each <FBSDKGraphRequest>.
This method is invoked after the completion handler for each <FBSDKGraphRequest>.
- - Parameter connection: The request connection that successfully completed a network request
+ @param connection The request connection that successfully completed a network request
*/
- (void)requestConnectionDidFinishLoading:(FBSDKGraphRequestConnection *)connection;
@@ -99,10 +111,10 @@
If the request connection fails with a network error then this method is called. The `error`
argument specifies why the network connection failed. The `NSError` object passed to the
- FBSDKGraphRequestHandler block may contain additional information.
+ FBSDKGraphRequestBlock block may contain additional information.
- - Parameter connection: The request connection that successfully completed a network request
- - Parameter error: The `NSError` representing the network error that occurred, if any. May be nil
+ @param connection The request connection that successfully completed a network request
+ @param error The `NSError` representing the network error that occurred, if any. May be nil
in some circumstances. Consult the `NSError` for the <FBSDKGraphRequest> for reliable
failure information.
*/
@@ -118,12 +130,12 @@
The byte count arguments refer to the aggregated <FBSDKGraphRequest> objects, not a particular <FBSDKGraphRequest>.
- Like `NSURLConnection`, the values may change in unexpected ways if data needs to be resent.
+ Like `NSURLSession`, the values may change in unexpected ways if data needs to be resent.
- - Parameter connection: The request connection transmitting data to a remote host
- - Parameter bytesWritten: The number of bytes sent in the last transmission
- - Parameter totalBytesWritten: The total number of bytes sent to the remote host
- - Parameter totalBytesExpectedToWrite: The total number of bytes expected to send to the remote host
+ @param connection The request connection transmitting data to a remote host
+ @param bytesWritten The number of bytes sent in the last transmission
+ @param totalBytesWritten The total number of bytes sent to the remote host
+ @param totalBytesExpectedToWrite The total number of bytes expected to send to the remote host
*/
- (void)requestConnection:(FBSDKGraphRequestConnection *)connection
didSendBodyData:(NSInteger)bytesWritten
@@ -143,17 +155,23 @@
e.g. starting a connection, canceling a connection, or batching requests.
*/
+NS_SWIFT_NAME(GraphRequestConnection)
@interface FBSDKGraphRequestConnection : NSObject
+
+/**
+ The default timeout on all FBSDKGraphRequestConnection instances. Defaults to 60 seconds.
+ */
+@property (class, nonatomic, assign) NSTimeInterval defaultConnectionTimeout;
/**
The delegate object that receives updates.
*/
-@property (nonatomic, weak) id<FBSDKGraphRequestConnectionDelegate> delegate;
+@property (nonatomic, weak, nullable) id<FBSDKGraphRequestConnectionDelegate> delegate;
/**
Gets or sets the timeout interval to wait for a response before giving up.
*/
-@property (nonatomic) NSTimeInterval timeout;
+@property (nonatomic, assign) NSTimeInterval timeout;
/**
The raw response that was returned from the server. (readonly)
@@ -164,22 +182,21 @@
the server.
The property is nil until the request completes. If there was a response
- then this property will be non-nil during the FBSDKGraphRequestHandler callback.
+ then this property will be non-nil during the FBSDKGraphRequestBlock callback.
*/
-@property (nonatomic, retain, readonly) NSHTTPURLResponse *URLResponse;
+@property (nonatomic, retain, readonly) NSHTTPURLResponse *urlResponse;
+
+/**
+ Determines the operation queue that is used to call methods on the connection's delegate.
+
+ By default, a connection is scheduled on the current thread in the default mode when it is created.
+ You cannot reschedule a connection after it has started.
+ */
+@property (nonatomic, retain) NSOperationQueue *delegateQueue;
/**
@methodgroup Class methods
*/
-
-/**
- @method
-
- This method sets the default timeout on all FBSDKGraphRequestConnection instances. Defaults to 60 seconds.
-
- - Parameter defaultConnectionTimeout: The timeout interval.
- */
-+ (void)setDefaultConnectionTimeout:(NSTimeInterval)defaultConnectionTimeout;
/**
@methodgroup Adding requests
@@ -190,64 +207,58 @@
This method adds an <FBSDKGraphRequest> object to this connection.
- - Parameter request: A request to be included in the round-trip when start is called.
- - Parameter handler: A handler to call back when the round-trip completes or times out.
-
-
+ @param request A request to be included in the round-trip when start is called.
+ @param handler A handler to call back when the round-trip completes or times out.
The completion handler is retained until the block is called upon the
completion or cancellation of the connection.
*/
- (void)addRequest:(FBSDKGraphRequest *)request
- completionHandler:(FBSDKGraphRequestHandler)handler;
+ completionHandler:(FBSDKGraphRequestBlock)handler;
/**
@method
This method adds an <FBSDKGraphRequest> object to this connection.
- - Parameter request: A request to be included in the round-trip when start is called.
+ @param request A request to be included in the round-trip when start is called.
- - Parameter handler: A handler to call back when the round-trip completes or times out.
+ @param handler A handler to call back when the round-trip completes or times out.
The handler will be invoked on the main thread.
- - Parameter name: An optional name for this request. This can be used to feed
+ @param name A name for this request. This can be used to feed
the results of one request to the input of another <FBSDKGraphRequest> in the same
`FBSDKGraphRequestConnection` as described in
[Graph API Batch Requests]( https://developers.facebook.com/docs/reference/api/batch/ ).
-
-
The completion handler is retained until the block is called upon the
completion or cancellation of the connection. This request can be named
to allow for using the request's response in a subsequent request.
*/
- (void)addRequest:(FBSDKGraphRequest *)request
- completionHandler:(FBSDKGraphRequestHandler)handler
- batchEntryName:(NSString *)name;
+ batchEntryName:(NSString *)name
+ completionHandler:(FBSDKGraphRequestBlock)handler;
/**
@method
This method adds an <FBSDKGraphRequest> object to this connection.
- - Parameter request: A request to be included in the round-trip when start is called.
+ @param request A request to be included in the round-trip when start is called.
- - Parameter handler: A handler to call back when the round-trip completes or times out.
+ @param handler A handler to call back when the round-trip completes or times out.
- - Parameter batchParameters: The optional dictionary of parameters to include for this request
+ @param batchParameters The dictionary of parameters to include for this request
as described in [Graph API Batch Requests]( https://developers.facebook.com/docs/reference/api/batch/ ).
Examples include "depends_on", "name", or "omit_response_on_success".
-
-
The completion handler is retained until the block is called upon the
completion or cancellation of the connection. This request can be named
to allow for using the request's response in a subsequent request.
*/
- (void)addRequest:(FBSDKGraphRequest *)request
- completionHandler:(FBSDKGraphRequestHandler)handler
- batchParameters:(NSDictionary *)batchParameters;
+ batchParameters:(NSDictionary<NSString *, id> *)batchParameters
+ completionHandler:(FBSDKGraphRequestBlock)handler;
/**
@methodgroup Instance methods
@@ -258,8 +269,6 @@
Signals that a connection should be logically terminated as the
application is no longer interested in a response.
-
-
Synchronously calls any handlers indicating the request was cancelled. Cancel
does not guarantee that the request-related processing will cease. It
@@ -284,40 +293,18 @@
- (void)start;
/**
- Determines the operation queue that is used to call methods on the connection's delegate.
- - Parameter queue: The operation queue to use when calling delegate methods.
-
- By default, a connection is scheduled on the current thread in the default mode when it is created.
- You cannot reschedule a connection after it has started.
-
- This is very similar to `[NSURLConnection setDelegateQueue:]`.
- */
-- (void)setDelegateQueue:(NSOperationQueue *)queue;
-
-/**
@method
Overrides the default version for a batch request
-
-
The SDK automatically prepends a version part, such as "v2.0" to API paths in order to simplify API versioning
for applications. If you want to override the version part while using batch requests on the connection, call
this method to set the version for the batch request.
- - Parameter version: This is a string in the form @"v2.0" which will be used for the version part of an API path
+ @param version This is a string in the form @"v2.0" which will be used for the version part of an API path
*/
-- (void)overrideVersionPartWith:(NSString *)version;
+- (void)overrideGraphAPIVersion:(NSString *)version;
@end
-/**
- The key in the result dictionary for requests to old versions of the Graph API
- whose response is not a JSON object.
-
-
- When a request returns a non-JSON response (such as a "true" literal), that response
- will be wrapped into a dictionary using this const as the key. This only applies for very few Graph API
- prior to v2.1.
- */
-FBSDK_EXTERN NSString *const FBSDKNonJSONResponseProperty;
+NS_ASSUME_NONNULL_END
--
Gitblit v1.8.0