Java中使用HttpUrlConnection調用api

 

java中可以使用3種方式調用api

• HttpURLConnection
• HttpClient
• RestTemplate

這里要講的是HttpURLConnection的方式。

一.HttpURLConnection的介紹

HttpURLConnection標准Java接口(java.NET) —-HttpURLConnection，可以實現簡單的基於URL請求、響應功能；

HttpURLconnection是基於http協議的，支持get，post，put，delete等各種請求方式，最常用的就是get和post，下面針對這兩種請求方式進行講解。

二.get請求的使用方法

HttpURLconnection是同步的請求，所以必須放在子線程中。使用示例如下：

new Thread(new Runnable() {
    @Override
    public void run() {
        try {
            String url = "https://www.baidu.com/";
            URL url = new URL(url);
            //得到connection對象。
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            //設置請求方式
            connection.setRequestMethod("GET");
            //連接
            connection.connect();
            //得到響應碼
            int responseCode = connection.getResponseCode();
            if(responseCode == HttpURLConnection.HTTP_OK){
                //得到響應流
                InputStream inputStream = connection.getInputStream();
                //將響應流轉換成字符串
                String result = is2String(inputStream);//將流轉換為字符串。
                Log.d("kwwl","result============="+result);
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}).start();

get請求的使用方法如上。如果需要傳遞參數，則直接把參數拼接到url后面，其他完全相同，如下：

String url = "https://www.baidu.com/?userName=zhangsan&password=123456";

注意點：
1，url與參數之間用？隔開。
2，鍵值對中鍵與值用=連接。
3，兩個鍵值對之間用&連接

分析：
1， 使用connection.setRequestMethod(“GET”);設置請求方式。
2， 使用connection.connect();連接網絡。請求行，請求頭的設置必須放在網絡連接前。
3， connection.getInputStream()只是得到一個流對象，並不是數據，不過我們可以從流中讀出數據，從流中讀取數據的操作必須放在子線程。
4， connection.getInputStream()得到一個流對象，從這個流對象中只能讀取一次數據，第二次讀取時將會得到空數據。

三.post請求的使用方法

1.post的基本用法如下：

使用示例如下：

new Thread(new Runnable() {
    @Override
    public void run() {
        try {
            URL url = new URL(getUrl);
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            connection.setRequestMethod("POST");//設置請求方式為POST
            connection.setDoOutput(true);//允許寫出
            connection.setDoInput(true);//允許讀入
            connection.setUseCaches(false);//不使用緩存
            connection.connect();//連接
            int responseCode = connection.getResponseCode();
            if(responseCode == HttpURLConnection.HTTP_OK){
                InputStream inputStream = connection.getInputStream();
                String result = is2String(inputStream);//將流轉換為字符串。
                Log.d("kwwl","result============="+result);
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}).start();

注：post請求與get請求有很多相似，只是在連接之前多了一些設置，兩者可以對比學習使用。

2.使用post請求傳遞鍵值對參數

使用示例如下：

new Thread(new Runnable() {
    @Override
    public void run() {
        try {
            URL url = new URL(getUrl);
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            connection.setRequestMethod("POST"); 
            connection.setDoOutput(true);
            connection.setDoInput(true);
            connection.setUseCaches(false);
            connection.connect();

            String body = "userName=zhangsan&password=123456"; BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(connection.getOutputStream(), "UTF-8"));
            writer.write(body);
            writer.close(); int responseCode = connection.getResponseCode();
            if(responseCode == HttpURLConnection.HTTP_OK){
                InputStream inputStream = connection.getInputStream();
                String result = is2String(inputStream);//將流轉換為字符串。
                Log.d("kwwl","result============="+result);
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}).start();

分析：
1，post方式傳遞參數的本質是：從連接中得到一個輸出流，通過輸出流把數據寫到服務器。
2，數據的拼接采用鍵值對格式，鍵與值之間用=連接。每個鍵值對之間用&連接

3.使用post請求傳遞json格式參數

post請求也可以傳遞json格式的參數，使用示例如下：

new Thread(new Runnable() {
    @Override
    public void run() {
        try {
            URL url = new URL(getUrl);
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            connection.setRequestMethod("POST"); 
            connection.setDoOutput(true);
            connection.setDoInput(true);
            connection.setUseCaches(false);
            connection.setRequestProperty("Content-Type", "application/json;charset=utf-8");//設置參數類型是json格式
            connection.connect();

            String body = "{userName:zhangsan,password:123456}"; BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(connection.getOutputStream(), "UTF-8")); writer.write(body); writer.close(); int responseCode = connection.getResponseCode();
            if(responseCode == HttpURLConnection.HTTP_OK){
                InputStream inputStream = connection.getInputStream();
                String result = is2String(inputStream);//將流轉換為字符串。
                Log.d("kwwl","result============="+result);
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}).start();

傳遞json格式的參數與傳遞鍵值對參數不同點有兩個：
1，傳遞json格式數據時需要在請求頭中設置參數類型是json格式。
2，body是json格式的字符串。

四.設置請求頭

Get請求與post請求都可以設置請求頭，設置請求頭的方式也是相同的。為了節約篇幅，重復的代碼不再列出，核心代碼如下：

connection.setRequestMethod("POST");
connection.setRequestProperty("version", "1.2.3");//設置請求頭
connection.setRequestProperty("token", token);//設置請求頭
connection.connect();

注意：
1，請求頭必須在connection.connect();代碼前設置。
2，可以設置多個請求頭參數。

五，上傳文件

在post請求傳遞參數時知道，可以從連接中得到一個輸出流，輸出流可以像服務器寫數據。

同理，可以使用這個輸出流將文件寫到服務器。代碼如下：

try {
    URL url = new URL(getUrl);
    HttpURLConnection connection = (HttpURLConnection) url.openConnection();
    connection.setRequestMethod("POST");
    connection.setDoOutput(true);
    connection.setDoInput(true);
    connection.setUseCaches(false);
    connection.setRequestProperty("Content-Type", "file/*");//設置數據類型
    connection.connect();

    OutputStream outputStream = connection.getOutputStream(); FileInputStream fileInputStream = new FileInputStream("file");//把文件封裝成一個流
    int length = -1;
    byte[] bytes = new byte[1024];
    while ((length = fileInputStream.read(bytes)) != -1){ outputStream.write(bytes,0,length);//寫的具體操作
 }
    fileInputStream.close(); outputStream.close(); int responseCode = connection.getResponseCode();
    if(responseCode == HttpURLConnection.HTTP_OK){
        InputStream inputStream = connection.getInputStream();
        String result = is2String(inputStream);//將流轉換為字符串。
        Log.d("kwwl","result============="+result);
    }

} catch (Exception e) {
    e.printStackTrace();
}

注：
1，上傳文件使用的是post請求方式。
2，使用的原理類似於post請求中上傳參數。

六.同時上傳參數和文件

在實際應用時，上傳文件的同時也常常需要上傳鍵值對參數。

比如在微信中發朋友圈時，不僅有圖片，還有有文字。此時就需要同時上傳參數和文件。

在httpURLconnection中並沒有提供直接上傳參數和文件的API，需要我們自己去探索。我們知道在Web頁面上傳參數和文件很簡單，只需要在form標簽寫上contentype=”multipart/form-data”即可，剩余工作便都交給瀏覽器去完成數據收集並發送Http請求。但是如果沒有頁面的話要怎么上傳文件呢？

由於脫離了瀏覽器的環境，我們就要自己去完成數據的封裝並發送。

首先我們來看web頁面上傳參數和文件是什么樣子的？

我們寫一個web表單，上傳兩個鍵值對參數和一個文件。使用抓包工具抓取的數據結果如下：

經過分析可知，上傳到服務器的數據除了鍵值對數據和文件數據外，還有其他字符串，使用這些這些字符串來拼接一定的格式。

那么我們只要模擬這個數據，並寫入到Http請求中便能實現同時傳遞參數和文件。

代碼如下：

try {

    String BOUNDARY = java.util.UUID.randomUUID().toString();
    String TWO_HYPHENS = "--";
    String LINE_END = "\r\n";

    URL url = new URL(URLContant.CHAT_ROOM_SUBJECT_IMAGE);
    HttpURLConnection connection = (HttpURLConnection) url.openConnection();
    connection.setRequestMethod("POST");
    connection.setDoOutput(true);
    connection.setDoInput(true);
    connection.setUseCaches(false);

    //設置請求頭
    connection.setRequestProperty("Connection", "Keep-Alive");
    connection.setRequestProperty("Charset", "UTF-8");
    connection.setRequestProperty("Content-Type","multipart/form-data; BOUNDARY=" + BOUNDARY);
    connection.setRequestProperty("Authorization","Bearer "+UserInfoConfigure.authToken);
    connection.connect();

    DataOutputStream outputStream = new DataOutputStream(connection.getOutputStream());
    StringBuffer strBufparam = new StringBuffer();
    //封裝鍵值對數據一
    strBufparam.append(TWO_HYPHENS);
    strBufparam.append(BOUNDARY);
    strBufparam.append(LINE_END);
    strBufparam.append("Content-Disposition: form-data; name=\"" + "groupId" + "\"");
    strBufparam.append(LINE_END);
    strBufparam.append("Content-Type: " + "text/plain" );
    strBufparam.append(LINE_END);
    strBufparam.append("Content-Lenght: "+(""+groupId).length());
    strBufparam.append(LINE_END);
    strBufparam.append(LINE_END);
    strBufparam.append(""+groupId);
    strBufparam.append(LINE_END);

    //封裝鍵值對數據二
    strBufparam.append(TWO_HYPHENS);
    strBufparam.append(BOUNDARY);
    strBufparam.append(LINE_END);
    strBufparam.append("Content-Disposition: form-data; name=\"" + "title" + "\"");
    strBufparam.append(LINE_END);
    strBufparam.append("Content-Type: " + "text/plain" );
    strBufparam.append(LINE_END);
    strBufparam.append("Content-Lenght: "+"kwwl".length());
    strBufparam.append(LINE_END);
    strBufparam.append(LINE_END);
    strBufparam.append("kwwl");
    strBufparam.append(LINE_END);

    //拼接完成后，一塊寫入
    outputStream.write(strBufparam.toString().getBytes());


    //拼接文件的參數
    StringBuffer strBufFile = new StringBuffer();
    strBufFile.append(LINE_END);
    strBufFile.append(TWO_HYPHENS);
    strBufFile.append(BOUNDARY);
    strBufFile.append(LINE_END);
    strBufFile.append("Content-Disposition: form-data; name=\"" + "image" + "\"; filename=\"" + file.getName() + "\"");
    strBufFile.append(LINE_END);
    strBufFile.append("Content-Type: " + "image/*" );
    strBufFile.append(LINE_END);
    strBufFile.append("Content-Lenght: "+file.length());
    strBufFile.append(LINE_END);
    strBufFile.append(LINE_END);

    outputStream.write(strBufFile.toString().getBytes());

    //寫入文件
    FileInputStream fileInputStream = new FileInputStream(file);
    byte[] buffer = new byte[1024*2];
    int length = -1;
    while ((length = fileInputStream.read(buffer)) != -1){
        outputStream.write(buffer,0,length);
    }
    outputStream.flush();
    fileInputStream.close();

    //寫入標記結束位
    byte[] endData = (LINE_END + TWO_HYPHENS + BOUNDARY + TWO_HYPHENS + LINE_END).getBytes();//寫結束標記位
    outputStream.write(endData);
    outputStream.flush();

    //得到響應
    int responseCode = connection.getResponseCode();
    if(responseCode == HttpURLConnection.HTTP_OK){
        InputStream inputStream = connection.getInputStream();
        String result = is2String(inputStream);//將流轉換為字符串。
        Log.d("kwwl","result============="+result);
    }

} catch (Exception e) {
    e.printStackTrace();
}

注：http最早出現時就是為了瀏覽器與服務器之間的數據傳輸，所以有固定的協議，協議規范了一定的數據格式，所以在瀏覽器中傳遞數據時會自動按照一定的格式封裝。在android中不能自動封裝，所以這些操作需要手動操作。

七.下載文件

從服務器下載文件是比較簡單的操作，只要得到輸入流，就可以從流中讀出數據。

使用示例如下：

try {
     String urlPath = "https://www.baidu.com/";
      URL url = new URL(urlPath);
      HttpURLConnection connection = (HttpURLConnection) url.openConnection();
      connection.setRequestMethod("GET");
      connection.connect();
      int responseCode = connection.getResponseCode();
      if(responseCode == HttpURLConnection.HTTP_OK){
          InputStream inputStream = connection.getInputStream();
          File dir = new File("fileDir"); if (!dir.exists()){
              dir.mkdirs();
          }
          File file = new File(dir, "fileName");//根據目錄和文件名得到file對象
          FileOutputStream fos = new FileOutputStream(file); byte[] buf = new byte[1024*8];
          int len = -1;
          while ((len = inputStream.read(buf)) != -1){ fos.write(buf, 0, len); }
          fos.flush();
      }

  } catch (Exception e) {
      e.printStackTrace();
  }

 

參考網址：

https://blog.csdn.net/fightingXia/article/details/71775516

https://github.com/guozhengXia/UrlHttpUtils/blob/6c4f060150efddbe1d7b28d271e39103ab9f76a2/urlhttputils/src/main/java/com/guozheng/urlhttputils/urlhttp/RequestUtil.java#L50