引言
首先說明一下窥翩,文章的標(biāo)題本身就是有問題的,千萬不要試著對整個(gè)URL進(jìn)行編碼鳞仙。因?yàn)閟cheme寇蚊、host、path棍好、query有著不同的編碼規(guī)則仗岸,對應(yīng)著不同的合法字符集。對于保留字符是否以非保留字符的形式出現(xiàn)借笙,比如query部分中的“=”扒怖,不同的出現(xiàn)形式也代表著不同的含義,以保留字符形式(=)出現(xiàn)业稼,用于分隔key和value盗痒,以非保留字符形式(%3d)出現(xiàn),含義由生成URL的用戶決定低散。原則是誰生成URL誰來進(jìn)行編碼俯邓。但是實(shí)際應(yīng)用中存在對整個(gè)URL進(jìn)行編碼的使用場景骡楼。
基礎(chǔ)知識
URL中可以出現(xiàn)的字符是ASCII字符集中可視的那些,而在這些可視的字符中看成,有一些是當(dāng)做保留字符使用的君编,用于分隔URL的各個(gè)組成部分,而剩下的這些非保留字符中川慌,有一些字符因?yàn)樵诓煌南到y(tǒng)上有著不同的解碼規(guī)則,不能直接出現(xiàn)祠乃,被稱為不安全字符狰域,具體分類如下:
- 不安全字符(15個(gè)潜慎,包含空格): "<>#%{}|^~[]`
- 保留字符(18個(gè)):: /?#[]@!$&'()*+,;=
-非保留字符(66個(gè)):a-z A-Z 0-9 -_.~
對于URL中出現(xiàn)的這些不安全字符、保留字符被當(dāng)做非保留字符、非ASCII字符钙蒙,都需要對其進(jìn)行編碼。URL編碼也被稱為百分號編碼指蚁,首先對對應(yīng)字符進(jìn)行UTF8編碼厕九,編碼出來一個(gè)字節(jié)流,在分別用百分號加上各個(gè)字節(jié)的十六進(jìn)制表示除师。
應(yīng)用背景
大家應(yīng)該都使用過NSURL沛膳,使用NSURL的時(shí)候需要對傳入的URL字符串進(jìn)行編碼,否則就不能正確初始化NSURL汛聚。而對URL字符串進(jìn)行編碼锹安,大部分同學(xué)使用的應(yīng)該都是如下的方法,或者說曾經(jīng)使用過下面的方法:
NSString *str = @"https://www.baidu.com?keywork=測試";
[str stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
對于上面的例子倚舀,URL字符串確實(shí)能夠進(jìn)行正確地編碼叹哭。但有時(shí)候要處理的URL字符串可能是來自網(wǎng)絡(luò)上的,對于URL是否已經(jīng)編碼我們無法得知痕貌。如果URL已經(jīng)正確編碼過了风罩,而我們再次對其進(jìn)行編碼,也是有問題的舵稠。尤其是對query中出現(xiàn)的保留字符超升,究竟URL生成者的本意是把它當(dāng)作保留字符使用,還是把它當(dāng)作非保留字符使用柱查,我們更是無法得知廓俭。因此我們可以得出這樣一個(gè)結(jié)論:URL的使用者無法對其進(jìn)行正確編碼。也大概是因?yàn)檫@個(gè)原因吧唉工,蘋果把上面的API給廢棄了研乒,并且推出了新的替代API,讓我們分別對URL的各部分分別進(jìn)行編碼淋硝,把具體編碼的細(xì)節(jié)交給了我們:
- (nullable NSString *)stringByAddingPercentEncodingWithAllowedCharacters:(NSCharacterSet *)allowedCharacters;
對整個(gè)URL進(jìn)行編碼
對于初次看到這個(gè)API時(shí)雹熬,我是覺得有些不知所措的宽菜,不知道該如何使用這個(gè)API。很顯然竿报,要想正確地使用這個(gè)API铅乡,背后需要正確的理論支撐。通過第二部分的基礎(chǔ)知識介紹烈菌,我們基本上可以判斷出一個(gè)合法的URL中所包含的字符阵幸,18個(gè)保留字符、66個(gè)非保留字符以及百分號芽世。之所以包含了百分號挚赊,是因?yàn)檎_編碼后的URL是包含百分號的。因此我們假定使用的URL是已經(jīng)正確編碼過的济瓢,作為一種補(bǔ)救措施荠割,即萬一URL中還有非法字符,比如說中文旺矾,我們再對URL進(jìn)行一次編碼檢測蔑鹦,如果URL已經(jīng)正確編碼,該操作沒有任何效果箕宙,否則會(huì)對其中的非法字符進(jìn)行編碼嚎朽。該操作如下所示:
[URL stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet characterSetWithCharactersInString:@":/?#[]@!$&'()*+,;=ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_.~%"]];
通過上面的操作,我們基本上可以對日常出現(xiàn)的大部分URL進(jìn)行正確編碼扒吁,即使URL沒有被編碼火鼻,比如本文第三部分中所舉的那個(gè)例子。
對query中鍵值對中的值進(jìn)行編碼
當(dāng)我們生成一個(gè)URL時(shí)雕崩,我們所需要進(jìn)行編碼的部分魁索,大多數(shù)情況下都是query中“key=value”表達(dá)式的value部分。對于這部分而言盼铁,不能出現(xiàn)的字符是粗蔚,14個(gè)不安全字符(去掉非保留字符中的“~”)以及18個(gè)保留字符,去掉它們重復(fù)的饶火,總共29個(gè)字符鹏控。對應(yīng)的操作如下:
[value stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet characterSetWithCharactersInString:@"?!@#$^&%*+,:;='\"`<>()[]{}/\\| "].invertedSet];
結(jié)束語
只有踩過坑,才會(huì)真正明白URL編碼是一件多么復(fù)雜的事情肤寝,希望本文可以幫助大家当辐。