HttpURLConnection用法詳解

原文鏈接地址：
http://www.blogjava.net/supercrsky/articles/247449.html

針對JDK中的URLConnection連接Servlet的問題,網上有雖然有所涉及,但是隻是說明了某一個或幾個問題，是以FAQ的方式來解決的，而且比較零散，現在對這個類的使用就本人在項目中的使用經驗做如下總結：
1:> URL請求的類別:
分爲二類,GET與POST請求。二者的區別在於：
a:) get請求可以獲取靜態頁面，也可以把參數放在URL字串後面，傳遞給servlet，
b:) post與get的不同之處在於post的參數不是放在URL字串裏面，而是放在http請求的正文內。

2:> URLConnection的對象問題:
URLConnection的對象,如下代碼示例:

// 下面的index.jsp由<servlet-mapping>映射到
// 一個Servlet(com.quantanetwork.getClientDataServlet)
// 該Servlet的注意點下邊會提到

1 URL url = new URL( " http://localhost:8080/TestHttpURLConnectionPro/index.jsp " ); 2 3 URLConnection rulConnection = url.openConnection(); 4 // 此處的urlConnection對象實際上是根據URL的 5 // 請求協議(此處是http)生成的URLConnection類 6 // 的子類HttpURLConnection,故此處最好將其轉化 7 // 爲HttpURLConnection類型的對象,以便用到 8 // HttpURLConnection更多的API.如下: 9 10 HttpURLConnection httpUrlConnection = (HttpURLConnection) rulConnection;

複製代碼

3:> HttpURLConnection對象參數問題

1 // 設置是否向httpUrlConnection輸出，因爲這個是post請求，參數要放在 2 // http正文內，因此需要設爲true, 默認情況下是false; 3 httpUrlConnection.setDoOutput( true ); 4 5 // 設置是否從httpUrlConnection讀入，默認情況下是true; 6 httpUrlConnection.setDoInput( true ); 7 8 // Post 請求不能使用緩存 9 httpUrlConnection.setUseCaches( false ); 10 11 // 設定傳送的內容類型是可序列化的java對象 12 // (如果不設此項,在傳送序列化對象時,當WEB服務默認的不是這種類型時可能拋java.io.EOFException) 13 httpUrlConnection.setRequestProperty( " Content-type " , " application/x-java-serialized-object " ); 14 15 // 設定請求的方法爲"POST"，默認是GET 16 httpUrlConnection.setRequestMethod( " POST " ); 17 18 // 連接，從上述第2條中url.openConnection()至此的配置必須要在connect之前完成， 19 httpUrlConnection.connect();

複製代碼

4:> HttpURLConnection連接問題：

1 // 此處getOutputStream會隱含的進行connect(即：如同調用上面的connect()方法， 2 // 所以在開發中不調用上述的connect()也可以)。 3 OutputStream outStrm = httpUrlConnection.getOutputStream();

複製代碼

5:> HttpURLConnection寫數據與發送數據問題：

1 1 // 現在通過輸出流對象構建對象輸出流對象，以實現輸出可序列化的對象。 2 2 ObjectOutputStream objOutputStrm = new ObjectOutputStream(outStrm); 3 3 4 4 // 向對象輸出流寫出數據，這些數據將存到內存緩衝區中 5 5 objOutputStrm.writeObject( new String( " 我是測試數據 " )); 6 6 7 7 // 刷新對象輸出流，將任何字節都寫入潛在的流中（些處爲ObjectOutputStream） 8 8 objOutputStm.flush(); 9 9 10 10 // 關閉流對象。此時，不能再向對象輸出流寫入任何數據，先前寫入的數據存在於內存緩衝區中, 11 11 // 在調用下邊的getInputStream()函數時才把準備好的http請求正式發送到服務器 12 12 objOutputStm.close(); 13 13 14 14 // 調用HttpURLConnection連接對象的getInputStream()函數, 15 15 // 將內存緩衝區中封裝好的完整的HTTP請求電文發送到服務端。 16 16 InputStream inStrm = httpConn.getInputStream(); // <===注意，實際發送請求的代碼段就在這裏 17 17 18 18 // 上邊的httpConn.getInputStream()方法已調用,本次HTTP請求已結束,下邊向對象輸出流的輸出已無意義， 19 19 // 既使對象輸出流沒有調用close()方法，下邊的操作也不會向對象輸出流寫入任何數據. 20 20 // 因此，要重新發送數據時需要重新創建連接、重新設參數、重新創建流對象、重新寫數據、 21 21 // 重新發送數據(至於是否不用重新這些操作需要再研究) 22 22 objOutputStm.writeObject( new String( "" )); 23 23 httpConn.getInputStream()

複製代碼

總結：a:) HttpURLConnection的connect()函數，實際上只是建立了一個與服務器的tcp連接，並沒有實際發送http請求。

    無論是post還是get，http請求實際上直到HttpURLConnection的getInputStream()這個函數裏面才正式發送出去。
       b:) 在用POST方式發送URL請求時，URL請求參數的設定順序是重中之重，
    對connection對象的一切配置（那一堆set函數）
    都必須要在connect()函數執行之前完成。而對outputStream的寫操作，又必須要在inputStream的讀操作之前。
    這些順序實際上是由http請求的格式決定的。
    如果inputStream讀操作在outputStream的寫操作之前，會拋出例外：
    java.net.ProtocolException: Cannot write output after reading input.......

       c:) http請求實際上由兩部分組成，
    一個是http頭，所有關於此次http請求的配置都在http頭裏面定義，
           一個是正文content。
    connect()函數會根據HttpURLConnection對象的配置值生成http頭部信息，因此在調用connect函數之前，
    就必須把所有的配置準備好。
       d:) 在http頭後面緊跟着的是http請求的正文，正文的內容是通過outputStream流寫入的，
    實際上outputStream不是一個網絡流，充其量是個字符串流，往裏面寫入的東西不會立即發送到網絡，
    而是存在於內存緩衝區中，待outputStream流關閉時，根據輸入的內容生成http正文。
    至此，http請求的東西已經全部準備就緒。在getInputStream()函數調用的時候，就會把準備好的http請求
    正式發送到服務器了，然後返回一個輸入流，用於讀取服務器對於此次http請求的返回信息。由於http
    請求在getInputStream的時候已經發送出去了（包括http頭和正文），因此在getInputStream()函數
    之後對connection對象進行設置（對http頭的信息進行修改）或者寫入outputStream（對正文進行修改）
    都是沒有意義的了，執行這些操作會導致異常的發生。

6:> Servlet端的開發注意點：
a:) 對於客戶端發送的POST類型的HTTP請求，Servlet必須實現doPost方法，而不能用doGet方法。
b:) 用HttpServletRequest的getInputStream()方法取得InputStream的對象，比如：
     InputStream inStream = httpRequest.getInputStream();
     現在調用inStream.available()（該方法用於“返回此輸入流下一個方法調用可以不受阻塞地
     從此輸入流讀取（或跳過）的估計字節數”）時，永遠都反回0。試圖使用此方法的返回值分配緩衝區，
     以保存此流所有數據的做法是不正確的。那麼，現在的解決辦法是
     Servlet這一端用如下實現：
     InputStream inStream = httpRequest.getInputStream();
     ObjectInputStream objInStream = new ObjectInputStream(inStream);
     Object obj = objInStream.readObject();
     // 做後續的處理
     // 。。。。。。
     // 。。。。。。
     而客戶端，無論是否發送實際數據都要寫入一個對象（那怕這個對象不用），如：
     ObjectOutputStream objOutputStrm = new ObjectOutputStream(outStrm);
     objOutputStrm.writeObject(new String("")); // 這裏發送一個空數據
     // 甚至可以發一個null對象，服務端取到後再做判斷處理。
     objOutputStrm.writeObject(null);
     objOutputStrm.flush();
     objOutputStrm.close();

注意:上述在創建對象輸出流ObjectOutputStream時,如果將從HttpServletRequest取得的輸入流
      (即:new ObjectOutputStream(outStrm)中的outStrm)包裝在BufferedOutputStream流裏面,
      則必須有objOutputStrm.flush();這一句,以便將流信息刷入緩衝輸出流.如下:
      ObjectOutputStream objOutputStrm = new ObjectOutputStream(new BufferedOutputStream(outStrm));
      objOutputStrm.writeObject(null);
      objOutputStrm.flush(); // <======此處必須要有.
      objOutputStrm.close();

HttpURLConnection是基於HTTP協議的，其底層通過socket通信實現。如果不設置超時（timeout），在網絡異常的情況下，可能會導致程序僵死而不繼續往下執行。可以通過以下兩個語句來設置相應的超時：
System.setProperty("sun.net.client.defaultConnectTimeout", 超時毫秒數字符串);
System.setProperty("sun.net.client.defaultReadTimeout", 超時毫秒數字符串);

其中： sun.net.client.defaultConnectTimeout：連接主機的超時時間（單位：毫秒）
sun.net.client.defaultReadTimeout：從主機讀取數據的超時時間（單位：毫秒）

例如：
System.setProperty("sun.net.client.defaultConnectTimeout", "30000");
System.setProperty("sun.net.client.defaultReadTime

Java中可以使用HttpURLConnection來請求WEB資源。
HttpURLConnection對象不能直接構造，需要通過URL.openConnection()來獲得HttpURLConnection對象，示例代碼如下：

1 String szUrl = " http://www.ee2ee.com/ " ; 2 URL url = new URL(szUrl); 3 HttpURLConnection urlCon = (HttpURLConnection)url.openConnection();

複製代碼

HttpURLConnection是基於HTTP協議的，其底層通過socket通信實現。如果不設置超時（timeout），在網絡異常的情況下，可能會導致程序僵死而不繼續往下執行。可以通過以下兩個語句來設置相應的超時：
System.setProperty("sun.net.client.defaultConnectTimeout", 超時毫秒數字符串);
System.setProperty("sun.net.client.defaultReadTimeout", 超時毫秒數字符串);

其中： sun.net.client.defaultConnectTimeout：連接主機的超時時間（單位：毫秒）
sun.net.client.defaultReadTimeout：從主機讀取數據的超時時間（單位：毫秒）

例如：
System.setProperty("sun.net.client.defaultConnectTimeout", "30000");
System.setProperty("sun.net.client.defaultReadTimeout", "30000");

JDK 1.5以前的版本，只能通過設置這兩個系統屬性來控制網絡超時。在1.5中，還可以使用HttpURLConnection的父類URLConnection的以下兩個方法：
setConnectTimeout：設置連接主機超時（單位：毫秒）
setReadTimeout：設置從主機讀取數據超時（單位：毫秒）

例如：

1 HttpURLConnection urlCon = (HttpURLConnection)url.openConnection(); 2 urlCon.setConnectTimeout( 30000 ); 3 urlCon.setReadTimeout( 30000 );

複製代碼

需要注意的是，筆者在JDK1.4.2環境下，發現在設置了defaultReadTimeout的情況下，如果發生網絡超時，HttpURLConnection會自動重新提交一次請求，出現一次請求調用，請求服務器兩次的問題（Trouble）。我認爲這是 JDK1.4.2的一個bug。在JDK1.5.0中，此問題已得到解決，不存在自動重發現象。out", "3000