mirror of
https://github.com/zhigang1992/RestKit.git
synced 2026-01-12 22:51:50 +08:00
79e31b524a
* Migrated the caches to return `NSSet` to eliminate duplicate objects when your cache keys overlap * Introduced new recursive strategy for building cache keys in `RKInMemoryManagedObjectCache` * Added support for array cache key values in `RKFetchRequestManagedObjectCache` * Re-enabled a slew of tests that were disabled during 0.20 development
73 lines
2.6 KiB
Objective-C
73 lines
2.6 KiB
Objective-C
//
|
|
// RKManagedObjectCaching.h
|
|
// RestKit
|
|
//
|
|
// Created by Jeff Arena on 1/24/12.
|
|
// Copyright (c) 2009-2012 RestKit. All rights reserved.
|
|
//
|
|
// 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 <CoreData/CoreData.h>
|
|
|
|
/**
|
|
Objects implementing the `RKManagedObjectCaching` provide support for retrieving managed object matching a set of attributes using an opaque caching strategy. The objects retrieved are not required to be in any particular order, but must exactly match the attribute values requested.
|
|
*/
|
|
@protocol RKManagedObjectCaching <NSObject>
|
|
|
|
@required
|
|
|
|
///---------------------------------
|
|
/// @name Retrieving Managed Objects
|
|
///---------------------------------
|
|
|
|
/**
|
|
Returns all managed objects for a given entity with attributes whose names and values match the given dictionary in a given context.
|
|
|
|
@param entity The entity to retrieve managed objects for.
|
|
@param attributeValues A dictionary specifying the attribute criteria for retrieving managed objects.
|
|
@param managedObjectContext The context to fetch the matching objects in.
|
|
*/
|
|
- (NSSet *)managedObjectsWithEntity:(NSEntityDescription *)entity
|
|
attributeValues:(NSDictionary *)attributeValues
|
|
inManagedObjectContext:(NSManagedObjectContext *)managedObjectContext;
|
|
|
|
///---------------------------------------------------
|
|
/// @name Handling Managed Object Change Notifications
|
|
///---------------------------------------------------
|
|
|
|
@optional
|
|
|
|
/**
|
|
Invoked to inform the receiver that an object was fetched and should be added to the cache.
|
|
|
|
@param object The object that was fetched from a managed object context.
|
|
*/
|
|
- (void)didFetchObject:(NSManagedObject *)object;
|
|
|
|
/**
|
|
Invoked to inform the receiver that an object was created and should be added to the cache.
|
|
|
|
@param object The object that was created in a managed object context.
|
|
*/
|
|
- (void)didCreateObject:(NSManagedObject *)object;
|
|
|
|
/**
|
|
Invoked to inform the receiver that an object was deleted and should be removed to the cache.
|
|
|
|
@param object The object that was deleted from a managed object context.
|
|
*/
|
|
- (void)didDeleteObject:(NSManagedObject *)object;
|
|
|
|
@end
|