summaryrefslogtreecommitdiff
path: root/Juick/Helpers/NSURL+PathParameters.m
diff options
context:
space:
mode:
Diffstat (limited to 'Juick/Helpers/NSURL+PathParameters.m')
-rw-r--r--Juick/Helpers/NSURL+PathParameters.m173
1 files changed, 173 insertions, 0 deletions
diff --git a/Juick/Helpers/NSURL+PathParameters.m b/Juick/Helpers/NSURL+PathParameters.m
new file mode 100644
index 0000000..83a55bb
--- /dev/null
+++ b/Juick/Helpers/NSURL+PathParameters.m
@@ -0,0 +1,173 @@
+//
+// NSURL+PathParameters.m
+//
+// Created by Johan Kool on 27/9/2011.
+// Copyright 2011 Koolistov Pte. Ltd. All rights reserved.
+//
+// Redistribution and use in source and binary forms, with or without modification, are
+// permitted provided that the following conditions are met:
+//
+// * Redistributions of source code must retain the above copyright notice, this list of
+// conditions and the following disclaimer.
+// * Neither the name of KOOLISTOV PTE. LTD. nor the names of its contributors may be used to
+// endorse or promote products derived from this software without specific prior written
+// permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
+// EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
+// THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+// OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+// HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+// OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+// SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+//
+
+#import "NSURL+PathParameters.h"
+
+@interface NSString (URLParameters)
+
+- (NSString *)stringByEscapingForURLArgument;
+
+@end
+
+@implementation NSString (URLParameters)
+
+- (NSString *)stringByEscapingForURLArgument {
+ // Encode all the reserved characters, per RFC 3986 (<http://www.ietf.org/rfc/rfc3986.txt>)
+ NSString *escapedString = (__bridge NSString *)CFURLCreateStringByAddingPercentEscapes(kCFAllocatorDefault,
+ (CFStringRef)self,
+ NULL,
+ (CFStringRef)@"!*'\"();:@&=+$,/?%#[] ",
+ kCFStringEncodingUTF8);
+ return [escapedString copy];
+}
+
+@end
+
+@implementation NSURL (PathParameters)
+
+- (NSURL *)URLByReplacingPathWithPath:(NSString *)path {
+ // scheme://username:password@domain:port/path?query_string#fragment_id
+
+ // Chop off path, query and fragment from absoluteString, then add new path and put back query and fragment
+
+ NSString *absoluteString = [self absoluteString];
+ NSUInteger endIndex = [absoluteString length];
+
+ NSString *fragment = [self fragment];
+ if (fragment) {
+ endIndex -= [fragment length];
+ endIndex--; // The # character
+ }
+
+ NSString *query = [self query];
+ if (query) {
+ endIndex -= [query length];
+ endIndex--; // The ? character
+ }
+
+ // Check if the last character of the path is a slash (range must be valid as endIndex must be smaller or equal to length)
+ BOOL trailingSlashOnPath = [[absoluteString substringWithRange:NSMakeRange(endIndex - 1, 1)] isEqualToString:@"/"];
+
+ NSString *originalPath = [self path]; // This method strips any trailing slash "/"
+ if (originalPath) {
+ endIndex -= [originalPath length];
+ if (trailingSlashOnPath && [originalPath length] > 1) { // Don't get confused with the starting slash
+ endIndex--;
+ }
+ }
+
+ absoluteString = [absoluteString substringToIndex:endIndex];
+ absoluteString = [absoluteString stringByAppendingString:path];
+ if (query) {
+ absoluteString = [absoluteString stringByAppendingString:@"?"];
+ absoluteString = [absoluteString stringByAppendingString:query];
+ }
+ if (fragment) {
+ absoluteString = [absoluteString stringByAppendingString:@"#"];
+ absoluteString = [absoluteString stringByAppendingString:fragment];
+ }
+
+ return [NSURL URLWithString:absoluteString];
+}
+
+- (NSURL *)URLByAppendingPathWithRelativePath:(NSString *)path {
+ NSString *originalPath = [self path];
+ NSString *combinedPath = [[originalPath stringByAppendingPathComponent:path] stringByStandardizingPath];
+ // Don't standardize away a trailing slash
+ if ([path length] > 1 && [path hasSuffix:@"/"]) {
+ combinedPath = [combinedPath stringByAppendingString:@"/"];
+ }
+ return [self URLByReplacingPathWithPath:combinedPath];
+}
+
+- (NSURL *)URLByAppendingParameters:(NSDictionary *)parameters {
+ NSMutableString *query = [[self query] mutableCopy];
+
+ if (!query) {
+ query = [NSMutableString stringWithString:@""];
+ }
+
+ // Sort parameters to be appended so that our solution is stable (and testable)
+ NSArray *parameterNames = [parameters allKeys];
+ parameterNames = [parameterNames sortedArrayUsingSelector:@selector(compare:)];
+
+ for (NSString *parameterName in parameterNames) {
+ id value = [parameters objectForKey:parameterName];
+ NSAssert3([parameterName isKindOfClass:[NSString class]], @"Got '%@' of type %@ as key for parameter with value '%@'. Expected an NSString.", parameterName, NSStringFromClass([parameterName class]), value);
+
+ // The value needs to be an NSString, or be able to give us an NSString
+ if (![value isKindOfClass:[NSString class]]) {
+ if ([value respondsToSelector:@selector(stringValue)]) {
+ value = [value stringValue];
+ } else {
+ // Fallback to simply giving the description
+ value = [value description];
+ }
+ }
+
+ if ([query length] == 0) {
+ [query appendFormat:@"%@=%@", [parameterName stringByEscapingForURLArgument], [value stringByEscapingForURLArgument]];
+ } else {
+ [query appendFormat:@"&%@=%@", [parameterName stringByEscapingForURLArgument], [value stringByEscapingForURLArgument]];
+ }
+ }
+
+ // scheme://username:password@domain:port/path?query_string#fragment_id
+
+ // Chop off query and fragment from absoluteString, then add new query and put back fragment
+
+ NSString *absoluteString = [self absoluteString];
+ NSUInteger endIndex = [absoluteString length];
+
+ NSString *fragment = [self fragment];
+ if (fragment) {
+ endIndex -= [fragment length];
+ endIndex--; // The # character
+ }
+
+ NSString *originalQuery = [self query];
+ if (originalQuery) {
+ endIndex -= [originalQuery length];
+ endIndex--; // The ? character
+ }
+
+ absoluteString = [absoluteString substringToIndex:endIndex];
+ absoluteString = [absoluteString stringByAppendingString:@"?"];
+ absoluteString = [absoluteString stringByAppendingString:query];
+ if (fragment) {
+ absoluteString = [absoluteString stringByAppendingString:@"#"];
+ absoluteString = [absoluteString stringByAppendingString:fragment];
+ }
+
+ return [NSURL URLWithString:absoluteString];
+}
+
+- (NSURL *)URLByAppendingParameterName:(NSString *)parameter value:(id)value {
+ return [self URLByAppendingParameters:[NSDictionary dictionaryWithObjectsAndKeys:value, parameter, nil]];
+}
+
+
+@end