forked from RestKit/RestKit
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
666 changed files
with
41,278 additions
and
11,198 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,3 +1,3 @@ | ||
| [submodule "Examples/RKCatalog/Server"] | ||
| path = Examples/RKCatalog/Server | ||
| url = git://github.com/twotoasters/RKCatalog-Server.git | ||
| url = git://github.com/RestKit/RKCatalog-Server.git |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,93 @@ | ||
| // | ||
| // NSEntityDescription+RKAdditions.h | ||
| // RestKit | ||
| // | ||
| // Created by Blake Watters on 3/22/12. | ||
| // Copyright (c) 2009-2012 RestKit. All rights reserved. | ||
| // | ||
|
|
||
| #import <CoreData/CoreData.h> | ||
|
|
||
| /** | ||
| The key for retrieving the name of the attribute that acts as | ||
| the primary key from the user info dictionary of the receiving NSEntityDescription. | ||
| **Value**: @"primaryKeyAttribute" | ||
| */ | ||
| extern NSString * const RKEntityDescriptionPrimaryKeyAttributeUserInfoKey; | ||
|
|
||
| /** | ||
| The substitution variable used in predicateForPrimaryKeyAttribute. | ||
| **Value**: @"PRIMARY_KEY_VALUE" | ||
| @see predicateForPrimaryKeyAttribute | ||
| */ | ||
| extern NSString * const RKEntityDescriptionPrimaryKeyAttributeValuePredicateSubstitutionVariable; | ||
|
|
||
| /** | ||
| Provides extensions to NSEntityDescription for various common tasks. | ||
| */ | ||
| @interface NSEntityDescription (RKAdditions) | ||
|
|
||
| /** | ||
| The name of the attribute that acts as the primary key for the receiver. | ||
| The primary key attribute can be configured in two ways: | ||
| 1. From within the Xcode Core Data editing view by | ||
| adding the desired attribute's name as the value for the | ||
| key `primaryKeyAttribute` to the user info dictionary. | ||
| 1. Programmatically, by retrieving the NSEntityDescription instance and | ||
| setting the property's value. | ||
| Programmatically configured values take precedence over the user info | ||
| dictionary. | ||
| */ | ||
| @property (nonatomic, retain) NSString *primaryKeyAttributeName; | ||
|
|
||
| /** | ||
| The attribute description object for the attribute designated as the primary key for the receiver. | ||
| */ | ||
| @property (nonatomic, readonly) NSAttributeDescription *primaryKeyAttribute; | ||
|
|
||
| /** | ||
| The class representing the value of the attribute designated as the primary key for the receiver. | ||
| */ | ||
| @property (nonatomic, readonly) Class primaryKeyAttributeClass; | ||
|
|
||
| /** | ||
| Returns a cached predicate specifying that the primary key attribute is equal to the $PRIMARY_KEY_VALUE | ||
| substitution variable. | ||
| This predicate is cached to avoid parsing overhead during object mapping operations | ||
| and must be evaluated using [NSPredicate predicateWithSubstitutionVariables:] | ||
| @return A cached predicate specifying the value of the primary key attribute is equal to the $PRIMARY_KEY_VALUE | ||
| substitution variable. | ||
| */ | ||
| - (NSPredicate *)predicateForPrimaryKeyAttribute; | ||
|
|
||
| /** | ||
| Returns a predicate specifying that the value of the primary key attribute is equal to a given | ||
| value. This predicate is constructed by evaluating the cached predicate returned by the | ||
| predicateForPrimaryKeyAttribute with a dictionary of substitution variables specifying that | ||
| $PRIMARY_KEY_VALUE is equal to the given value. | ||
| **NOTE**: This method considers the type of the receiver's primary key attribute when constructing | ||
| the predicate. It will coerce the given value into either an NSString or an NSNumber as | ||
| appropriate. This behavior is a convenience to avoid annoying issues related to Core Data's | ||
| handling of predicates for NSString and NSNumber types that were not appropriately casted. | ||
| @return A predicate speciying that the value of the primary key attribute is equal to a given value. | ||
| */ | ||
| - (NSPredicate *)predicateForPrimaryKeyAttributeWithValue:(id)value; | ||
|
|
||
| /** | ||
| Coerces the given value into the class representing the primary key. Currently support NSString | ||
| and NSNumber coercsions. | ||
| @bug **NOTE** This API is temporary and will be deprecated and replaced. | ||
| @since 0.10.1 | ||
| */ | ||
| - (id)coerceValueForPrimaryKey:(id)primaryKeyValue; | ||
|
|
||
| @end |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,107 @@ | ||
| // | ||
| // NSEntityDescription+RKAdditions.m | ||
| // RestKit | ||
| // | ||
| // Created by Blake Watters on 3/22/12. | ||
| // Copyright (c) 2009-2012 RestKit. All rights reserved. | ||
| // | ||
|
|
||
| #import <objc/runtime.h> | ||
| #import "NSEntityDescription+RKAdditions.h" | ||
|
|
||
| NSString * const RKEntityDescriptionPrimaryKeyAttributeUserInfoKey = @"primaryKeyAttribute"; | ||
| NSString * const RKEntityDescriptionPrimaryKeyAttributeValuePredicateSubstitutionVariable = @"PRIMARY_KEY_VALUE"; | ||
|
|
||
| static char primaryKeyAttributeNameKey, primaryKeyPredicateKey; | ||
|
|
||
| @implementation NSEntityDescription (RKAdditions) | ||
|
|
||
| - (void)setPredicateForPrimaryKeyAttribute:(NSString *)primaryKeyAttribute | ||
| { | ||
| NSPredicate *predicate = (primaryKeyAttribute) ? [NSPredicate predicateWithFormat:@"%K == $PRIMARY_KEY_VALUE", primaryKeyAttribute] : nil; | ||
| objc_setAssociatedObject(self, | ||
| &primaryKeyPredicateKey, | ||
| predicate, | ||
| OBJC_ASSOCIATION_RETAIN); | ||
| } | ||
|
|
||
| #pragma mark - Public | ||
|
|
||
| - (NSAttributeDescription *)primaryKeyAttribute | ||
| { | ||
| return [[self attributesByName] valueForKey:[self primaryKeyAttributeName]]; | ||
| } | ||
|
|
||
| - (Class)primaryKeyAttributeClass | ||
| { | ||
| NSAttributeDescription *attributeDescription = [self primaryKeyAttribute]; | ||
| if (attributeDescription) { | ||
| return NSClassFromString(attributeDescription.attributeValueClassName); | ||
| } | ||
|
|
||
| return nil; | ||
| } | ||
|
|
||
| - (NSString *)primaryKeyAttributeName | ||
| { | ||
| // Check for an associative object reference | ||
| NSString *primaryKeyAttribute = (NSString *) objc_getAssociatedObject(self, &primaryKeyAttributeNameKey); | ||
|
|
||
| // Fall back to the userInfo dictionary | ||
| if (! primaryKeyAttribute) { | ||
| primaryKeyAttribute = [self.userInfo valueForKey:RKEntityDescriptionPrimaryKeyAttributeUserInfoKey]; | ||
|
|
||
| // If we have loaded from the user info, ensure we have a predicate | ||
| if (! [self predicateForPrimaryKeyAttribute]) { | ||
| [self setPredicateForPrimaryKeyAttribute:primaryKeyAttribute]; | ||
| } | ||
| } | ||
|
|
||
| return primaryKeyAttribute; | ||
| } | ||
|
|
||
| - (void)setPrimaryKeyAttributeName:(NSString *)primaryKeyAttributeName | ||
| { | ||
| objc_setAssociatedObject(self, | ||
| &primaryKeyAttributeNameKey, | ||
| primaryKeyAttributeName, | ||
| OBJC_ASSOCIATION_RETAIN); | ||
| [self setPredicateForPrimaryKeyAttribute:primaryKeyAttributeName]; | ||
| } | ||
|
|
||
| - (NSPredicate *)predicateForPrimaryKeyAttribute | ||
| { | ||
| return (NSPredicate *) objc_getAssociatedObject(self, &primaryKeyPredicateKey); | ||
| } | ||
|
|
||
| - (id)coerceValueForPrimaryKey:(id)primaryKeyValue | ||
| { | ||
| id searchValue = primaryKeyValue; | ||
| Class theClass = [self primaryKeyAttributeClass]; | ||
| if (theClass) { | ||
| // TODO: This coercsion behavior should be pluggable and reused from the mapper | ||
| if ([theClass isSubclassOfClass:[NSNumber class]] && ![searchValue isKindOfClass:[NSNumber class]]) { | ||
| // Handle NSString -> NSNumber | ||
| if ([searchValue isKindOfClass:[NSString class]]) { | ||
| searchValue = [NSNumber numberWithDouble:[searchValue doubleValue]]; | ||
| } | ||
| } else if ([theClass isSubclassOfClass:[NSString class]] && ![searchValue isKindOfClass:[NSString class]]) { | ||
| // Coerce to string | ||
| if ([searchValue respondsToSelector:@selector(stringValue)]) { | ||
| searchValue = [searchValue stringValue]; | ||
| } | ||
| } | ||
| } | ||
|
|
||
| return searchValue; | ||
| } | ||
|
|
||
| - (NSPredicate *)predicateForPrimaryKeyAttributeWithValue:(id)value | ||
| { | ||
| id substitutionValue = [self coerceValueForPrimaryKey:value]; | ||
| NSDictionary *variables = [NSDictionary dictionaryWithObject:substitutionValue | ||
| forKey:RKEntityDescriptionPrimaryKeyAttributeValuePredicateSubstitutionVariable]; | ||
| return [[self predicateForPrimaryKeyAttribute] predicateWithSubstitutionVariables:variables]; | ||
| } | ||
|
|
||
| @end |
Oops, something went wrong.