Files
Swiftgram/Source/Details/ASBatchContext.h
Peter a085123ec1 Merge commit '565da7d4935740d12fc204aa061faf093831da1e'
# Conflicts:
#	AsyncDisplayKit.xcodeproj/project.pbxproj
#	AsyncDisplayKit.xcodeproj/xcshareddata/xcschemes/AsyncDisplayKit.xcscheme
#	Source/ASDisplayNode.mm
#	Source/ASEditableTextNode.h
#	Source/ASImageNode.mm
#	Source/ASMapNode.h
#	Source/ASMapNode.mm
#	Source/Base/ASAssert.m
#	Source/Details/ASPhotosFrameworkImageRequest.h
#	Source/Details/ASPhotosFrameworkImageRequest.m
#	Source/Layout/ASLayoutElement.mm
2018-10-08 22:42:45 +03:00

70 lines
2.2 KiB
Objective-C

//
// ASBatchContext.h
// Texture
//
// Copyright (c) Facebook, Inc. and its affiliates. All rights reserved.
// Changes after 4/13/2017 are: Copyright (c) Pinterest, Inc. All rights reserved.
// Licensed under Apache 2.0: http://www.apache.org/licenses/LICENSE-2.0
//
#ifndef MINIMAL_ASDK
#import <Foundation/Foundation.h>
NS_ASSUME_NONNULL_BEGIN
/**
* @abstract A context object to notify when batch fetches are finished or cancelled.
*/
@interface ASBatchContext : NSObject
/**
* Retrieve the state of the current batch process.
*
* @return A boolean reflecting if the owner of the context object is fetching another batch.
*/
- (BOOL)isFetching;
/**
* Let the context object know that a batch fetch was completed.
*
* @param didComplete A boolean that states whether or not the batch fetch completed.
*
* @discussion Only by passing YES will the owner of the context know to attempt another batch update when necessary.
* For instance, when a table has reached the end of its data, a batch fetch will be attempted unless the context
* object thinks that it is still fetching.
*/
- (void)completeBatchFetching:(BOOL)didComplete;
/**
* Ask the context object if the batch fetching process was cancelled by the context owner.
*
* @discussion If an error occurs in the context owner, the batch fetching may become out of sync and need to be
* cancelled. For best practices, pass the return value of -batchWasCancelled to -completeBatchFetch:.
*
* @return A boolean reflecting if the context object owner had to cancel the batch process.
*/
- (BOOL)batchFetchingWasCancelled;
/**
* Notify the context object that something has interrupted the batch fetching process.
*
* @discussion Call this method only when something has corrupted the batch fetching process. Calling this method should
* be left to the owner of the batch process unless there is a specific purpose.
*/
- (void)cancelBatchFetching;
/**
* Notify the context object that fetching has started.
*
* @discussion Call this method only when you are beginning a fetch process. This should really only be called by the
* context object's owner. Calling this method should be paired with -completeBatchFetching:.
*/
- (void)beginBatchFetching;
@end
NS_ASSUME_NONNULL_END
#endif