在 Objective-C 裡做網路編程時,經常需要把參數轉成 URL encoding。最麻煩的是那些「保留字元」——例如加號 + 編碼後必須變成 %2B,空白要變成 %20,還有中文等非 ASCII 字元也都要一併處理。
與其每次手寫字串替換,不如用 Category 替 NSString 擴充一對方法,之後任何字串都能直接呼叫。
// NSString+URLEncoding.h #import <Foundation/Foundation.h> @interface NSString (URLEncodingAdditions) - (NSString *)URLEncodedString; - (NSString *)URLDecodedString; @end
// NSString+URLEncoding.m
#import "NSString+URLEncoding.h"
@implementation NSString (OAURLEncodingAdditions)
- (NSString *)URLEncodedString
{
NSString *result = (NSString *)
CFURLCreateStringByAddingPercentEscapes(kCFAllocatorDefault,
(CFStringRef)self,
NULL,
CFSTR("!*'();:@&=+$,/?%#[] "),
kCFStringEncodingUTF8);
[result autorelease];
return result;
}
- (NSString *)URLDecodedString
{
NSString *result = (NSString *)
CFURLCreateStringByReplacingPercentEscapesUsingEncoding(
kCFAllocatorDefault,
(CFStringRef)self,
CFSTR(""),
kCFStringEncodingUTF8);
[result autorelease];
return result;
}
@end
CFURLCreateStringByAddingPercentEscapes 的第三個參數(legalURLCharactersToBeEscaped)指定的是「即使合法也強制要編碼」的字元。上面寫的 CFSTR("!*'();:@&=+$,/?%#[] ") 涵蓋了 URL 語法中帶有結構意義的符號。這一段的用意是在組裝 query string 時避免這些字元被伺服器誤解為分隔符——尤其是 & 與 =,若參數值裡出現它們,整個查詢字串就會被切錯。
第四個參數指定 UTF-8 編碼,中文才不會變成亂碼。
因為是擴充 NSString,用起來非常直覺。先在使用它的檔案引入頭檔,然後直接呼叫即可:
#import "NSString+URLEncoding.h" NSString *urlToken = [token URLEncodedString]; NSString *plain = [urlToken URLDecodedString];
最後提醒一個記憶體細節:這兩個方法回傳的是 Core Foundation 建立的物件,因此我在裡面加了 autorelease,在 MRC 專案下才不會洩漏。若你的專案已改用 ARC,則需移除這行,並改用 CFBridgingRelease 或直接把結果轉給 ARC 管理。
摘自 zcl369369的專欄