blob: 5615b442d536bef4f6bc6e5340166e23ded579c1 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
//
// GTMURLBuilder.h
//
// Copyright 2012 Google Inc.
//
// 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.
//
//
// Class for creating URLs. It handles URL encoding of parameters.
//
// Usage example:
//
// GTMURLBuilder *URLBuilder =
// [GTMURLBuilder builderWithString:@"http://www.google.com"];
// [URLBuilder setValue:@"abc" forParameter:@"q"];
// NSURL *URL = [URLBuilder URL];
//
#import <Foundation/Foundation.h>
#import "GTMDefines.h"
@interface GTMURLBuilder : NSObject {
@private
NSMutableDictionary *params_;
}
@property(nonatomic, readonly) NSString *baseURLString;
// |URLString| is expected to be a valid URL with already escaped parameter
// values.
+ (GTMURLBuilder *)builderWithString:(NSString *)URLString;
+ (GTMURLBuilder *)builderWithURL:(NSURL *)URL;
// |URLString| The base URL to which parameters will be appended.
// If the URL already contains parameters, they should already be encoded.
- (id)initWithString:(NSString *)URLString;
- (void)setValue:(NSString *)value forParameter:(NSString *)parameter;
- (void)setIntegerValue:(NSInteger)value forParameter:(NSString *)parameter;
- (NSString *)valueForParameter:(NSString *)parameter;
- (void)removeParameter:(NSString *)parameter;
- (void)setParameters:(NSDictionary *)parameters;
- (NSDictionary *)parameters;
- (NSURL *)URL;
- (NSString *)URLString;
// Case-sensitive comparison of the URL. Also protocol and host are compared
// as case-sensitive strings. The order of URL parameters is ignored.
- (BOOL)isEqual:(GTMURLBuilder *)URLBuilder;
@end
|