安卓App使用HttpURLConnection发送请求与上传文件

安卓原生App开发时常用的http开发工具

• 系统内置http请求工具为 HttpURLConnection
• httpClient 是 apache 的开源工具
• okHttp 使用更简单，语法相对HttpURLConnection也简洁了许多，需要在graddle添加依赖。

本文主要讲解如何使用HttpURConnection向服务器发送Reqest, 保存Response内容，如何上传文件等内容。

1. 使用 HttpURLConnection 发送http GET请求

step-1: 创建1个URL 对象

URL url = new URL("http://www.yahoo.com");

step-2: 创建1个 HttpURLConnection对象，并绑定URL对象 object,

HttpURLConnection httpConn = (HttpURLConnection)url.openConnection();

step-3: 设置请求方法，以及其它必要选项

httpConn.setConnectTimeout(10000);
httpConn.setRequestMethod("GET");

设置了请求方法后，就开始发送

step-4: 读取 Response
在httpConn对象上打开1个input stream, 用BufferReader的方式从httpConnect中读字节

InputStream inputStream = httpConn.getInputStream();
InputStreamReader inputStreamReader = new InputStreamReader(inputStream);
BufferedReader bufferedReader = new BufferedReader(inputStreamReader);
//保存response内容
StringBuffer readTextBuf = new StringBuffer();
String line = bufferedReader.readLine();
while(line != null) {readTextBuf.append(line);// Continue to read text line.line = bufferedReader.readLine();
}

step-5: 读完response以后，此连接就不需要了，别忘了关闭连接

httpConn.disconnect();

2. 发送 POST请求步骤

与GET请求步骤不同在于，POST 需要在消息体内携带请求参数，因此要在httpConn连接上打开ouput stream，才能发出
将第1节的step-3 改为如下：

httpConn.setRequestMethod("GET");
httpConn.setRequestProperty(“Key”,”Value”);
httpConn.setDoOutput(true);Output the stream to the server
OutputStream outputPost = new BufferedOutputStream(httpConn.getOutputStream());
writeStream(outputPost);
outputPost.flush();
outputPost.close();

至此，POST消息发送完成。 读取Response响应体的方法与上节相同。

下面是1个完整的发送POST 示例

(1)准备1个HashMap(类似于python字典）保存请求参数

HashMap<String, String> params;
//此处添加
params.put("name", "Jack");
params.put("company", "Baidu");

(2)将HashMap转为stringBuild类型

StringBuilder sbParams = new StringBuilder();int i = 0;for (String key : params.keySet()) {try {if (i != 0){sbParams.append("&");}sbParams.append(key).append("=").append(URLEncoder.encode(params.get(key), "UTF-8"));} catch (UnsupportedEncodingException e) {e.printStackTrace();}i++;}

(3) 创建 HttpURLConnection 对象，打开连接，发送POST请求参数

try{String url = "http://www.example.com/test.php";URL urlObj = new URL(url);HttpURLConnection conn = (HttpURLConnection) urlObj.openConnection();conn.setDoOutput(true);conn.setRequestMethod("POST");conn.setRequestProperty("Accept-Charset", "UTF-8");conn.setReadTimeout(10000);conn.setConnectTimeout(15000);conn.connect();String paramsString = sbParams.toString();  //sbParams是前面准备好的DataOutputStream wr = new DataOutputStream(conn.getOutputStream());wr.writeBytes(paramsString);wr.flush();wr.close();
} catch (IOException e) {e.printStackTrace();
}

(4)接收response, 保存body 内容

try {InputStream in = new BufferedInputStream(conn.getInputStream());BufferedReader reader = new BufferedReader(new InputStreamReader(in));StringBuilder result = new StringBuilder();String line;while ((line = reader.readLine()) != null) {result.append(line);}Log.d("test", "result from server: " + result.toString());} catch (IOException e) {e.printStackTrace();
} finally {if (conn != null) {conn.disconnect();}
}

3. 发送Json POST request

与普通的POST请求不同，JSON POST请求参数为json格式, 因此需要修改请求头部参数Content-Type与Accept参数

修改step-3步骤:

httpConn.setRequestMethod("POST");

设置Content-Type头部参数为“application/json”

httpConn.setRequestProperty("Content-Type", "application/json");

设置“Accept”头部参数为“application/json”

httpConn.setRequestProperty("Accept", "application/json");

设置连接准备发送数据

httpConn.setDoOutput(true);

创建1个json body

String jsonInputString = "{"name": "Upendra", "job": "Programmer"}";

将json字符串写入output stream

try(OutputStream os = httpConn.getOutputStream()) {byte[] input = jsonInputString.getBytes("utf-8");os.write(input, 0, input.length); 
}

4. 用POST请求上传文件

上传文件时，POST请求头部参数Content-Type使用 multipart/form-data, 实现也比较容易

URL url = new URL(postTarget);
HttpURLConnection connection = (HttpURLConnection) url.openConnection();String auth = "Bearer " + oauthToken;
connection.setRequestProperty("Authorization", basicAuth);String boundary = UUID.randomUUID().toString();
connection.setRequestMethod("POST");
connection.setDoOutput(true);
connection.setRequestProperty("Content-Type", "multipart/form-data;boundary=" + boundary);DataOutputStream request = new DataOutputStream(uc.getOutputStream());request.writeBytes("--" + boundary + "\r\n");
request.writeBytes("Content-Disposition: form-data; name=\"description\"\r\n\r\n");
request.writeBytes(fileDescription + "\r\n");request.writeBytes("--" + boundary + "\r\n");
request.writeBytes("Content-Disposition: form-data; name=\"file\"; filename=\"" + file.fileName + "\"\r\n\r\n");
request.write(FileUtils.readFileToByteArray(file));
request.writeBytes("\r\n");request.writeBytes("--" + boundary + "--\r\n");
request.flush();
int respCode = connection.getResponseCode();switch(respCode) {case 200://all went ok - read response...break;case 301:case 302:case 307://handle redirect - for example, re-post to the new location...break;...default://do something sensible
}

总结

使用 HttpURLConnection 发送请求流程还是比较清晰，GET, POST,主要的区别在Step-3 步骤，发送 JSON类型参数，上传 file 还需要修改头部参数。
在Android App开发时，可以在Activity用按钮事件来触发请求，也可以使用service 在后台发送请求。 本文就不列出那些示例代码了。