1. 程式人生 > >URLEncoder和URLDecoder類(解決url傳遞引數的問題)

URLEncoder和URLDecoder類(解決url傳遞引數的問題)

        網頁中的表單使用POST方法提交時,資料內容的型別是 application/x-www-form-urlencoded,這種型別會:

  1.字元"a"-"z","A"-"Z","0"-"9",".","-","*",和"_" 都不會被編碼;

  2.將空格轉換為加號 (+) ;

  3.將非文字內容轉換成"%xy"的形式,xy是兩位16進位制的數值;

  4.在每個 name=value 對之間放置 & 符號。

  */

  URLEncoder類包含將字串轉換為application/x-www-form-urlencoded MIME 格式的靜態方法。

  web設計者面臨的眾多難題之一便是怎樣處理不同作業系統間的差異性。這些差異效能引起URL方面的問題:例如,一些作業系統允許檔名中含有空格符,有些又不允許。大多數作業系統不會認為檔名中含有符號“#”會有什麼特殊含義;但是在一個URL中,符號“#”表示該檔名已經結束,後面會緊跟一個fragment(部分)識別符號。其他的特殊字元,非字母數字字符集,它們在URL或另一個作業系統上都有其特殊的含義,表述著相似的問題。為了解決這些問題,我們在URL中使用的字元就必須是一個ASCII字符集的固定字集中的元素,具體如下:

  1.大寫字母A-Z

  2.小寫字母a-z

  3.數字 0-9

  4.標點符 - _ . ! ~ * ' (和 ,)

  諸如字元: / & ? @ # ; $ + = 和 %也可以被使用,但是它們各有其特殊的用途,如果一個檔名包括了這些字元( / & ? @ # ; $ + = %),這些字元和所有其他字元就應該被編碼。

  編碼過程非常簡單,任何字元只要不是ASCII碼數字,字母,或者前面提到的標點符,它們都將被轉換成位元組形式,每個位元組都寫成這種形式:一個“%”後面跟著兩位16進位制的數值。空格是一個特殊情況,因為它們太平常了。它除了被編碼成“%20”以外,還能編碼為一個“+”。加號(+)本身被編碼為%2B。當/ # = & 和?作為名字的一部分來使用時,而不是作為URL部分之間的分隔符來使用時,它們都應該被編碼。

  WARNING這種策略在存在大量字符集的異構環境中效果不甚理想。例如:在U.S. Windows 系統中, é 被編碼為 %E9. 在 U.S. Mac中被編碼為%8E。這種不確定性的存在是現存的URI的一個明顯的不足。所以在將來URI的規範當中應該通過國際資源識別符號(IRIs)進行改善。

  類URL並不自動執行編碼或解碼工作。你能生成一個URL物件,它可以包括非法的ASCII和非ASCII字元和/或%xx。當用方法getPath() 和toExternalForm( ) 作為輸出方法時,這種字元和轉移符不會自動編碼或解碼。你應對被用來生成一個URL物件的字串物件負責,確保所有字元都會被恰當地編碼。

  幸運的是,java提供了一個類URLEncoder把string編碼成這種形式。Java1.2增加了一個類URLDecoder它能以這種形式解碼string。這兩個類都不用初始化:

  public class URLDecoder extends Object

  public class URLEncoder extends Object

  一、URLEncoder

  在java1.3和早期版本中,類java.net.URLEncoder包括一個簡單的靜態方法encode( ), 它對string以如下規則進行編碼:

  public static String encode(String s)

  這個方法總是用它所在平臺的預設編碼形式,所以在不同系統上,它就會產生不同的結果。結果java1.4中,這個方法被另一種方法取代了。該方法要求你自己指定編碼形式:

  public static String encode(String s, String encoding) throws UnsupportedEncodingException

  兩種關於編碼的方法,都把任何非字母數字字元轉換成%xx(除了空格,下劃線(_),連字元(?),句號(。),和星號(*))。兩者也都編碼所以的非ASCII字元。空格被轉換成一個加號。這些方法有一點過分累贅了;它們也把“~”,“‘”,“()”轉換成%xx,即使它們完全用不著這樣做。儘管這樣,但是這種轉換並沒被URL規範所禁止。所以web瀏覽器會自然地處理這些被過分編碼後的URL。

  兩中關於編碼的方法都返回一個新的被編碼後的string,java1.3的方法encode( ) 使用了平臺的預設編碼形式,得到%xx。這些編碼形式典型的有:在 U.S. Unix 系統上的ISO-8859-1, 在U.S. Windows 系統上的Cp1252,在U.S. Macs上的MacRoman,和其他本地字符集等。因為編碼解碼過程都是與本地操作平臺相關的,所以這些方法是令人不爽的,不能跨平臺的。

  這就明確地回答了為什麼在java1.4中這種方法被拋棄了,轉而投向了要求以自己指定編碼形式的這種方法。儘管如此,如果你執意要使用所在平臺的預設編碼形式,你的程式將會像在java1.3中的程式一樣,是本地平臺相關的。在另一種編碼的方法中,你應該總是用UTF-8,而不是其他什麼。UTF-8比起你選的其他的編碼形式來說,它能與新的web瀏覽器和更多的其他軟體相相容。

  例子7-8是使用URLEncoder.encode( ) 來列印輸出各種被編碼後的string。它需要在java1.4或更新的版本中編譯和執行。

  Example 7-8. x-www-form-urlencoded strings

  import java.net.URLEncoder;
  import java.net.URLDecoder;
  import java.io.UnsupportedEncodingException;
  publicclass EncoderTest {
  publicstaticvoid main(String[] args) {
  try {
  System.out.println(URLEncoder.encode("This string has spaces","UTF-8"));
  System.out.println(URLEncoder.encode("This*string*has*asterisks","UTF-8"));
  System.out.println(URLEncoder.encode("This%string%has%percent%signs", "UTF-8"));
  System.out.println(URLEncoder.encode("This+string+has+pluses","UTF-8"));
  System.out.println(URLEncoder.encode("This/string/has/slashes","UTF-8"));
  System.out.println(URLEncoder.encode("This"string"has"quote"marks", "UTF-8"));
  System.out.println(URLEncoder.encode("This:string:has:colons","UTF-8"));
  System.out.println(URLEncoder.encode("This~string~has~tildes","UTF-8"));
  System.out.println(URLEncoder.encode("This(string)has(parentheses)", "UTF-8"));
  System.out.println(URLEncoder.encode("This.string.has.periods","UTF-8"));
  System.out.println(URLEncoder.encode("This=string=has=equals=signs", "UTF-8"));
  System.out.println(URLEncoder.encode("This&string&has&ersands","UTF-8"));
  System.out.println(URLEncoder.encode("Thiséstringéhasé non-ASCII characters","UTF-8"));
  // System.out.println(URLEncoder.encode("this中華人民共和國","UTF-8"));
  } catch (UnsupportedEncodingException ex) {thrownew RuntimeException("
Broken VM does not support UTF-8");
  }
  }
  }

        下面就是它的輸出。需要注意的是這些程式碼應該以其他編碼形式被儲存而不是以ASCII碼的形式,還有就是你選擇的編碼形式應該作為一個引數傳給編譯器,讓編譯器能據此對原始碼中的非ASCII字元作出正確的解釋。

  % javac -encoding UTF8 EncoderTest %

  java EncoderTest

  This+string+has+spaces

  This*string*has*asterisks

  This%25string%25has%25percent%25signs

  This%2Bstring%2Bhas%2Bpluses

  This%2Fstring%2Fhas%2Fslashes

  This%22string%22has%22quote%22marks

  This%3Astring%3Ahas%3Acolons

  This%7Estring%7Ehas%7Etildes

  This%28string%29has%28parentheses%29

  This.string.has.periods

  This%3Dstring%3Dhas%3Dequals%3Dsigns

  This%26string%26has%26ampersands

  This%C3%A9string%C3%A9has%C3%A9non-ASCII+characters

  特別需要注意的是這個方法編碼了符號,“\” ,&,=,和:。它不會嘗試著去規定在一個URL中這些字元怎樣被使用。由此,所以你不得不分塊編碼你的URL,而不是把整個URL一次傳給這個方法。這是很重要的,因為對類URLEncoder最通常的用法就是查詢string,為了和伺服器端使用GET方法的程式進行互動。例如,假設你想編碼這個查詢sting,它用來搜尋AltaVista網站:

  pg=q&kl=XX&stype=stext&q=+"Java+I/O"&search.x=38&search.y=3

  這段程式碼對其進行編碼:

  String query = URLEncoder.encode( "pg=q&kl=XX&stype=stext&q=+"Java+I/O"&search.x=38&search.y=3");System.out.println(query);

  不幸的是,得到的輸出是:

  pg%3Dq%26kl%3DXX%26stype%3Dstext%26q%3D%2B%22Java%2BI%2FO%22%26search.x%3D38%26search.y%3D3

  出現這個問題就是方法URLEncoder.encode( ) 在進行盲目地編碼。它不能區分在URL或者查詢string中被用到的特殊字元(象前面string中的“=”,和“&”)和確實需要被編碼的字元。由此,所以URL需要像下面這樣一次只編碼一塊:

  String query = URLEncoder.encode("pg");
  query +="=";
  query += URLEncoder.encode("q");
  query +="&";
  query += URLEncoder.encode("kl");
  query +="=";
  query += URLEncoder.encode("XX");
  query +="&";
  query += URLEncoder.encode("stype");
  query +="=";
  query += URLEncoder.encode("stext");
  query +="&";
  query += URLEncoder.encode("q");
  query +="=";
  query += URLEncoder.encode(""Java I/O"");
  query +="&";
  query += URLEncoder.encode("search.x");
  query +="=";
  query += URLEncoder.encode("38");
  query +="&";
  query += URLEncoder.encode("search.y");
  query +="=";
  query += URLEncoder.encode("3");
  System.out.println(query);

  這才是你真正想得到的輸出:

  pg=q&kl=XX&stype=stext&q=%2B%22Java+I%2FO%22&search.x=38&search.y=3

  例子7-9是一個QueryString類。在一個java物件中,它使用了類URLEncoder來編碼連續的屬性名和屬性值對,這個java物件被用來發送資料到伺服器端的程式。

  當你在建立一個QueryString物件時,你可以把查詢string中的第一個屬性對傳遞給類QueryString的建構函式,得到初始string。如果要繼續加入後面的屬性對,就應呼叫方法add(),它也能接受兩個string作為引數,能對它們進行編碼。方法getQuery( )返回一個屬性對被逐個編碼後得到的整個string。

  Example 7-9. -The QueryString class

  package com.macfaq.net;
  import java.net.URLEncoder;
  import java.io.UnsupportedEncodingException;
  publicclass QueryString {
  private StringBuffer query =new StringBuffer();
  public QueryString(String name, String value) {
  encode(name, value);
  }
  public synchronized void add(String name, String value) {
  query.append('&');
  encode(name, value);
  }
  private synchronized void encode(String name, String value) {
  try {
  query.append(URLEncoder.encode(name, "UTF-8"));
  query.append('=');
  query.append(URLEncoder.encode(value, "UTF-8"));
  } catch (UnsupportedEncodingException ex) {
  thrownew RuntimeException("Broken VM does not support UTF-8");
  }
  }
  public String getQuery() {
  return query.toString();
  }
  public String toString() {
  return getQuery();
  }
  }

利用這個類,現在我們就能對前面那個例子中的string進行編碼了:

  QueryString qs =new QueryString("pg", "q");
  qs.add("kl", "XX");
  qs.add("stype", "stext");
  qs.add("q", "+"Java I/O"");
  qs.add("search.x", "38");
  qs.add("search.y", "3");
  String url ="http://www.altavista.com/cgi-bin/query?"+ qs;
  System.out.println(url);

二、URLDecoder

  與URLEncoder 類相對應的URLDecoder 類有兩種靜態方法。它們解碼以x-www-form-url-encoded這種形式編碼的string。也就是說,它們把所有的加號(+)轉換成空格符,把所有的%xx分別轉換成與之相對應的字元:

publicstatic String decode(String s) throws Exception
  publicstatic String decode(String s, String encoding) // Java 1.4 throws UnsupportedEncodingException

            第一種解碼方法在java1.3和java1.2中使用。第二種解碼方法在java1.4和更新的版本中使用。如果你拿不定主意用哪種編碼方式,那就選擇UTF-8吧。它比其他任何的編碼形式更有可能得到正確的結果。

  如果string包含了一個“%”,但緊跟其後的不是兩位16進位制的數或者被解碼成非法序列,該方法就會丟擲IllegalArgumentException 異常。當下次再出現這種情況時,它可能就不會被丟擲了。這是與執行環境相關的,當檢查到有非法序列時,拋不丟擲IllegalArgumentException 異常,這時到底會發生什麼是不確定的。在Sun's JDK 1.4中,不會丟擲什麼異常,它會把一些莫名其妙的位元組加進不能被順利編碼的string中。這的確令人頭疼,可能就是一個安全漏洞。

  由於這個方法沒有觸及到非轉義字元,所以你可以把整個URL作為引數傳給該方法,不用像之前那樣分塊進行。例如:

  String input ="http://www.altavista.com/cgi-bin/"+"query?pg=q&kl=XX&stype=stext&q=%2B%22Java+I%2FO%22&search.x=38&search.y=3";try {
  String output = URLDecoder.decode(input, "UTF-8");
  System.out.println(output);
  }