// // NSString+RestKit.m // RestKit // // Created by Blake Watters on 6/15/11. // Copyright 2011 RestKit // // 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. // #if TARGET_OS_IPHONE #import #else #import #endif #import "NSString+RestKit.h" #import "RKClient.h" #import "RKFixCategoryBug.h" #import "RKPathMatcher.h" #include #include RK_FIX_CATEGORY_BUG(NSString_RestKit) @implementation NSString (RestKit) - (NSString *)stringByAppendingQueryParameters:(NSDictionary *)queryParameters { if ([queryParameters count] > 0) { return [NSString stringWithFormat:@"%@?%@", self, [queryParameters stringWithURLEncodedEntries]]; } return [NSString stringWithString:self]; } // Deprecated - (NSString *)appendQueryParams:(NSDictionary *)queryParams { return [self stringByAppendingQueryParameters:queryParams]; } - (NSString *)interpolateWithObject:(id)object addingEscapes:(BOOL)addEscapes { NSCAssert(object != NULL, @"Object provided is invalid; cannot create a path from a NULL object"); RKPathMatcher *matcher = [RKPathMatcher matcherWithPattern:self]; NSString *interpolatedPath = [matcher pathFromObject:object addingEscapes:addEscapes]; return interpolatedPath; } - (NSString *)interpolateWithObject:(id)object { return [self interpolateWithObject:object addingEscapes:YES]; } - (NSDictionary *)queryParameters { return [self queryParametersUsingEncoding:NSUTF8StringEncoding]; } - (NSDictionary*)queryParametersUsingEncoding:(NSStringEncoding)encoding { return [self queryParametersUsingArrays:NO encoding:encoding]; } // TODO: Eliminate... - (NSDictionary*)queryParametersUsingArrays:(BOOL)shouldUseArrays encoding:(NSStringEncoding)encoding { NSString *stringToParse = self; NSRange chopRange = [stringToParse rangeOfString:@"?"]; if (chopRange.length > 0) { chopRange.location+=1; // we want inclusive chopping up *through* "?" if (chopRange.location < [stringToParse length]) stringToParse = [stringToParse substringFromIndex:chopRange.location]; } NSCharacterSet* delimiterSet = [NSCharacterSet characterSetWithCharactersInString:@"&;"]; NSMutableDictionary* pairs = [NSMutableDictionary dictionary]; NSScanner* scanner = [[[NSScanner alloc] initWithString:stringToParse] autorelease]; while (![scanner isAtEnd]) { NSString* pairString = nil; [scanner scanUpToCharactersFromSet:delimiterSet intoString:&pairString]; [scanner scanCharactersFromSet:delimiterSet intoString:NULL]; NSArray* kvPair = [pairString componentsSeparatedByString:@"="]; if (!shouldUseArrays) { if (kvPair.count == 2) { NSString* key = [[kvPair objectAtIndex:0] stringByReplacingPercentEscapesUsingEncoding:encoding]; NSString* value = [[kvPair objectAtIndex:1] stringByReplacingPercentEscapesUsingEncoding:encoding]; [pairs setObject:value forKey:key]; } } else { if (kvPair.count == 1 || kvPair.count == 2) { NSString* key = [[kvPair objectAtIndex:0] stringByReplacingPercentEscapesUsingEncoding:encoding]; NSMutableArray* values = [pairs objectForKey:key]; if (nil == values) { values = [NSMutableArray array]; [pairs setObject:values forKey:key]; } if (kvPair.count == 1) { [values addObject:[NSNull null]]; } else if (kvPair.count == 2) { NSString* value = [[kvPair objectAtIndex:1] stringByReplacingPercentEscapesUsingEncoding:encoding]; [values addObject:value]; } } } } return [NSDictionary dictionaryWithDictionary:pairs]; } // NOTE: See http://en.wikipedia.org/wiki/Percent-encoding#Percent-encoding_reserved_characters - (NSString *)stringByAddingURLEncoding { CFStringRef legalURLCharactersToBeEscaped = CFSTR(":/?#[]@!$ &'()*+,;=\"<>%{}|\\^~`\n\r"); CFStringRef encodedString = CFURLCreateStringByAddingPercentEscapes(kCFAllocatorDefault, (CFStringRef)self, NULL, legalURLCharactersToBeEscaped, kCFStringEncodingUTF8); if (encodedString) { return [(NSString *)encodedString autorelease]; } // TODO: Log a warning? return @""; } - (NSString *)stringByReplacingURLEncoding { return [self stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding]; } - (NSString *)MIMETypeForPathExtension { CFStringRef uti = UTTypeCreatePreferredIdentifierForTag(kUTTagClassFilenameExtension, (CFStringRef)[self pathExtension], NULL); if (uti != NULL) { CFStringRef mime = UTTypeCopyPreferredTagWithClass(uti, kUTTagClassMIMEType); CFRelease(uti); if (mime != NULL) { NSString *type = [NSString stringWithString:(NSString *)mime]; CFRelease(mime); return type; } } return nil; } - (BOOL)isIPAddress { struct sockaddr_in sa; char *hostNameOrIPAddressCString = (char *) [self UTF8String]; int result = inet_pton(AF_INET, hostNameOrIPAddressCString, &(sa.sin_addr)); return (result != 0); } - (NSString *)stringByAppendingPathComponent:(NSString *)pathComponent isDirectory:(BOOL)isDirectory { NSString *stringWithPathComponent = [self stringByAppendingPathComponent:pathComponent]; if (isDirectory) return [stringWithPathComponent stringByAppendingString:@"/"]; return stringWithPathComponent; } @end