mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-09-11 06:55:23 +00:00
74c6cca0b6
* Refactor ASDataController Check optional methods in ASDataControllerSource * Reimplement reloadData * Refactor new code - No more new/inserted contexts flag - Encapsulate code shared between reloadData and updateWithChangeSet - Remove dataControllerWillDeleteAllData delegate method - Hierarchy changes no longer needs to conform to NSCopying - Reword TODOs * Forgot to call completion block of reloadData :P * Completion block of -[ASDataController reloadDataWithCompletion:] is nullable * Data queried from ASCollectionNode and ASTableNode should be in UIKit index space - This helps to avoid immature node allocation, especially when node virtualization is a thing - However, this means that -reloadDataInitiallyIfNeeded in ASCollectionNode and ASTableNode must wait until all updates are finished. * ASDataController shouldn't assume that allocated nodes were also laid out * Revert "Data queried from ASCollectionNode and ASTableNode should be in UIKit index space" This reverts commit 7bc977b3808a92f484b297781d0f5b30aa258e17. * -nodeAtIndexPath: of ASDataController now forces node allocation, with the assumption that clients absolutely need it. - Revisit this when node virtualization is implemented. * ASDataController only grab changeSet.completionHandler when needed because it'll be niled out * Fix ASTableViewTests related to reloadData * Fix testThatDeletedItemsAreMarkedInvisible in ASCollectionViewTests * Minor changes in ASCollectionView and ASTableView * ASCollectionView and ASTableView shouldn't call [super reloadData] before their data controller does anything * Address comments * Fuse reloadData into -updateWithChangeSet: of ASDataController * reloadData shouldn't be called as if it's inside a batch - It can't be used in conjuntion with other updates. - Calling it inside a batch update during the initial load can cause data inconsistency thrown by UICollectionView/UITableView * Refactor ASDataControllerDelegate and ASRangeControllerDelegate - Replace delegate methods in these protocols with -willUpdateWithChangeSet and -didUpdateWithChangeSet. - ASRangeController, ASCollectionView and ASTableView are simplified because of this. * Fix mismatch between sorting orders in ASDataController * Forgot to call completion handler of reload change sets * Make sure ASCollectionView is compatible with the behavior of UICollectionView's reloadData - Since UICollectionView's reloadData doesn't requery data source but defers until the next layout pass, we need to wait until then to update range controller and do batch fetching. - `-[ASCollectionView waitUntilAllUpdatesAreCommited]` needs to force a layout pass to make sure everything is ready after it returns. * testSectionIndexHandling of ASTableViewTests should only check visible nodes. Other nodes will be re-measured later. * ASTableView is not ready until the first layout pass finished * Address comments * Bug fixes
158 lines
6.5 KiB
Objective-C
158 lines
6.5 KiB
Objective-C
//
|
||
// _ASHierarchyChangeSet.h
|
||
// AsyncDisplayKit
|
||
//
|
||
// Created by Adlai Holler on 9/29/15.
|
||
//
|
||
// Copyright (c) 2014-present, Facebook, Inc. All rights reserved.
|
||
// This source code is licensed under the BSD-style license found in the
|
||
// LICENSE file in the root directory of this source tree. An additional grant
|
||
// of patent rights can be found in the PATENTS file in the same directory.
|
||
//
|
||
|
||
#import <Foundation/Foundation.h>
|
||
#import <vector>
|
||
#import <AsyncDisplayKit/ASObjectDescriptionHelpers.h>
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
typedef NSUInteger ASDataControllerAnimationOptions;
|
||
|
||
typedef NS_ENUM(NSInteger, _ASHierarchyChangeType) {
|
||
/**
|
||
* A reload change, as submitted by the user. When a change set is
|
||
* completed, these changes are decomposed into delete-insert pairs
|
||
* and combined with the original deletes and inserts of the change.
|
||
*/
|
||
_ASHierarchyChangeTypeReload,
|
||
|
||
/**
|
||
* A change that was either an original delete, or the first
|
||
* part of a decomposed reload.
|
||
*/
|
||
_ASHierarchyChangeTypeDelete,
|
||
|
||
/**
|
||
* A change that was submitted by the user as a delete.
|
||
*/
|
||
_ASHierarchyChangeTypeOriginalDelete,
|
||
|
||
/**
|
||
* A change that was either an original insert, or the second
|
||
* part of a decomposed reload.
|
||
*/
|
||
_ASHierarchyChangeTypeInsert,
|
||
|
||
/**
|
||
* A change that was submitted by the user as an insert.
|
||
*/
|
||
_ASHierarchyChangeTypeOriginalInsert
|
||
};
|
||
|
||
/**
|
||
* Returns YES if the given change type is either .Insert or .Delete, NO otherwise.
|
||
* Other change types – .Reload, .OriginalInsert, .OriginalDelete – are
|
||
* intermediary types used while building the change set. All changes will
|
||
* be reduced to either .Insert or .Delete when the change is marked completed.
|
||
*/
|
||
BOOL ASHierarchyChangeTypeIsFinal(_ASHierarchyChangeType changeType);
|
||
|
||
NSString *NSStringFromASHierarchyChangeType(_ASHierarchyChangeType changeType);
|
||
|
||
@interface _ASHierarchySectionChange : NSObject <ASDescriptionProvider, ASDebugDescriptionProvider>
|
||
|
||
// FIXME: Generalize this to `changeMetadata` dict?
|
||
@property (nonatomic, readonly) ASDataControllerAnimationOptions animationOptions;
|
||
|
||
@property (nonatomic, strong, readonly) NSIndexSet *indexSet;
|
||
@property (nonatomic, readonly) _ASHierarchyChangeType changeType;
|
||
|
||
/**
|
||
* If this is a .OriginalInsert or .OriginalDelete change, this returns a copied change
|
||
* with type .Insert or .Delete. Calling this on changes of other types is an error.
|
||
*/
|
||
- (_ASHierarchySectionChange *)changeByFinalizingType;
|
||
@end
|
||
|
||
@interface _ASHierarchyItemChange : NSObject <ASDescriptionProvider, ASDebugDescriptionProvider>
|
||
@property (nonatomic, readonly) ASDataControllerAnimationOptions animationOptions;
|
||
|
||
/// Index paths are sorted descending for changeType .Delete, ascending otherwise
|
||
@property (nonatomic, strong, readonly) NSArray<NSIndexPath *> *indexPaths;
|
||
|
||
@property (nonatomic, readonly) _ASHierarchyChangeType changeType;
|
||
|
||
+ (NSDictionary *)sectionToIndexSetMapFromChanges:(NSArray<_ASHierarchyItemChange *> *)changes;
|
||
|
||
/**
|
||
* If this is a .OriginalInsert or .OriginalDelete change, this returns a copied change
|
||
* with type .Insert or .Delete. Calling this on changes of other types is an error.
|
||
*/
|
||
- (_ASHierarchyItemChange *)changeByFinalizingType;
|
||
@end
|
||
|
||
@interface _ASHierarchyChangeSet : NSObject <ASDescriptionProvider, ASDebugDescriptionProvider>
|
||
|
||
- (instancetype)initWithOldData:(std::vector<NSInteger>)oldItemCounts NS_DESIGNATED_INITIALIZER;
|
||
|
||
/**
|
||
* Append the given completion handler to the combined @c completionHandler.
|
||
*
|
||
* @discussion Since batch updates can be nested, we have to support multiple
|
||
* completion handlers per update.
|
||
*
|
||
* @precondition The change set must not be completed.
|
||
*/
|
||
- (void)addCompletionHandler:(nullable void(^)(BOOL finished))completion;
|
||
|
||
/**
|
||
* Execute the combined completion handler.
|
||
*
|
||
* @warning The completion block is discarded after reading because it may have captured
|
||
* significant resources that we would like to reclaim as soon as possible.
|
||
*/
|
||
- (void)executeCompletionHandlerWithFinished:(BOOL)finished;
|
||
|
||
/// @precondition The change set must be completed.
|
||
@property (nonatomic, strong, readonly) NSIndexSet *deletedSections;
|
||
/// @precondition The change set must be completed.
|
||
@property (nonatomic, strong, readonly) NSIndexSet *insertedSections;
|
||
|
||
/**
|
||
Get the section index after the update for the given section before the update.
|
||
|
||
@precondition The change set must be completed.
|
||
@return The new section index, or NSNotFound if the given section was deleted.
|
||
*/
|
||
- (NSUInteger)newSectionForOldSection:(NSUInteger)oldSection;
|
||
|
||
@property (nonatomic, readonly) BOOL completed;
|
||
/// Whether or not changes should be animated.
|
||
// TODO: if any update in this chagne set is non-animated, the whole update should be non-animated.
|
||
@property (nonatomic, readwrite) BOOL animated;
|
||
@property (nonatomic, readonly) BOOL includesReloadData;
|
||
|
||
/// Call this once the change set has been constructed to prevent future modifications to the changeset. Calling this more than once is a programmer error.
|
||
/// NOTE: Calling this method will cause the changeset to convert all reloads into delete/insert pairs.
|
||
- (void)markCompletedWithNewItemCounts:(std::vector<NSInteger>)newItemCounts;
|
||
|
||
- (nullable NSArray <_ASHierarchySectionChange *> *)sectionChangesOfType:(_ASHierarchyChangeType)changeType;
|
||
- (nullable NSArray <_ASHierarchyItemChange *> *)itemChangesOfType:(_ASHierarchyChangeType)changeType;
|
||
|
||
/// Returns all item indexes affected by changes of the given type in the given section.
|
||
- (NSIndexSet *)indexesForItemChangesOfType:(_ASHierarchyChangeType)changeType inSection:(NSUInteger)section;
|
||
|
||
- (void)reloadData;
|
||
- (void)deleteSections:(NSIndexSet *)sections animationOptions:(ASDataControllerAnimationOptions)options;
|
||
- (void)insertSections:(NSIndexSet *)sections animationOptions:(ASDataControllerAnimationOptions)options;
|
||
- (void)reloadSections:(NSIndexSet *)sections animationOptions:(ASDataControllerAnimationOptions)options;
|
||
- (void)insertItems:(NSArray<NSIndexPath *> *)indexPaths animationOptions:(ASDataControllerAnimationOptions)options;
|
||
- (void)deleteItems:(NSArray<NSIndexPath *> *)indexPaths animationOptions:(ASDataControllerAnimationOptions)options;
|
||
- (void)reloadItems:(NSArray<NSIndexPath *> *)indexPaths animationOptions:(ASDataControllerAnimationOptions)options;
|
||
- (void)moveSection:(NSInteger)section toSection:(NSInteger)newSection animationOptions:(ASDataControllerAnimationOptions)options;
|
||
- (void)moveItemAtIndexPath:(NSIndexPath *)indexPath toIndexPath:(NSIndexPath *)newIndexPath animationOptions:(ASDataControllerAnimationOptions)options;
|
||
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|