123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293 |
- /*
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- * All rights reserved.
- *
- * This source code is licensed under the license found in the
- * LICENSE file in the root directory of this source tree.
- */
- #import <Foundation/Foundation.h>
- #import <FBSDKCoreKit/FBSDKGraphRequestConnecting.h>
- NS_ASSUME_NONNULL_BEGIN
- /**
- @protocol
- The `FBSDKGraphRequestConnectionDelegate` protocol defines the methods used to receive network
- activity progress information from a <FBSDKGraphRequestConnection>.
- */
- NS_SWIFT_NAME(GraphRequestConnectionDelegate)
- @protocol FBSDKGraphRequestConnectionDelegate <NSObject>
- @optional
- /**
- @method
- Tells the delegate the request connection will begin loading
- If the <FBSDKGraphRequestConnection> is created using one of the convenience factory methods prefixed with
- start, the object returned from the convenience method has already begun loading and this method
- will not be called when the delegate is set.
- @param connection The request connection that is starting a network request
- */
- - (void)requestConnectionWillBeginLoading:(id<FBSDKGraphRequestConnecting>)connection;
- /**
- @method
- Tells the delegate the request connection finished loading
- 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 FBSDKGraphRequestBlock
- block to determine success or failure of each <FBSDKGraphRequest>.
- This method is invoked after the completion handler for each <FBSDKGraphRequest>.
- @param connection The request connection that successfully completed a network request
- */
- - (void)requestConnectionDidFinishLoading:(id<FBSDKGraphRequestConnecting>)connection;
- /**
- @method
- Tells the delegate the request connection failed with an error
- 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
- FBSDKGraphRequestBlock block may contain additional information.
- @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.
- */
- - (void)requestConnection:(id<FBSDKGraphRequestConnecting>)connection
- didFailWithError:(NSError *)error;
- /**
- @method
- Tells the delegate how much data has been sent and is planned to send to the remote host
- The byte count arguments refer to the aggregated <FBSDKGraphRequest> objects, not a particular <FBSDKGraphRequest>.
- Like `NSURLSession`, the values may change in unexpected ways if data needs to be resent.
- @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:(id<FBSDKGraphRequestConnecting>)connection
- didSendBodyData:(NSInteger)bytesWritten
- totalBytesWritten:(NSInteger)totalBytesWritten
- totalBytesExpectedToWrite:(NSInteger)totalBytesExpectedToWrite;
- @end
- NS_ASSUME_NONNULL_END
|