mirror of
https://github.com/firebase/firebase-ios-sdk
synced 2026-11-09 22:36:01 +05:45
Michael Haney
93eb6d8c48
* Revert "Refactor event saving and searching (#5773)" This reverts commita61786cbf1. * Revert "Expand the storage protocol and provide an event iterator (#5742)" This reverts commit641d8531a3. * Revert "Implement helpers for storing and finding events (#5738)" This reverts commit9a0aed81b0.
79 lines
2.7 KiB
Objective-C
79 lines
2.7 KiB
Objective-C
/*
|
|
* Copyright 2020 Google
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#import <Foundation/Foundation.h>
|
|
|
|
#import <GoogleDataTransport/GDTCORLifecycle.h>
|
|
#import <GoogleDataTransport/GDTCORTargets.h>
|
|
|
|
@class GDTCOREvent;
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/** Defines the interface a storage subsystem is expected to implement. */
|
|
@protocol GDTCORStorageProtocol <NSObject, GDTCORLifecycleProtocol>
|
|
|
|
@required
|
|
|
|
/** Stores an event and calls onComplete with a non-nil error if anything went wrong.
|
|
*
|
|
* @param event The event to store
|
|
* @param completion The completion block to call after an attempt to store the event has been made.
|
|
*/
|
|
- (void)storeEvent:(GDTCOREvent *)event
|
|
onComplete:(void (^_Nullable)(BOOL wasWritten, NSError *_Nullable error))completion;
|
|
|
|
/** Removes the events from storage. */
|
|
- (void)removeEvents:(NSSet<NSNumber *> *)eventIDs;
|
|
|
|
/** Persists the given data with the given key.
|
|
*
|
|
* @param data The data to store.
|
|
* @param key The unique key to store it to.
|
|
* @param onComplete An block to be run when storage of the data is complete.
|
|
*/
|
|
- (void)storeLibraryData:(NSData *)data
|
|
forKey:(NSString *)key
|
|
onComplete:(void (^)(NSError *_Nullable error))onComplete;
|
|
|
|
/** Retrieves the stored data for the given key.
|
|
*
|
|
* @param key The key corresponding to the desired data.
|
|
* @param onComplete The callback to invoke with the data once it's retrieved.
|
|
*/
|
|
- (void)libraryDataForKey:(NSString *)key
|
|
onComplete:(void (^)(NSData *_Nullable data, NSError *_Nullable error))onComplete;
|
|
|
|
/** Removes data from storage and calls the callback when complete.
|
|
*
|
|
* @param key The key of the data to remove.
|
|
* @param onComplete The callback that will be invoked when removing the data is complete.
|
|
*/
|
|
- (void)removeLibraryDataForKey:(NSString *)key
|
|
onComplete:(void (^)(NSError *_Nullable error))onComplete;
|
|
|
|
@end
|
|
|
|
/** Retrieves the storage instance for the given target.
|
|
*
|
|
* @param target The target.
|
|
* * @return The storage instance registered for the target, or nil if there is none.
|
|
*/
|
|
FOUNDATION_EXPORT
|
|
id<GDTCORStorageProtocol> _Nullable GDTCORStorageInstanceForTarget(GDTCORTarget target);
|
|
|
|
NS_ASSUME_NONNULL_END
|